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 If the driver exports the per-packet data payload size, it will
31 appear in the fourth column, expressed in bytes.
32 status The device status is in the last column. Possible values are
34 up, down, and down,closewait. The "up" status means the aoe
35 driver considers this device ready for I/O. The "down" status
36 means the opposite. The "down,closewait" status means that some
37 software still has the device open, and when this straggler
38 closes the device, it will enter the "down" state.
39
41 If the sysfs_dir variable is set in the environment, it will override
42 the default location where aoe-stat will look for sysfs, namely /sys.
43
45 If the minor device number of a device node does not match that of its
46 namesake, aoe-stat will print a warning as shown below.
47 nai:~# aoe-stat
49 e0.3 0.104GB eth0 up
50 e0.4 4398.046GB eth0 up
51 e20.0 1000.215GB eth0 up
52 e42.0 2000.431GB eth0 up
53 aoe-stat Warning: device node /dev/etherd/e45.1 has wrong minor device number
54 e45.1 1152.874GB eth0 up
55 Using such a device node is dangerous, because its name doesn't match
57 the actual device that you would be reading from and writing to. Such
58 a broken device node should be removed. Device nodes are created by
59 udev or (on systems without udev) by aoe-mkdevs.
60
62 In this example, the root user on a host named nai loads the aoe driver
63 module and then prints a list of all the available aoe devices. Then
64 he remembers to bring up the storage network interfaces, does an AoE
65 discovery, and prints the list again. This time the list shows all the
66 devices in shelf seven.
67 nai:~# modprobe aoe
69 nai:~# aoe-stat
70 nai:~# ifconfig eth3 up
71 nai:~# aoe-discover
72 nai:~# aoe-stat
73 e0.0 10995.116GB eth0 up
74 e0.1 10995.116GB eth0 up
75 e0.2 10995.116GB eth0 up
76 e1.0 1152.874GB eth0 up
77 e7.0 370.566GB eth0 up
78 nai:~#
79
81 aoe-discover(8), aoe-interfaces(8), aoe-mkdevs(8), aoe-mkshelf(8), aoe‐
82 tools(8), udev(7).
83
85 Ed L. Cashin (ecashin@coraid.com)
86 aoe-stat(8)