FDDICMD — User Commands

NAME

fddicmd − invoke ioctls on the FDDI device driver

SYNOPSIS

fddicmd[−reset] [−halt] [−flush] [−addr] [−debug] [−stats] [−echo SpriteID] [−size bytes] [−repeat n] [−syslog] [−reg] [−errlog]

OPTIONS

−reset
Reset the adapter.

−haltHalt the adapter.

−flush
Flush the driver’s transmit queue of waiting packets.

−addr
Print the adapter’s network address.

−debug
Toggle debugging. Messages are printed to the syslog.

−stats
Print adapter statistics.

−echo SpriteID
Echo packets off of the specified host.

−size bytes
Set the size of packets to echo.

−repeat n
Number of times to echo packets.

−regPrint the contents of the adapter registers.

−errlog
Print the internal and external error codes that the adapter writes as it halts. Should be zero for normal operation.

−syslog
Print info onto syslog instead of terminal.

DESCRIPTION

The various options perform ioctls on the FDDI driver.

The reset and halt options control the adapter’s connection to the ring. The reset option resets the adapter, connecting it back to the ring. The halt option halts the adapter, disconnecting it from the ring.

The flush option flushes the driver’s transmit queue.

The addr option prints out the adapter’s network address in the standard aa:bb:cc:dd:ee:ff form.

The debug option toggles debugging output. The messages are written to the syslog, and really slow down the adapter. Useful for seeing how the adapter works.

The stats option prints out adapter statistics. It first reports the number of packets and bytes sent and received. Then comes an array of receive reaped numbers. Each array slot denotes a number of received packets, and the value in that slot is the number of times that the driver reaped that number of packets in one interrupt. Following this is an array counting packet sizes, both sent and received.

The echo, size, and repeat options let hosts be pinged over FDDI. The argument to ehco is the Sprite ID of a host to ping. The argument to size controls the size of the RPC to ping with. And repeat controls the number of times the host is echoed. Timing numbers are reported when the echoes finish.

The reg and errlog options print out some of the adapter’s internal state. reg prints out the contents of the adapter’s registers. errlog prints out the internal and external error codes written by the adapter when it halts. These codes should be zero during normal operation.

The syslog option was intended to control whethere output would be printed on the syslog or on the terminal that invoked fddicmd. This is only partially supported.

KEYWORDS

net, FDDI