Provided by: aoetools_8-0ubuntu1_i386 bug

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.

       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.

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).

AUTHOR

       Ed L. Cashin (ecashin@coraid.com)

                                                                   aoe-stat(8)