aoe-stat.8 3.0 KB

  1. .TH aoe-stat 8
  2. .SH NAME
  3. aoe-stat \- print aoe device status report
  5. .nf
  6. .B modprobe aoe
  7. .B aoe-stat
  8. .B env sysfs_dir=/sys aoe-stat
  9. .fi
  11. The
  12. .I aoe-stat
  13. script collects information on ATA over Ethernet devices from sysfs.
  14. .PP
  15. For each AoE device the kernel has discovered, there is one row in the
  16. script's output. Each row has
  17. the following columns.
  18. .TP
  19. .BI devicename
  20. The device name is of the form
  21. .I eX.Y,
  22. with
  23. .I X
  24. being the AoE device shelf address, and
  25. .I Y
  26. being the AoE slot address.
  27. .TP
  28. .BI size
  29. The size of the AoE device is in gigabytes (billions of bytes).
  30. .TP
  31. .BI ifname
  32. The network interface name is printed in the third column.
  33. .TP
  34. .BI payload
  35. If the driver exports the per-packet data payload size, it
  36. will appear in the fourth column, expressed in bytes.
  37. .TP
  38. .BI status
  39. The device status is in the last column. Possible values
  40. are \fI up\fR, \fI down\fR,
  41. and \fI down,closewait\fR. The "up" status means the aoe driver
  42. considers this device ready
  43. for I/O. The "down" status means the opposite. The "down,closewait"
  44. status means that some software still has the device open, and when
  45. this straggler closes the device, it will enter the "down" state.
  47. If the
  48. .I sysfs_dir
  49. variable is set in the environment, it will override the default
  50. location where
  51. .I aoe-stat
  52. will look for
  53. sysfs, namely \fI /sys\fR.
  55. If the minor device number of a device node does not match that of its
  56. namesake, \fIaoe-stat\fP will print a warning as shown below.
  57. .IP
  58. .EX
  59. .nf
  60. nai:~# aoe-stat
  61. e0.3 0.104GB eth0 up
  62. e0.4 4398.046GB eth0 up
  63. e20.0 1000.215GB eth0 up
  64. e42.0 2000.431GB eth0 up
  65. aoe-stat Warning: device node /dev/etherd/e45.1 has wrong minor device number
  66. e45.1 1152.874GB eth0 up
  67. .fi
  68. .EE
  69. .PP
  70. Using such a device node is dangerous, because its name doesn't match
  71. the actual device that you would be reading from and writing to. Such
  72. a broken device node should be removed. Device nodes are created by
  73. \fIudev\fP or (on systems without \fIudev\fP) by \fIaoe-mkdevs\fP.
  75. In this example, the root user on a host named
  76. .I nai
  77. loads the aoe driver module and then prints a list of all the
  78. available aoe devices. Then he remembers to bring up the storage
  79. network interfaces, does an AoE discovery, and prints the list again.
  80. This time the list shows all the devices in shelf seven.
  81. .IP
  82. .EX
  83. .nf
  84. nai:~# modprobe aoe
  85. nai:~# aoe-stat
  86. nai:~# ifconfig eth3 up
  87. nai:~# aoe-discover
  88. nai:~# aoe-stat
  89. e0.0 10995.116GB eth0 up
  90. e0.1 10995.116GB eth0 up
  91. e0.2 10995.116GB eth0 up
  92. e1.0 1152.874GB eth0 up
  93. e7.0 370.566GB eth0 up
  94. nai:~#
  95. .fi
  96. .EE
  97. .SH "SEE ALSO"
  98. .IR aoe-discover (8),
  99. .IR aoe-interfaces (8),
  100. .IR aoe-mkdevs (8),
  101. .IR aoe-mkshelf (8),
  102. .IR aoetools (8),
  103. .IR udev (7).
  104. .SH AUTHOR
  105. Ed L. Cashin (