1VENUS(8) VENUS(8)
2
6 venus - Coda client cache manager
7
9 venus [ -k kernel device ] [ -cf cache files ] [ -c cache blocks ] [
10 -mles CML entries ] [ -d debuglevel ] [ -rpcdebug rpc2 debuglevel ] [
11 -f cache directory ] [ -m COP modes ] [ -console console file ] [
12 -retries RPC2 retries ] [ -timeout RPC2 timeout ] [ -ws SFTP window
13 size ] [ -sa SFTP sendahead ] [ -ap SFTP ackpoint ] [ -init ] [ -hdbes
14 hoard entries ] [ -rvmt RVM type ] [ -maxprefetchers fetch threads ] [
15 -maxworkers worker threads ] [ -maxcbservers callback threads ] [ -vld
16 RVM log device ] [ -vlds RVM log size ] [ -vdd RVM data device ] [
17 -vdds RVM data size ] [ -rdscs RVM data chunk size ] [ -rdsnl RVM data
18 nr lists ] [ -logopts 0 | 1 ] [ -swt weight ] [ -mwt weight ] [ -ssf
19 scale factor ]
20
23 venus manages a cache of files and directories for a client worksta‐
24 tion. It has a host of parameters and configuration options. Default
25 values of everything are compiled into venus. Some of these are over‐
26 ridden by the values in the venus.conf file, provided that it exists.
27 Both default and venus.conf values may be overridden with command-line
28 arguments. Venus must be run as root.
29 The command-line options are:
31 -k Take kernel device to be the device for kernel/venus communica‐
33 tion.
34 Default: /dev/cfs0
36 -cf Limit the size of the file cache to cache files entries.
38 -c Limit the size of the file cache to cache blocks 1K blocks.
40 -mles Number of Client Modification Log entries.
42 -vols Limit the size of the volume cache to volumes entries.
44 -vsgs Limit the size of the VSG cache to vsgs entries.
46 -d Initialize the debug level to debug level.
48 Default: 0
50 -f Take cache directory to be the directory for the file, volume,
52 and VSG caches. On some platforms venus garbage collects any
53 files it doesnt recognize in the cache directory so use caution
54 when supplying this argument.
55 Venus will create the directory if it doesnt already exist. The
57 directory should have mode bits of rwx------ to protect the
58 cache from malicious local users.
59 Default: /usr/coda/venus.cache
61 -m Controls what Coda Optimistic Protocol (COP) options are
63 enabled. COP modes is interpreted according to the following
64 bit-mask: [ PIGGYCOP2 | ASYNCCOP2 | ASYNCCOP1 ]. Only some com‐
65 binations are legal.
66 Default: [ PIGGYCOP2 | ASYNCCOP2 ]
68 -console
70 Redirects console messages to console file.
71 Default: /dev/console
73 -retries
75 Sets the number of RPC2 retries to RPC2 retries.
76 Default: 5
78 -timeout
80 Sets the RPC2 timeout period to RPC2 timeout seconds.
81 Default: 15
83 -ws Sets the SFTP window size to SFTP window size packets.
85 Default: 8
87 -sa Sets the SFTP send ahead to SFTP send ahead packets.
89 Default: 4
91 -ap Sets the SFTP ack point to SFTP ack point packets.
93 Default: 4
95 -init Initializes (i.e., clears) file, volume, and VSG caches.
97 -hdbes Number of hoard database entries.
99 -rvmt Media that RVM resides on. Meaningful values are: 2 (use a file
101 to persistently back RVM memory) and 3 (do not use a file as RVM
102 backing store, no persistency).
103 -maxprefetchers
105 Maximum number of threads doing prefetch ioctls.
106 -maxworkers
108 Number of worker threads.
109 -maxcbservers
111 Number of callback server threads.
112 -vld Location of the venus log file or partition.
114 Default: /usr/coda/LOG
116 -vlds Size of the log file or partition.
118 -vdd Location of the venus data file or partition.
120 Default: /usr/coda/DATA
122 -vdds Size of the data file or partition.
124 -rdscs Specify RDS chunk size.
126 -rdsnl Number of RDS nlists.
128 -logopts
130 Turn on log optimization.
131 -swt Short term cache priority weight.
133 -mwt Medium term cache priority weight.
135 -ssf Short term cache scale factor.
137 Default: /coda
139
141 Venus writes debugging information into the file cache direc‐
142 tory/venus.log. The verbosity of this output is controlled by the debug
143 level parameter. High priority messages are also written to the con‐
144 sole (which may be redirected with the console option at start-up).
145 Fatal errors will cause the internal state of venus to be dumped to the
146 log file, and a core file to be left in cache directory/core.
147 Venus writes its process id into the file cache directory/pid. The
149 vutil(8) program reads the pid file and dynamically alter Venus behav‐
150 ior by sending signals to it.
151 Venus may be unable to unmount itself cleanly when it exits. Usually
153 this is due to processes which have references to vnodes in the Coda
154 namespace (e.g., a process is cd'ed somewhere in Coda). Once these
155 references are released, /coda can be unmounted.
156
158 venus.conf, vutil(8)
159
161 · Jay Kistler, 1990, Created
162 · Joshua Raiff, 1993, Documented added switches
164Coda Distributed File System 25 April 2005 VENUS(8)