arlad/arla.conf.5

   1 .\" Copyright (c) 2000 - 2003 Kungliga Tekniska Högskolan
   2 .\" $Id$
   3 .Dd June 16, 2003
   4 .Dt ARLA.CONF 5
   5 .Os "The Arla Project"
   6 .Sh NAME
   7 .Nm arla.conf
   8 .Nd
   9 configuration file for the arla AFS implementation.
  10 .Sh SYNOPSIS
  11 The default configuration file works very well in most cases.
  12 .Sh DESCRIPTION
  13 Most flags can be overridden by command line arguments to
  14 .Nm arlad .
  15 .Pp
  16 Each option can be of the type integer, string or boolean.
  17 .Pp
  18 Integer values can be written with suffix
  19 .Sq K
  20 (kilo, 1000),
  21 .Sq M
  22 (mega, 10000000)
  23 and
  24 .Sq G
  25 (giga, 10000000000) .
  26 .Pp
  27 Strings are written without quotes or spaces in the strings.
  28 .Pp
  29 Boolean values can be either of
  30 .Ar yes ,
  31 .Ar true ,
  32 .Ar no ,
  33 or
  34 .Ar false .
  35 .Pp
  36 Supported options:
  37 .Bl -tag -width Ds
  38 .It dynroot
  39 Boolean value. Dynamic root, generates your
  40 .Pa /afs
  41 directory from
  42 .Pa CellServDB or
  43 .Pa DynRootDB .
  44 Useful when you don't want to use your cell's root.afs.
  45 .It fake_stat
  46 Boolean value.
  47 If set, do not fetch real stat information where it can be expensive
  48 (i e across mountpoints), but make up some reasonable values.
  49 .It fetch_block
  50 Integer value.
  51 Determines the fetch/pre-fetch block size.
  52 This option will later be replaced by code to automagically tune this
  53 setting.
  54 .It low_vnodes
  55 Integer value.
  56 The number of used vnodes we try to keep in the cache. Any higher
  57 number of used nodes will trigger the cleaner thread.
  58 .It high_bytes
  59 Integer value.
  60 The high watermark for files used by arlad.
  61 .It low_bytes
  62 Integer value.
  63 The number of bytes we try to keep in the cache.
  64 Any higher number of bytes will trigger the cleaner thread.
  65 .It numcreds
  66 Integer value.
  67 The maximum number of credentials kept in arla, both authenticated
  68 (like Kerberos V4 creds), and not.
  69 .It numconns
  70 Integer value.
  71 The maximum total number of connections arla will keep to servers
  72 (fileserver and vldb-server).
  73 .It numvols
  74 Integer value.
  75 The number of volumes stored in cache.
  76 .It workers
  77 Integer value.
  78 The number of workers processing messages on currently.
  79 .It sysname
  80 String value.
  81 The sysname is possible to specify in the configuration file. It's
  82 overridden by the command line argument
  83 .Ar --sysname=sysname
  84 to arlad.
  85 .It rxkad-level
  86 It can be one of:
  87 .Ar clear ,
  88 .Ar auth ,
  89 or
  90 .Ar crypt .
  91 It's the same as the command line argument.
  92 .It high_vnodes
  93 Integer value.
  94 The upper limit of arlad's vnodes (think files and directories).
  95 .El
  96 .Sh SEE ALSO
  97 .Xr AliasDB 5 ,
  98 .Xr CellServDB 5 ,
  99 .Xr DynRootDB 5 ,
 100 .Xr ThisCell 5 ,
 101 .Xr arlad 8