IPDADM(8) Maintenance Commands and Procedures IPDADM(8)

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:

-z

The string of the zonename to control. If this is not specified, the current zone is used. For the list subcommand, this option is not supported.

The following subcommands are supported:

corrupt percent

Sets the chance for packets to be corrupted to percent which must be a decimal between 0 and 100. Setting percent to 0 disables packet corruption and is equivalent to calling remove corrupt. When enabled, a random byte will have a single bit flipped.

delay microseconds

Inserts microseconds of delay between both the transmit and receive of each packet. Setting microseconds to zero is equivalent to calling remove delay.

drop percent

Sets the chance for packets to be dropped to percent. percent must be a decimal between 0 and 100. Setting percent to zero is equivalent to calling remove drop.

info

Prints the current values for packet corruption, packet dropping, and packet delay for the zone.

list

Prints out the zonename of each zone that has active (non-zero) packet corruption, packet delay, and packet drop.

remove corrupt,delay,drop

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, delay, and drop can be specified as a comma separated list.

Example 1 Viewing zone information

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:

0

Successful completion.

1

An error occurred.

2

Invalid command line options or arguments were specified.

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Evolving

zonename(1), attributes(7), zones(7), zoneadm(8)

March 1, 2012 OmniOS