mausezahn provides a built-in context-specific help. Append the
keyword
''help'' after the configuration options. The most important
options are:
-x [<port>]
Start mausezahn in interactive mode with a Cisco-like CLI. Use
telnet to log into the local mausezahn instance. If no port has
been specified, port 25542 is used by default.
-6
Specify IPv6 mode (IPv4 is the default).
-l <IP>
Specify the IP address mausezahn should bind to when in
interactive mode, default: 0.0.0.0.
-R <PRIO>
Set priority of sent packets. This configures SO_PRIORITY at the
socket through which the packets are sent. Usual priority numbers
are 0..15, but the value can also be a class ID for purposes of
Qdisc classification. In that case, a class ID such is 1234:5678
would be specified as 0x12345678.
-v
Verbose mode. Capital -V is even more verbose.
-S
Simulation mode, i.e. don't put anything on the wire. This is
typically combined with the verbose mode.
-q
Quiet mode where only warnings and errors are displayed.
-c <count>
Send the packet count times (default: 1, infinite: 0).
-d <delay>
Apply delay between transmissions. The delay value can be
specified in usec (default, no additional unit needed), or in
msec (e.g. 100m or 100msec), or in seconds (e.g. 100s or 100sec).
Note: mops also supports nanosecond delay resolution if you need
it (see interactive mode).
-r
Multiply the specified delay with a random value.
-p <length>
Pad the raw frame to specified length using zero bytes. Note that
for raw layer 2 frames the specified length defines the whole
frame length, while for higher layer packets the number of
additional padding bytes are specified.
-a <src-mac|keyword>
Use specified source MAC address with hexadecimal notation such
as 00:00:aa:bb:cc:dd. By default the interface MAC address will
be used. The keywords ''rand'' and ''own'' refer to a random MAC
address (only unicast addresses are created) and the own address,
respectively. You can also use the keywords mentioned below
although broadcast-type source addresses are officially invalid.
-b <dst-mac|keyword>
Use specified destination MAC address. By default, a broadcast is
sent in raw layer 2 mode or to the destination hosts or gateway
interface MAC address in normal (IP) mode. You can use the same
keywords as mentioned above, as well as ''bc'' or ''bcast'',
''cisco'', and ''stp''.
-A <src-ip|range|rand>
Use specified source IP address, default is own interface
address. Optionally, the keyword ''rand'' can again be used for a
random source IP address or a range can be specified, such as
''192.168.1.1-192.168.1.100'' or ''10.1.0.0/16''. Also, a DNS
name can be specified for which mausezahn tries to determine the
corresponding IP address automatically.
-B <dst-ip|range>
Use specified destination IP address (default is broadcast i.e.
255.255.255.255). As with the source address (see above) you can
also specify a range or a DNS name.
-t <packet-type [help] | help>
Create the specified packet type using the built-in packet
builder. Currently, supported packet types are: ''arp'',
''bpdu'', ''ip'', ''udp'', ''tcp'', ''rtp'', and ''dns''.
Currently, there is also limited support for ''icmp''. Type
''-t help'' to verify which packet builders your actual
mausezahn version supports. Also, for any particular packet type,
for example ''tcp'' type
''mausezahn -t tcp help'' to receive a more in-depth context
specific help.
-T <packet-type>
Make this mausezahn instance the receiving station. Currently,
only ''rtp'' is an option here and provides precise jitter
measurements. For this purpose, start another mausezahn instance
on the sending station and the local receiving station will
output jitter statistics. See ''mausezahn -T rtp help'' for a
detailed help.
-Q <[CoS:]vlan> [, <[CoS:]vlan>, ...]
Specify 802.1Q VLAN tag and optional Class of Service. An
arbitrary number of VLAN tags can be specified (that is, you can
simulate QinQ or even QinQinQinQ..). Multiple tags must be
separated via a comma or a period (e.g. "5:10,20,2:30"). VLAN
tags are not supported for ARP and BPDU packets (in which case
you could specify the whole frame in hexadecimal using the raw
layer 2 interface of mausezahn).
-M <label[:cos[:ttl]][bos]> [, <label...>]
Specify a MPLS label or even a MPLS label stack. Optionally, for
each label the experimental bits (usually the Class of Service,
CoS) and the Time To Live (TTL) can be specified. If you are
really crazy you can set and unset the Bottom of Stack (BoS) bit
for each label using the ''S'' (set) and ''s'' (unset) option. By
default, the BoS is set automatically and correctly. Any other
setting will lead to invalid frames. Enter ''-M help'' for
detailed instructions and examples.
-P <ascii-payload>
Specify a cleartext payload. Alternatively, each packet type
supports a hexadecimal specification of the payload (see for
example ''-t udp help'').
-f <filename>
Read the ASCII payload from the specified file.
-F <filename>
Read the hexadecimal payload from the specified file. Actually,
this file must be also an ASCII text file, but must contain
hexadecimal digits, e.g. "aa:bb:cc:0f:e6...". You can use also
spaces as separation characters.
