NAME
aoe-stat - print aoe device status report
SYNOPSIS
modprobe aoe
aoe-stat
env sysfs_dir=/sys aoe-stat
DESCRIPTION
The 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.
devicename
The device name is of the form eX.Y,
with X being the AoE device shelf address, and Y being the AoE
slot address.
size The size of the AoE device is in gigabytes (billions of bytes).
ifname The network interface name is printed in the third column.
payload
The number of bytes read from or written to the storage target
in each AoE packet appears in the fourth column, unless the aoe
driver does not export this information.
status 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 VARIABLES
If the sysfs_dir variable is set in the environment, it will override
the default location where aoe-stat will look for sysfs, namely /sys.
WARNINGS
If 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.
EXAMPLE
In 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:~#
SEE ALSO
aoe-discover(8), aoe-interfaces(8), aoe-mkdevs(8), aoe-mkshelf(8),
aoetools(8), udev(7).
AUTHOR
Ed L. Cashin (ecashin@coraid.com)
aoe-stat(8)