aoe-stat (8) - Linux Man Pages
aoe-stat: print aoe device status report
NAMEaoe-stat - print aoe device status report
modprobe aoe aoe-stat env sysfs_dir=/sys aoe-stat
DESCRIPTIONThe aoe-stat script collects information on ATA over Ethernet devices from sysfs.
For each AoE device the kernel has discovered, there is one row in the script's output. Each row has the following columns.
The device name is of the form
with X being the AoE device shelf address, and Y being the AoE slot address.
- The size of the AoE device is in gigabytes (billions of bytes).
- The network interface name is printed in the third column.
- If the driver exports the per-packet data payload size, it will appear in the fourth column, expressed in bytes.
- The device status is in the last column. Possible values are up, down, and down,closewait. 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.
ENVIRONMENT VARIABLESIf the sysfs_dir variable is set in the environment, it will override the default location where aoe-stat will look for sysfs, namely /sys.
WARNINGSIf the minor device number of a device node does not match that of its namesake, aoe-stat will print a warning as shown below.
nai:~# aoe-stat e0.3 0.104GB eth0 up e0.4 4398.046GB eth0 up e20.0 1000.215GB eth0 up e42.0 2000.431GB eth0 up aoe-stat Warning: device node /dev/etherd/e45.1 has wrong minor device number e45.1 1152.874GB eth0 up
Using such a device node is dangerous, because its name doesn't match the actual device that you would be reading from and writing to. Such a broken device node should be removed. Device nodes are created by udev or (on systems without udev) by aoe-mkdevs.
EXAMPLEIn this example, the root user on a host named 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.
nai:~# modprobe aoe nai:~# aoe-stat nai:~# ifconfig eth3 up nai:~# aoe-discover nai:~# aoe-stat e0.0 10995.116GB eth0 up e0.1 10995.116GB eth0 up e0.2 10995.116GB eth0 up e1.0 1152.874GB eth0 up e7.0 370.566GB eth0 up nai:~#
AUTHOREd L. Cashin (ecashin [at] coraid.com)