1aoe-stat(8) System Manager's Manual aoe-stat(8)
2
6 aoe-stat - print aoe device status report
7
9 modprobe aoe
10 aoe-stat
11 env sysfs_dir=/sys aoe-stat
12
14 The aoe-stat script collects information on ATA over Ethernet devices
15 from sysfs.
16 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 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 size The size of the AoE device is in gigabytes (billions of bytes).
26 ifname The network interface name is printed in the third column.
28 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 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
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 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
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
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 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 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
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 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
92 aoe-discover(8), aoe-interfaces(8), aoe-mkdevs(8), aoe-mkshelf(8), aoe‐
93 tools(8), udev(7).
94
96 Ed L. Cashin (ecashin@coraid.com)
97 aoe-stat(8)