aoe-interfaces.8 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. .TH aoe-interfaces 8
  2. .SH NAME
  3. aoe-interfaces \- restrict aoe driver to specified network interfaces
  4. .SH SYNOPSIS
  5. .nf
  6. .B aoe-interfaces [dev1] [dev2 ...]
  7. .B aoe-interfaces -c
  8. .fi
  9. .SH DESCRIPTION
  10. The
  11. .I aoe-interfaces
  12. command tells the aoe driver to ignore ATA over Ethernet (AoE) traffic
  13. on all but the specified network interfaces. It is analogous to the
  14. \fIaoe_iflist\fP module load option.
  15. .PP
  16. If neither the \fIaoe_iflist\fP module load option nor the
  17. \fIaoe-interfaces\fP command are used, the aoe driver will use any
  18. network interface for AoE traffic. Using \fIaoe-interfaces\fP to
  19. limit AoE to only trusted networks prevents the case where a rogue AoE
  20. target appears on a public network, diverting data from the legitimate
  21. AoE target. Such an imposter target effectively corrupts the data on
  22. the legitimate target.
  23. .PP
  24. If the aoe driver is a module, then calling
  25. .I aoe-interfaces
  26. without arguments will display the current interfaces list. If it
  27. hasn't been set then the output will be blank.
  28. .PP
  29. It's good to run the
  30. .I aoe-discover
  31. command after setting the AoE interfaces list.
  32. .SH OPTIONS
  33. .TP
  34. \fB-c\fP
  35. The \fB-c\fP flag will clear the interface access list, permitting any interface to be used.
  36. .SH EXAMPLE
  37. In this example, the root user on a host named
  38. .I nai
  39. loads the aoe module with only eth0 allowable for AoE traffic. After
  40. remembering that shelf 7 is on eth3, this
  41. sysadmin uses
  42. .I aoe-interfaces
  43. to add eth3 to the list of allowable network interfaces and then
  44. calls
  45. .I aoe-discover
  46. to ask the aoe driver to look for new AoE devices.
  47. .IP
  48. .EX
  49. .nf
  50. nai:~# modprobe aoe aoe_iflist="eth0"
  51. nai:~# aoe-stat
  52. e10.9 eth0 up
  53. nai:~# aoe-interfaces eth0 eth3
  54. nai:~# aoe-discover
  55. nai:~# aoe-stat
  56. e7.0 eth3 up
  57. e7.1 eth3 up
  58. e7.2 eth3 up
  59. e7.3 eth3 up
  60. e7.4 eth3 up
  61. e7.5 eth3 up
  62. e7.6 eth3 up
  63. e7.7 eth3 up
  64. e7.8 eth3 up
  65. e7.9 eth3 up
  66. e10.9 eth0 up
  67. nai:~# aoe-interfaces
  68. eth0 eth3
  69. .fi
  70. .EE
  71. .SH "SEE ALSO"
  72. .IR aoe-discover (8),
  73. .IR aoe-stat (8),
  74. .IR aoetools (8).
  75. .SH AUTHOR
  76. Ed L. Cashin (ecashin@coraid.com)