diff options
Diffstat (limited to 'Documentation/aoe')
-rw-r--r-- | Documentation/aoe/aoe.txt | 40 | ||||
-rw-r--r-- | Documentation/aoe/status.sh | 4 |
2 files changed, 36 insertions, 8 deletions
diff --git a/Documentation/aoe/aoe.txt b/Documentation/aoe/aoe.txt index 43e50108d0e2..3a4dbe4663c9 100644 --- a/Documentation/aoe/aoe.txt +++ b/Documentation/aoe/aoe.txt | |||
@@ -4,6 +4,16 @@ The EtherDrive (R) HOWTO for users of 2.6 kernels is found at ... | |||
4 | 4 | ||
5 | It has many tips and hints! | 5 | It has many tips and hints! |
6 | 6 | ||
7 | The aoetools are userland programs that are designed to work with this | ||
8 | driver. The aoetools are on sourceforge. | ||
9 | |||
10 | http://aoetools.sourceforge.net/ | ||
11 | |||
12 | The scripts in this Documentation/aoe directory are intended to | ||
13 | document the use of the driver and are not necessary if you install | ||
14 | the aoetools. | ||
15 | |||
16 | |||
7 | CREATING DEVICE NODES | 17 | CREATING DEVICE NODES |
8 | 18 | ||
9 | Users of udev should find the block device nodes created | 19 | Users of udev should find the block device nodes created |
@@ -35,14 +45,15 @@ USING DEVICE NODES | |||
35 | 45 | ||
36 | "echo eth2 eth4 > /dev/etherd/interfaces" tells the aoe driver to | 46 | "echo eth2 eth4 > /dev/etherd/interfaces" tells the aoe driver to |
37 | limit ATA over Ethernet traffic to eth2 and eth4. AoE traffic from | 47 | limit ATA over Ethernet traffic to eth2 and eth4. AoE traffic from |
38 | untrusted networks should be ignored as a matter of security. | 48 | untrusted networks should be ignored as a matter of security. See |
49 | also the aoe_iflist driver option described below. | ||
39 | 50 | ||
40 | "echo > /dev/etherd/discover" tells the driver to find out what AoE | 51 | "echo > /dev/etherd/discover" tells the driver to find out what AoE |
41 | devices are available. | 52 | devices are available. |
42 | 53 | ||
43 | These character devices may disappear and be replaced by sysfs | 54 | These character devices may disappear and be replaced by sysfs |
44 | counterparts, so distribution maintainers are encouraged to create | 55 | counterparts. Using the commands in aoetools insulates users from |
45 | scripts that use these devices. | 56 | these implementation details. |
46 | 57 | ||
47 | The block devices are named like this: | 58 | The block devices are named like this: |
48 | 59 | ||
@@ -66,7 +77,8 @@ USING SYSFS | |||
66 | through which we are communicating with the remote AoE device. | 77 | through which we are communicating with the remote AoE device. |
67 | 78 | ||
68 | There is a script in this directory that formats this information | 79 | There is a script in this directory that formats this information |
69 | in a convenient way. | 80 | in a convenient way. Users with aoetools can use the aoe-stat |
81 | command. | ||
70 | 82 | ||
71 | root@makki root# sh Documentation/aoe/status.sh | 83 | root@makki root# sh Documentation/aoe/status.sh |
72 | e10.0 eth3 up | 84 | e10.0 eth3 up |
@@ -89,3 +101,23 @@ USING SYSFS | |||
89 | e4.7 eth1 up | 101 | e4.7 eth1 up |
90 | e4.8 eth1 up | 102 | e4.8 eth1 up |
91 | e4.9 eth1 up | 103 | e4.9 eth1 up |
104 | |||
105 | Use /sys/module/aoe/parameters/aoe_iflist (or better, the driver | ||
106 | option discussed below) instead of /dev/etherd/interfaces to limit | ||
107 | AoE traffic to the network interfaces in the given | ||
108 | whitespace-separated list. Unlike the old character device, the | ||
109 | sysfs entry can be read from as well as written to. | ||
110 | |||
111 | It's helpful to trigger discovery after setting the list of allowed | ||
112 | interfaces. The aoetools package provides an aoe-discover script | ||
113 | for this purpose. You can also directly use the | ||
114 | /dev/etherd/discover special file described above. | ||
115 | |||
116 | DRIVER OPTIONS | ||
117 | |||
118 | There is a boot option for the built-in aoe driver and a | ||
119 | corresponding module parameter, aoe_iflist. Without this option, | ||
120 | all network interfaces may be used for ATA over Ethernet. Here is a | ||
121 | usage example for the module parameter. | ||
122 | |||
123 | modprobe aoe_iflist="eth1 eth3" | ||
diff --git a/Documentation/aoe/status.sh b/Documentation/aoe/status.sh index 6628116d4a9f..751f3be514b8 100644 --- a/Documentation/aoe/status.sh +++ b/Documentation/aoe/status.sh | |||
@@ -14,10 +14,6 @@ test ! -d "$sysd/block" && { | |||
14 | echo "$me Error: sysfs is not mounted" 1>&2 | 14 | echo "$me Error: sysfs is not mounted" 1>&2 |
15 | exit 1 | 15 | exit 1 |
16 | } | 16 | } |
17 | test -z "`lsmod | grep '^aoe'`" && { | ||
18 | echo "$me Error: aoe module is not loaded" 1>&2 | ||
19 | exit 1 | ||
20 | } | ||
21 | 17 | ||
22 | for d in `ls -d $sysd/block/etherd* 2>/dev/null | grep -v p` end; do | 18 | for d in `ls -d $sysd/block/etherd* 2>/dev/null | grep -v p` end; do |
23 | # maybe ls comes up empty, so we use "end" | 19 | # maybe ls comes up empty, so we use "end" |