Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
AFS: Documentation updates
Fix some issues with the AFS documentation, found when testing AFS on ppc64:
- Update AFS features: reading/writing, local caching
- Typo in kafs sysfs debug file
- Use modprobe instead of insmod in example
- Update IPs for grand.central.org
Signed-off-by: Anton Blanchard <anton@samba.org>
Signed-off-by: David Howells <dhowells@redhat.com>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
authored by
Anton Blanchard
and committed by
Linus Torvalds
0dc9aa84
cad2c8fd
+12
-14
+12
-14
Documentation/filesystems/afs.txt
+12
-14
Documentation/filesystems/afs.txt
···
23
23
24
24
(*) Security (currently only AFS kaserver and KerberosIV tickets).
25
25
26
-
(*) File reading.
26
+
(*) File reading and writing.
27
27
28
28
(*) Automounting.
29
29
30
+
(*) Local caching (via fscache).
31
+
30
32
It does not yet support the following AFS features:
31
-
32
-
(*) Write support.
33
-
34
-
(*) Local caching.
35
33
36
34
(*) pioctl() system call.
37
35
···
54
56
the masks in the following files:
55
57
56
58
/sys/module/af_rxrpc/parameters/debug
57
-
/sys/module/afs/parameters/debug
59
+
/sys/module/kafs/parameters/debug
58
60
59
61
60
62
=====
···
64
66
When inserting the driver modules the root cell must be specified along with a
65
67
list of volume location server IP addresses:
66
68
67
-
insmod af_rxrpc.o
68
-
insmod rxkad.o
69
-
insmod kafs.o rootcell=cambridge.redhat.com:172.16.18.73:172.16.18.91
69
+
modprobe af_rxrpc
70
+
modprobe rxkad
71
+
modprobe kafs rootcell=cambridge.redhat.com:172.16.18.73:172.16.18.91
70
72
71
73
The first module is the AF_RXRPC network protocol driver. This provides the
72
74
RxRPC remote operation protocol and may also be accessed from userspace. See:
···
79
81
Once the module has been loaded, more modules can be added by the following
80
82
procedure:
81
83
82
-
echo add grand.central.org 18.7.14.88:128.2.191.224 >/proc/fs/afs/cells
84
+
echo add grand.central.org 18.9.48.14:128.2.203.61:130.237.48.87 >/proc/fs/afs/cells
83
85
84
86
Where the parameters to the "add" command are the name of a cell and a list of
85
87
volume location servers within that cell, with the latter separated by colons.
···
99
101
specify connection to only volumes of those types.
100
102
101
103
The name of the cell is optional, and if not given during a mount, then the
102
-
named volume will be looked up in the cell specified during insmod.
104
+
named volume will be looked up in the cell specified during modprobe.
103
105
104
106
Additional cells can be added through /proc (see later section).
105
107
···
161
163
162
164
The filesystem maintains an internal database of all the cells it knows and the
163
165
IP addresses of the volume location servers for those cells. The cell to which
164
-
the system belongs is added to the database when insmod is performed by the
166
+
the system belongs is added to the database when modprobe is performed by the
165
167
"rootcell=" argument or, if compiled in, using a "kafs.rootcell=" argument on
166
168
the kernel command line.
167
169
168
170
Further cells can be added by commands similar to the following:
169
171
170
172
echo add CELLNAME VLADDR[:VLADDR][:VLADDR]... >/proc/fs/afs/cells
171
-
echo add grand.central.org 18.7.14.88:128.2.191.224 >/proc/fs/afs/cells
173
+
echo add grand.central.org 18.9.48.14:128.2.203.61:130.237.48.87 >/proc/fs/afs/cells
172
174
173
175
No other cell database operations are available at this time.
174
176
···
231
233
mount -t afs \%root.afs. /afs
232
234
mount -t afs \%cambridge.redhat.com:root.cell. /afs/cambridge.redhat.com/
233
235
234
-
echo add grand.central.org 18.7.14.88:128.2.191.224 > /proc/fs/afs/cells
236
+
echo add grand.central.org 18.9.48.14:128.2.203.61:130.237.48.87 > /proc/fs/afs/cells
235
237
mount -t afs "#grand.central.org:root.cell." /afs/grand.central.org/
236
238
mount -t afs "#grand.central.org:root.archive." /afs/grand.central.org/archive
237
239
mount -t afs "#grand.central.org:root.contrib." /afs/grand.central.org/contrib