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