1CFS(1) CFS(1)
2
6 cfs - Coda File System Interface Program
7
9 cfs adaptive|strong
10 cfs beginrepair file
13 cfs checkpointml
16 cfs checkservers
19 cfs checkvolumes
22 cfs clearpriorities
25 cfs @cpu|@sys
28 cfs endrepair file
31 cfs examineclosure
34 cfs flushcache
37 cfs flushobject path [ path ... ]
40 cfs flushvolume path [ path ... ]
43 cfs getfid path [ path ... ]
46 cfs getpath fid [ fid ... ]
49 cfs getmountpoint volid
52 cfs listacl dir [ dir ... ]
55 cfs listcache dir [ dir ... ]
58 cfs listvol dir [ dir ... ]
61 cfs lsmount dir [ dir ... ]
64 cfs mkmount directory [ volumename ]
67 cfs purgeml
70 cfs replayclosure
73 cfs rmmount dir [ dir ... ]
76 cfs setacl [ -clear ] [ -negative ] dir id rights [ id rights ... ]
79 cfs truncatelog
82 cfs waitforever [ -on ] [ -off ]
85 cfs whereis dir [ dir ... ]
88 cfs disconnect
91 cfs reconnect
94 cfs writedisconnect [ -age secs ] [ -time secs ] dir
97 cfs writereconnect
100
103 cfs allows users to perform operations specific to the Coda File Sys‐
104 tem. Most often, people use it to see how much of their allocated
105 storage space they are currently using and to change the protection on
106 their personal directories. cfs will change the protection or "rights"
107 on directories but not on individual files. To change permissions on
108 individual files, use chmod(1).
109 adaptive|strong
111 Use `strong' to override adaptation to changing network condi‐
112 tions. Revert to automatic adaptation using `adaptive'. This
113 command is useful to force strong connectivity semantics even
114 over slow or unreliable links.
115 checkpointml
117 Checkpoint volume modify log. This command will create a check‐
118 point file /usr/coda/spool/uid/vol@mountpt. Where uid is your
119 local user id, vol is the volume being checkpointed, and mountpt
120 is the volume's mount point.
121 Abbreviation: ck.
123 checkservers
125 Check the status of the Coda file servers. Report on servers
126 that are down.
127 checkvolumes
129 Check volume/name mappings.
130 clearpriorities
132 Clear short-term priorities used for cache management.
133 @cpu|@sys
135 When the end of a pathname component in a symlink is either @sys
136 or @cpu, the local venus will replace these magic strings with a
137 platform dependent string. These cfs commands can be used to
138 check what the precise expansion values depending on the current
139 OS/cpu.
140 beginrepair
142 Tell venus to expand a conflict. The dangling symlink becomes a
143 directory that contains readonly copies of all the versions of
144 the object as found on the various replicas.
145 Abbreviation: br.
147 endrepair
149 Tell venus to end a repair session on file. Useful if repair is
150 exits without finishing the repair session.
151 Abbreviation: er.
153 examineclosure
155 Examine reintegration closure. Using cfs examineclosure will
156 display the fixfile used to reintegrate changes that were made
157 while operating in disconnected mode.
158 Abbreviation: ec
160 flushcache
162 Flush entire cache. Care must be taken when using the cfs
163 flushcache command, as flushing the cache while operating in
164 disconnected mode may result in loss of data.
165 flushobject
167 Flush objects from cache. cfs flushobject tells venus to remove
168 the given objects from the cache.
169 Abbreviation: fl
171 flushvolume
173 Flush all data in specified volumes. Care must be taken when
174 using the cfs flushvolume command, as flushing the cache while
175 operating in disconnected mode may result in loss of data.
176 getfid Map the given paths to Coda file ids.
178 Abbreviation: gf
180 getpath
182 Map fid to volume-relative path. cfs getpath will display the
183 path for each of the given fids.
184 Abbreviation: gp
186 listacl
188 List access control list for each of the given directories.
189 Abbreviation: la
191 listcache
193 List the contents of the entire cache or the given volumes
194 (directories).
195 Abbreviation: lc
197 listvol
199 Display the current status of the volume in which the directory
200 is stored.
201 Abbreviation: lv
203 lsmount
205 List the countents of a mount point. This command can be used
206 to tell what volume a mount point refers to.
207 mkmount
209 Create a mount point. Mount volume name at the point in the
210 file system described by filename. If the volume name is not
211 specified, venus will try to mount a volume named based on the
212 path from the top of the realm to the mountpoint. For instance,
213 cfs mkmount /coda/coda.cs.cmu.edu/new will attempt to mount a
214 volume named /new.
215 Abbreviation: mkm
217 purgeml
219 Purge volume modify log. Care must be taken when using the cfs
220 purgeml command, as it may result in loss of data.
221 replayclosure
223 Replay reintegration closure.
224 Abbreviation: rc
226 rmmount
228 Remove a mount point from the file system. The volume itself is
229 not changed.
230 Abbreviation: rmm
232 setacl Set access control list. Sets the access control list for each
234 id. The -clear switch clears the access control list except for
235 the entries given on the call to cfs. The -negative switch
236 denies the given permissions, rather than granting them. Rights
237 are a subset of rwidlak which are read, write, insert, delete,
238 lookup, administer, and lock respectively. See the section on
239 File Protection in the Coda File System Users and System Admin‐
240 istrators Manual for more detail.
241 Abbreviation: sa
243 truncatelog
245 Truncate the RVM log at this instant.
246 Abbreviation: tl
248 waitforever
250 Tells venus whether it should wait forever for dead file servers
251 or not. By default, venus does not wait; it returns ETIMEDOUT.
252 For certain batch jobs, waiting is better than not waiting.
253 Abbreviation: wf
255 whereis
257 List the servers that the given files reside on.
258 disconnect
260 Partition your client from the Coda file servers.
261 reconnect
263 Reconnect to the Coda file servers. cfs reconnect will undo the
264 effects of a cfs disconnect.
265 writedisconnect
267 Tell venus to write disconnect on the given volumes, or all vol‐
268 umes if none are provided. Write disconnected operation will
269 fetch files from the server, but does not propagate changes back
270 immediately.
271 An -age argument gives the age of the CML before it should be
273 reintegrated. The -time arguments gives the number of seconds
274 the sending of a reintegration fragment should take.
275 Abbreviation: wd
277 writereconnect
279 Strongly connect to the servers.
280 Abbreviation: wr
282
284 chmod(1)
285
287 · 1987, Adapted from AFS-2s fs
288 · Maria R. Ebling, 1990, Created man page
290 · M. Satyanarayanan, 1992, cfs rewritten from scratch
292 · Joshua Raiff, 1993, Man page rewritten
294 · Joshua Raiff, 1995, Updated
296Coda Distributed File System 25 April 2005 CFS(1)