123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778 |
- .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 size
- The size of the AoE device is in gigabytes (billions of bytes).
- .TP
- .BI ifname
- The network interface name is printed in the third 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
- 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:~#
- .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)
|