Update Debian packaging for 1.5.74
[openafs.git] / src / packaging / Debian / afs.conf
1 # -*- sh -*-
2 # Copyright 2000, International Business Machines Corporation and others.
3 # All Rights Reserved.
4
5 # This software has been released under the terms of the IBM Public
6 # License.  For details, see the LICENSE file in the top-level source
7 # directory or online at http://www.openafs.org/dl/license10.html
8
9 # Configuration information for AFS client.
10
11 # The following options are maintained by debconf.  To change them, run
12 # dpkg-reconfigure openafs-client.
13 #
14 #   AFS_CLIENT          Whether to start the AFS client at boot
15 #   AFS_AFSDB           Whether to use AFSDB DNS records to find VLDB servers
16 #   AFS_CRYPT           Whether to enable fcrypt encryption
17 #   AFS_DYNROOT         Whether to use a dynamic /afs directory
18 #   AFS_FAKESTAT        Whether to fake stat data for mount points
19
20 test -f /etc/openafs/afs.conf.client && . /etc/openafs/afs.conf.client
21
22 # Set to "-verbose" for a lot of debugging information from afsd.  Only useful
23 # for debugging as it prints a LOT of information.
24 VERBOSE=
25
26 # AFS client configuration options.
27 #
28 # Here is a (mostly) complete list of flags that afsd accepts and that are
29 # useful here:
30 #
31 #   -blocks     The number of blocks available in the workstation cache.
32 #   -files      The target number of files in the workstation cache (Default:
33 #               1000).
34 #   -rootvol    The name of the root volume to use.
35 #   -stat       The number of stat cache entries.
36 #   -hosts      List of servers to check for volume location info FOR THE
37 #               HOME CELL.
38 #   -memcache   Use an in-memory cache rather than disk.
39 #   -cachedir   The base directory for the workstation cache.
40 #   -mountdir   The directory on which the AFS is to be mounted.
41 #   -confdir    The configuration directory.
42 #   -nosettime  Don't keep checking the time to avoid drift (default).
43 #   -settime    Keep checking the time to avoid drift.
44 #   -verbose    Be chatty.
45 #   -debug      Print out additional debugging info.
46 #   -daemons    The number of background daemons to start (Default: 2).
47 #   -rmtsys     Also fires up an afs remote sys call (e.g. pioctl, setpag)
48 #               support daemon 
49 #   -chunksize  2^n is the chunksize to be used (Default: use a kernel
50 #               module default).
51 #   -dcache     The number of data cache entries.
52 #   -prealloc   Number of preallocated "small" memory blocks
53 #   -waitclose  Make close calls always synchronous (slows them down, though)
54 #   -files_per_subdir   Number of files per cache subdir (Default: 2048).
55 #
56 # Using the memory cache is not recommended.  It's less stable than the disk
57 # cache and doesn't improve performance as much as it might sound.
58 #
59 # The default behavior is to let afsd automatically choose an apporpriate set
60 # of flags.  This should produce reasonable behavior for most working sets
61 # provided that one is using a modern AFS client (1.4.2 or later).
62 #
63 # You can override that default behavior by setting OPTIONS to a specific set
64 # of flags.
65 OPTIONS=AUTOMATIC
66
67 # The default value for the client sysname (as returned by fs sysname) is
68 # determined during the kernel module build and is taken from the architecture
69 # and the major Linux kernel version.  Accesses to directories named "@sys" in
70 # AFS will be internally redirected to a directory by this name by the AFS
71 # client, allowing a single path to resolve to different directories depending
72 # on the client architecture.
73 #
74 # If you would like to override the client sysname, uncomment this line and
75 # set the variable to a space-separated list of sysnames.  The AFS client will
76 # attempt to resolve @sys to each directory name in the order given.
77 #AFS_SYSNAME=""
78
79 # If you want to prefer particular servers for replicated volumes, you can
80 # configure that by defining an afs_server_prefs function here and then
81 # uncommenting the setting of AFS_POST_INIT below.  For more information, see
82 # fs help setserverprefs and fs getserverprefs (for the current values).
83
84 #afs_server_prefs() {
85 #    fs setserverprefs <host> <rank>
86 #}
87
88 # If you want to always run some command after starting OpenAFS, you can put
89 # it here.  Note that you cannot run multiple commands, even combined with &&
90 # or ; or similar shell meta-characters.  If you want to run multiple
91 # commands, define a shell function instead and put the name of the shell
92 # function here.
93 AFS_POST_INIT=
94
95 # Uncomment this line if you defined an afs_server_prefs function.  (If you
96 # have other commands that you also want to run, you'll have to put them in
97 # that function, as you can only run one function.)
98 #AFS_POST_INIT=afs_server_prefs
99
100 # If you want to always run some command before shutting down OpenAFS, you can
101 # put it here.  The same caveat applies about multiple commands.
102 AFS_PRE_SHUTDOWN=
103
104 # If you are having problems with AFS shutting down cleanly or the system not
105 # rebooting because the partition the AFS cache was on could not be unmounted,
106 # try installing lsof and uncommenting this.  This will cause all processes
107 # with open AFS files to be killed before unmounting AFS if the runlevel being
108 # switched to is 0 or 6.
109 #
110 # Warning: This means /etc/init.d/openafs-client stop will kill all processes
111 # with files open in AFS rather than returning an error saying the file system
112 # is busy.  This is probably what you want when the whole system is shutting
113 # down, but often *not* what you want when just stopping and restarting the
114 # client.  The code doesn't run unless the runlevel is 0 or 6, but still, be
115 # sure that this is what you want before enabling it.
116 #AFS_PRE_SHUTDOWN=kill_all_afs