backport to buster
[hcoop/debian/openafs.git] / 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 service 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