dummynet.4

.\"
.\"     %Id: dummynet.4,v 1.2 1998/12/21 22:37:53 luigi Exp %
.\"
.\" $FreeBSD$
.Dd Sep 28, 1998
.Dt DUMMYNET 4
.Os
.Sh ̾��
.Nm dummynet
.Nd �ե쥭���֥���Ӱ�ޥ͡����㤪����ٱ䥨�ߥ�졼��
.Sh ��
.Fd #include <sys/types.h>
.Fd #include <sys/queue.h>
.Fd #include <netinet/in.h>
.Fd #include <netinet/ip_fw.h>
.Ft int
.Fn setsockopt raw_socket IPPROTO_IP "ipfw option" "struct ipfw" size
.Sh ����
dummynet �ϡ��Ӱ����ȥ��塼�Υ����������¤�ä����ꡢ�ѥ��åȤ��ٱ��
»���򥷥ߥ�졼�Ȥ��뤳�Ȥˤ�ꡢ�͡��ʥͥåȥ�����󥿥ե�������
�𤷤Ƥ��Ȥꤵ���ȥ�ե��å��������ǽ�ˤ��ޤ���
.Pp
���ߤμ����Ǥϡ��ѥ��åȤ����̤�
.Nm ipfw
�ץ�������
.Nm ``�ѥ���''
�롼��ˤ��Ԥ��ޤ���
dummynet ��
.Nm �ѥ���
�ˤ����Ƥϡ��Ӱ������ٱ䡢���塼��������»��Ψ������Ǥ��ޤ���
�����������
.Nm ipfw
�ץ������ǹԤ��ޤ���
�ѥ��פˤ� 1 ���� 65534 �ޤǤ��ֹ椬�Ĥ����ޤ����ޤ����ѥ��åȤ�
ipfw ������ˤ�äƤ�ʣ���Υѥ��פ�𤷤����Ф��������ǽ�Ǥ���
.Pp
dummynet �� IP ��٥��ư��ޤ������֥�å���ĥ��ǽ��ͭ���ˤ��뤳�Ȥ�
��ꡢ�֥�å������ѥ��åȤ�ѥ��פ�𤷤����ФǤ��ޤ���
.Sh ����ˡ
�����Υ��ޥ�ɤˤ�ꡢ�ѥ��פ˥ѥ��åȤ����Ф��ޤ���
.Bd -literal
    ipfw add pipe NNN ....
.Ed

�ޤ����ѥ��פ�����ϲ����Υ��ޥ�ɤˤ��Ԥ��ޤ���
.Bd -literal
    ipfw pipe NNN config bw B delay D queue Q plr P
.Ed

���������Ӱ��� B �ϡ�bit/s, Kbit/s, Mbit/s, Bytes/s, KBytes/s, MBytes/s
��ɽ�����Ȥ��Ǥ��ޤ���
delay �ϥߥ���ñ�̤ǡ��ޤ������塼�������ϥѥ��åȿ����Х��ȿ�
�ˤ����ꤷ�ޤ���
�ޤ���plr �ϥѥ��åȤ�������˼�������Ǥ���
.Pp
ipfw ��������ư����뤳�Ȥϴ�ñ�ǤϤ���ޤ��󡣥����ƥब
�롼����֥�å��Ȥ��Ƶ�ǽ���Ƥ�����Ϥʤ�����Ǥ���
.Pp
�롼���Ȥ��Ƶ�ǽ������ϡ��롼�ƥ��󥰤����ѥ��åȤ����Ϸ�ϩ������ӡ�
���Ϸ�ϩ��Ʊ���롼�륻�åȤ�Ŭ�Ѥ���ޤ��Τǡ��ѥ��åȤ�Ʊ���ѥ��פ�
�����̤�ʤ��褦�����դ��Ƥ������� (�����ˤ��������������̤Ǥ�)��
.Pp
�֥�å��Ȥ��Ƶ�ǽ������ϡ��֥�å������ѥ��åȤ��Ф��ơ�
.Nm ipfw
�ե��륿�ϡ����Ϸ�ϩ�ǰ��٤�����ư����ޤ���
.Pp
Ʊ�ͤˡ���������ť���ͥ�򥷥ߥ�졼�Ȥ�����ˤϡ������ΰ㤦
2 �ĤΥѥ��פ��Ѥ���褦�ˤ��Ƥ���������
�㤨�С����оݤ��������Υ�󥯤򥷥ߥ�졼�Ȥ�����Υ롼�륻�åȤ�
���Τ褦�ˤʤ�Ǥ��礦��
.Bd -literal
   ipfw add pipe 1 ip from A to B out
   ipfw add pipe 2 ip from B to A in
   ipfw pipe 1 config bw 1Mbit/s delay 80ms
   ipfw pipe 2 config bw 128Kbit/s delay 300ms
.Ed

.Pp
.Sh ���
.Nm ipfw
�Υ����ɤϡ��Ӱ��������塼���������ٱ䡢»����Ŭ�Ѥ���٤�
�ѥ��åȤ����̤������������¤򵭽Ҥ��� ``�ѥ���'' �μ��̻Ҥ�
�֤��ޤ���
.Pp
���̤��줿�ѥ��åȤϡ��ޤ�������Ƥ�줿�������Υ��塼���ߤ����ޤ���
���塼���ߤ���줿�ѥ��åȤϡ��ץ�����व�줿®���Ǽ��Ф��졢�ٱ��
���ߥ�졼�Ȥ��뤿��� 2 ���ܤΥ��塼�˰ܤ���ޤ���
2 ���ܤΥ��塼������Ф����ݤˡ��ѥ��åȤ������Ƥ����Τ�Ʊ��
�ץ��ȥ��륹���å���������ޤ�(�㤨�� ip_input(), ip_output(),
bdg_forward() �ʤ�)��
����� sysctl ��
   sys.net.inet.ipfw.one_pass
�������ͤ˰�¸���ޤ���
�ѥ��פ�����Ϥ��줿�ѥ��åȤϡ��ѥ��åȤΰ����ž������뤫��
�ޥå������롼��θ�˵��Ҥ��줿
.Nm ipfw
�Υ롼��˺Ƥ��Ϥ���ޤ���
.Pp
.Nm dummynet
�ϥ����ޤ� 1 tick ��˽�����Ԥ��ޤ����Ĥޤꡢ�����μ����ϥ����ͥ�
���ץ�����
.Bd -literal
    options HZ
.Ed

�ˤ�ä����椵��ޤ����ǥե������ (100) �� 10ms �������̣���ޤ���
�⤤�ǡ���®�٤����Τʥ��ߥ�졼������Ԥ�����ˤϡ�������
������ 1ms �ʲ������ꤹ��ɬ�פ����뤫�⤷��ޤ���
���������ץ������ˤ�� I/O (programmed I/O)
���Ѥ��Ƥ��륤�󥿥ե���������ˤϡ�
�ѥ��åȤ���Ϥ���Τˤ��ʤ�λ��֤��פ����Τ����뤳�Ȥ����դ���
�����������Ĥޤꡢ�����޼����򾮤������᤮��ȡ������ޤμ����˽�����
�ɤ��դ��������������٤�»�ʤäƤ��ޤ������줬����ޤ���

.Sh �����ͥ륪�ץ����
�����ͥ�����ե�������ΰʲ��Υ��ץ����
.Nm dummynet
��ư��˴ط����ޤ���
.Bd -literal
  IPFIREWALL               - ipfirewall ��ͭ���� (dummynet ���Ѥˤ�ɬ��)��
  IPFIREWALL_VERBOSE       - �ե�������������ξܺٽ��Ϥ�ͭ������
  IPFIREWALL_VERBOSE_LIMIT - �ե�������������ξܺٽ��Ϥ����¡�
  DUMMYNET                 - dummynet �ν�����ͭ������
  NMBCLUSTER               - �ͥåȥ���ѥ��åȥХåե����礭�������ꡣ
  HZ                       - �����ޤμ��������ꡣ
.Ed
.Pp
�̾�����Υ��ץ�����ɬ�ܤǤ���
.Bd -literal
  options IPFIREWALL
  options DUMMYNET
.Ed

�ä��ơ����ꤷ�����٤ƤΥѥ��פΡ��Ӱ������ٱ���֤��Ѥȡ����塼������
�ι�פˤ�äƤϡ�mbuf ���饹��
(�ͥåȥ���ѥ��åȤ��ߤ��Ƥ�������˻Ȥ��ޤ�)
�ο������䤹�����ɤ����⤷��ޤ���

.Sh SYSCTL �ѿ�
.Pp
.Bd -literal
    net.inet.ip.fw.one_pass
.Ed

�ѥ��åȤ��ե�������������Υ����ɤ���٤Τ��̤�褦�ˤ�������硢
1 �����ꤷ�ޤ���
.Bd -literal
   net.link.ether.bridge_ipfw
.Ed

�֥�å������ѥ��åȤ�ե�������������Υ����ɤ��Ϥ��������˥��åȤ��ޤ���

.Sh ���ޥ��
�ѥ��פ򰷤�����ˤϡ��ʲ��Υ����åȥ��ץ������Ѥ��ޤ���
.Pp
IP_DUMMYNET_CONFIGURE �ϡ��ѥ��פ�����򹹿����ޤ���(�ޤ��Ͽ�����
�ѥ��פ�������ޤ���)
.Pp
IP_DUMMYNET_DEL �ϡ��ޥå�����롼���ֹ椬¸�ߤ��뤹�٤ƤΥѥ��פ�
������ޤ���
.Pp
IP_DUMMYNET_GET �ϡ����ꤷ���ֹ�˥ޥå�����ѥ��פ��֤��ޤ���
.Pp
IP_FW_FLUSH ���ꤷ���ֹ�˥ޥå�����ѥ��פ�ե�å��夷�ޤ���
.Pp
�����ͥ륻�����ƥ���٥뤬 2 ����礭�����ϡ�
IP_DUMMYNET_GET �Τߤ����Ѳ�ǽ�Ǥ���
.Sh ��Ϣ����
.Xr setsockopt 2 ,
.Xr ip 4 ,
.Xr ipfw 8 ,
.Xr sysctl 8 .
.Sh �Х�
���Υޥ˥奢��ڡ����� dummynet ������ˡ�������򵭽Ҥ��Ƥ���
�櫓�ǤϤ���ޤ���
.Sh ���
.Nm
dummynet
�ϡ�ACM Computer Communication Review, Jan.97 issue �˵��Ҥ���Ƥ���褦�ˡ�
TCP �����Ԥ�����Τ���� Luigi Rizzo <[email protected]> ���������ޤ�����
���θ塢IP ����ӥ֥�å���٥�ǵ�ǽ����褦���ѹ����졢�����
IPFW �ѥ��åȥե��륿�����礵��ޤ�����