usr.sbin/mtest/mtest.8

   1 .\"
   2 .\" $FreeBSD$
   3 .\"
   4 .\" The following requests are required for all man pages.
   5 .Dd March 8, 2007
   6 .Os
   7 .Dt MTEST 8
   8 .Sh NAME
   9 .Nm mtest
  10 .Nd test multicast membership socket operations and ioctls
  11 .Sh SYNOPSIS
  12 .Nm
  13 .Sh DESCRIPTION
  14 The
  15 .Nm
  16 utility
  17 is a small program for testing the multicast membership socket operations
  18 and ioctls.
  19 It accepts the following commands, interactively:
  20 .Bl -tag -width "a ifname e.e.e.e.e.e" -compact -offset indent
  21 .It Ic j Ar g.g.g.g Ar i.i.i.i
  22 Join the IP group address
  23 .Ar g.g.g.g
  24 on the interface with address
  25 .Ar i.i.i.i .
  26 .Ar i.i.i.i
  27 may be specified as 0.0.0.0 to use the default interface.
  28 .It Ic l Ar g.g.g.g Ar i.i.i.i
  29 Leave the IP group address
  30 .Ar g.g.g.g
  31 on the interface with address
  32 .Ar i.i.i.i .
  33 .It Ic a Ar ifname Ar e.e.e.e.e.e
  34 Join the Ethernet group address
  35 .Ar e.e.e.e.e.e
  36 on interface
  37 .Ar ifname .
  38 .It Ic d Ar ifname Ar e.e.e.e.e.e
  39 Leave the Ethernet group address
  40 .Ar e.e.e.e.e.e
  41 on interface
  42 .Ar ifname .
  43 .It Ic m Ar ifname Ar 1/0
  44 Set or reset ALLMULTI mode on interface
  45 .Ar ifname .
  46 .It Ic p Ar ifname Ar 1/0
  47 Set or reset promiscuous mode on interface
  48 .Ar ifname .
  49 .\"
  50 .It Ic i Ar g.g.g.g Ar i.i.i.i Ar n Ar x.x.x.x ...
  51 Set the socket with group membership of
  52 .Ar g.g.g.g
  53 on IPv4 address
  54 .Ar i.i.i.i
  55 to include filter mode, and add
  56 .Ar n
  57 sources beginning with
  58 .Ar x.x.x.x
  59 to the inclusion filter list.
  60 .\"
  61 .It Ic e Ar g.g.g.g Ar i.i.i.i Ar n Ar x.x.x.x ...
  62 Set the socket with group membership of
  63 .Ar g.g.g.g
  64 on IPv4 address
  65 .Ar i.i.i.i
  66 to exclude filter mode, and add
  67 .Ar n
  68 sources beginning with
  69 .Ar x.x.x.x
  70 to the exclusion filter list.
  71 .\"
  72 .It Ic t Ar g.g.g.g Ar i.i.i.i Ar s.s.s.s
  73 Set the socket with group membership of
  74 .Ar g.g.g.g
  75 on IPv4 address
  76 .Ar i.i.i.i
  77 to block traffic from source
  78 .Ar s.s.s.s .
  79 .\"
  80 .It Ic b Ar g.g.g.g Ar i.i.i.i Ar s.s.s.s
  81 Set the socket with group membership of
  82 .Ar g.g.g.g
  83 on IPv4 address
  84 .Ar i.i.i.i
  85 to allow traffic from source
  86 .Ar s.s.s.s .
  87 .\"
  88 .It Ic g Ar g.g.g.g Ar i.i.i.i Ar n
  89 Print
  90 .Ar n
  91 source filter entries for group
  92 .An g.g.g.g
  93 on IPv4 address
  94 .An i.i.i.i .
  95 .\"
  96 .It Ic f Ar filename
  97 Read commands from the file
  98 .Ar filename .
  99 .It Ic s Ar n
 100 Sleep for
 101 .Ar n
 102 seconds.
 103 .It Ic ?\&
 104 List legal commands.
 105 .It Ic q
 106 Quit the program.
 107 .El
 108 .Sh SEE ALSO
 109 .Rs
 110 .%A D. Thaler
 111 .%A B. Fenner
 112 .%A B. Quinn
 113 .%T "Socket Interface Extensions for Multicast Filters"
 114 .%O RFC 3678
 115 .Re
 116 .Sh AUTHORS
 117 .An -split
 118 .An "Steve Deering"
 119 .An "Wilbert De Graaf"