Whamcloud - gitweb
b=13499
[fs/lustre-release.git] / libsysio / README
1 Build
2 -----
3
4 To bootstrap configuration:
5
6 sh autogen.sh
7 ./configure [options]
8
9 Without the supported "--with" options only the core sysio library is
10 built.
11
12 Option --with-native-driver=yes will cause the "native" host name space test
13 driver to be enabled and made available in drivers/native/libsysio_native.a
14 when built. This is set by default; Use "no" to disable.
15
16 Option --with-tests=yes will cause the test programs in the tests directory
17 to be enabled. This is set by default; Use "no" to disable.
18
19 Option --with-automount=<automount-file-name> will cause automount support
20 to be included. If <automount-file-name> is not supplied, a default value
21 of ".mount" will be used, matching the Lustre documentation.
22
23 To build:
24
25 Just `make' it.
26
27 Automounts
28 ----------
29
30 For a full description of this see the "Lustre Book" at:
31         <http://www.lustre.org/docs/lustre.pdf>
32
33 In short, though, whenever a component is being looked up in a directory and
34 that directory has the "set-UID" bit set, then the directory is
35 searched for a special file. By default, that file is called ".mount" but
36 you may set it to any name using the --with-automount option described
37 earlier.
38
39 If the content of that file has something formatted, exactly:
40
41 <file-system-type>:<source>
42
43 Then the <source> description is mounted on the directory containing the
44 special automount file and being used as the parent in the lookup. If the
45 mount is successful, the parent is replaced with the newly mounted directory
46 and processing continues. If the mount fails, or the automount file
47 does not exist or cannot be read, everything continues as though the operation
48 had never been attempted.
49
50 File systems, or volumes, or file-sets, or whatever they are called, that
51 have been automounted may also be automatically unmounted when resource
52 is required. They are not on a timer, unless the file system driver implements
53 one for them. They just disappear as resource is needed elsewhere. As they
54 were automatically mounted to begin with, they should re-establish as needed,
55 transparently.
56
57 REDSTORM
58 --------
59
60 The following works for me:
61
62 #!/bin/sh
63
64 export CFLAGS="-DREDSTORM -nostdinc -isystem /home/lee/REDSTORM/catamount/computeincs/i386 -isystem /home/lee/REDSTORM/catamount/include -g -W -Wall -ansi"
65
66 sh configure --with-autmount=".mount" --with-native=yes --with-incore-yes --with-stdfd=yes --with-tests=yes