1aoe-stat(8)                 System Manager's Manual                aoe-stat(8)
2
3
4

NAME

6       aoe-stat - print aoe device status report
7

SYNOPSIS

9       modprobe aoe
10       aoe-stat
11       env sysfs_dir=/sys aoe-stat
12

DESCRIPTION

14       The  aoe-stat  script collects information on ATA over Ethernet devices
15       from sysfs.
16
17       For each AoE device the kernel has discovered, there is one row in  the
18       script's output.  Each row has the following columns.
19
20       devicename
21              The device name is of the form eX.Y,
22               with  X being the AoE device shelf address, and Y being the AoE
23              slot address.
24
25       size   The size of the AoE device is in gigabytes (billions of bytes).
26
27       ifname The network interface name is printed in the third column.
28
29       payload
30              The number of bytes read from or written to the  storage  target
31              in  each AoE packet appears in the fourth column, unless the aoe
32              driver does not export this information.
33
34       status The device status is in the last column.   Possible  values  are
35              up,   down,  and  down,closewait.  The "up" status means the aoe
36              driver considers this device ready for I/O.  The  "down"  status
37              means the opposite.  The "down,closewait" status means that some
38              software still has the device  open,  and  when  this  straggler
39              closes the device, it will enter the "down" state.
40

UNAVAILABLE TARGETS

42       If  a  discovered  AoE target will not respond to I/O commands, some of
43       the information needed to allow Linux to use the device is  not  avail‐
44       able.   The  aoe-stat  command  shows the missing information as "(NA)"
45       fields.
46
47       It is normal for "(NA)" fields to appear during the brief time  between
48       the  time  that an AoE target is detected and the time the Linux kernel
49       finishes reading its partition table.
50

ENVIRONMENT VARIABLES

52       If the sysfs_dir variable is set in the environment, it  will  override
53       the default location where aoe-stat will look for sysfs, namely  /sys.
54

WARNINGS

56       If  the minor device number of a device node does not match that of its
57       namesake, aoe-stat will print a warning as shown below.
58
59              nai:~# aoe-stat
60                    e0.3         0.104GB   eth0 up
61                    e0.4      4398.046GB   eth0 up
62                   e20.0      1000.215GB   eth0 up
63                   e42.0      2000.431GB   eth0 up
64              aoe-stat Warning: device node /dev/etherd/e45.1 has wrong minor device number
65                   e45.1      1152.874GB   eth0 up
66
67       Using such a device node is dangerous, because its name  doesn't  match
68       the  actual device that you would be reading from and writing to.  Such
69       a broken device node should be removed.  Device nodes  are  created  by
70       udev or (on systems without udev) by aoe-mkdevs.
71

EXAMPLE

73       In this example, the root user on a host named nai loads the aoe driver
74       module and then prints a list of all the available aoe  devices.   Then
75       he  remembers  to  bring up the storage network interfaces, does an AoE
76       discovery, and prints the list again.  This time the list shows all the
77       devices in shelf seven.
78
79              nai:~# modprobe aoe
80              nai:~# aoe-stat
81              nai:~# ifconfig eth3 up
82              nai:~# aoe-discover
83              nai:~# aoe-stat
84                    e0.0     10995.116GB   eth3 up
85                    e0.1     10995.116GB   eth3 up
86                    e0.2     10995.116GB   eth3 up
87                    e1.0      1152.874GB   eth3 up
88                    e7.0       370.566GB   eth3 up
89              nai:~#
90

SEE ALSO

92       aoe-discover(8), aoe-interfaces(8), aoe-mkdevs(8), aoe-mkshelf(8), aoe‐
93       tools(8), udev(7).
94

AUTHOR

96       Ed L. Cashin (ecashin@coraid.com)
97
98
99
100                                                                   aoe-stat(8)
Impressum