ipdadm - administer the Internet packet disturber
ipdadm [-z zonename] subcommand [subcommand-options]
The ipdadm utility is used to administer the illumos facility for simulating
pathological networks by induce packet drops, delays, and corruption.
This functionality is only able to the global zone and zones with
exclusive networking stacks. If this is enabled for the global zone, any
zone with a shared networking stack will be affected.
The following options are supported:
The string of the zonename to control. If this is not
specified, the current zone is used. For the list subcommand, this option is
The following subcommands are supported:
Sets the chance for packets to be corrupted to
which must be a decimal between 0 and 100. Setting
to 0 disables packet corruption and is equivalent to calling
. When enabled, a random byte will have a single
of delay between both the
transmit and receive of each packet. Setting microseconds
to zero is
equivalent to calling remove delay
Sets the chance for packets to be dropped to
must be a decimal between 0 and 100. Setting
to zero is equivalent to calling remove drop
Prints the current values for packet corruption, packet
dropping, and packet delay for the zone.
Prints out the zonename of each zone that has active
(non-zero) packet corruption, packet delay, and packet drop.
Example 1 Viewing zone information
Disables the requested forms of packet perturbation for
the zone. This is functionally equivalent to setting the value to zero. One or
more of corrupt
, and drop
can be specified as a
comma separated list.
The following command illustrates how to obtain information about
a specific zone while in the global zone.
# ipdadm -z 949860c5-52e2-4f32-965d-02e60e116b72 info
ipd information for zone 949860c5-52e2-4f32-965d-02e60e116b72:
corrupt: 0% chance of packet corruption
drop: 0% chance of packet drop
delay: 0 microsecond delay per packet
Example 2 Removing multiple perturbations
The following command illustrates the use of the remove
subcommand from inside of a zone.
# ipdadm remove corrupt,drop
Example 3 Enabling packet drops
The following command illustrates the use of the drop
subcommand from the global zone.
# ipdadm -z 949860c5-52e2-4f32-965d-02e60e116b72 drop 25
The following exit values are returned:
See attributes(5) for descriptions of the following attributes:
An error occurred.
Invalid command line options or arguments were