1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980 |
- .TH aoe-stat 8
- .SH NAME
- aoe-stat \- print aoe device status report
- .SH SYNOPSIS
- .nf
- .B modprobe aoe
- .B aoe-stat
- .B env sysfs_dir=/sys aoe-stat
- .fi
- .SH DESCRIPTION
- The
- .I aoe-stat
- script collects information on ATA over Ethernet devices from sysfs.
- .PP
- For each AoE device the kernel has discovered, there is one row in the
- script's output. Each row has
- the following columns.
- .TP
- .BI devicename
- The device name is of the form
- .I eX.Y,
- with
- .I X
- being the AoE device shelf address, and
- .I Y
- being the AoE slot address.
- .TP
- .BI ifname
- The network interface name is printed in the second column.
- .TP
- .BI status
- The device status is in the last column. Possible values
- are \fI up\fR, \fI down\fR,
- and \fI down,closewait\fR. The "up" status means the aoe driver
- considers this device ready
- for I/O. The "down" status means the opposite. The "down,closewait"
- status means that some software still has the device open, and when
- this straggler closes the device, it will enter the "down" state.
- .SH ENVIRONMENT VARIABLES
- If the
- .I sysfs_dir
- variable is set in the environment, it will override the default
- location where
- .I aoe-stat
- will look for
- sysfs, namely \fI /sys\fR.
- .SH EXAMPLE
- In this example, the root user on a host named
- .I nai
- loads the aoe driver module and then prints a list of all the
- available aoe devices. Then he remembers to bring up the storage
- network interfaces, does an AoE discovery, and prints the list again.
- This time the list shows all the devices in shelf seven.
- .IP
- .EX
- nai:~# modprobe aoe
- nai:~# aoe-stat
- nai:~# ifconfig eth3 up
- nai:~# aoe-discover
- nai:~# aoe-stat
- e7.0 eth3 up
- e7.1 eth3 up
- e7.2 eth3 up
- e7.3 eth3 up
- e7.4 eth3 up
- e7.5 eth3 up
- e7.6 eth3 up
- e7.7 eth3 up
- e7.8 eth3 up
- e7.9 eth3 up
- nai:~#
- .EE
- .LP
- .SH "SEE ALSO"
- .IR aoe-discover (8),
- .IR aoe-interfaces (8),
- .IR aoe-mkdevs (8),
- .IR aoe-mkshelf (8).
- .SH AUTHOR
- Ed L. Cashin (ecashin@coraid.com)
|