blob: e7f6d37861980c9e2b06787869126bddc0ee13ef (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
.TH CFS 4
.SH NAME
cfs \- cache file system
.SH SYNOPSIS
.B cfs
.B -s
.RB [ -rdS ]
.RB [ -f
.IR partition ]
.PP
.B cfs
.B -a
.I netaddr
.RB [ -rdS ]
.RB [ -f
.IR partition ]
.RI [ mtpt ]
.SH DESCRIPTION
.I Cfs
is a user-level file server that caches information about remote
files onto a local disk.
It is normally started by the kernel at boot time, though users may start
it manually.
.I Cfs
is interposed between the kernel and a network connection to a
remote file server to improve the
efficiency of access across slow network connections such as modem
lines.
On each open of a file
.I cfs
checks the consistency of cached information and discards any old
information for that file.
.PP
.I Cfs
mounts onto
.I mtpt
(default
.BR / )
after connecting to the file server.
.PP
The options are:
.TP
.B s
the connection to the remote file server is on file
descriptors 0 and 1.
.TP
.BI "a " netaddr
dial the destination
.I netaddr
to connect to a remote file server.
.TP
.B r
reformat the cache disk partition.
.TP
.B d
turn on debugging.
.TP
.B S
turn on statistics gathering. A file called
.B cfsctl
at the root of the caching file system can be read to get
statistics concerning number of calls/bytes on client and server
sides and latencies.
.TP
.BI "f " partition
use file
.I partition
as the cache disk partition.
.PP
All 9P messages except
.BR read ,
.BR clone ,
and
.B walk
(see
.IR intro (5))
are passed through
.I cfs
unchanged to the remote server.
A
.B clone
followed immediately by a
.B walk
is converted into a
.BR clwalk .
If possible, a
.B read
is satisfied by cached data.
Otherwise, the file server is queried for any missing data.
.SH FILES
.TP
.B /dev/sdC0/cache
Default file used for storing cached data.
.SH SOURCE
.B /sys/src/cmd/cfs
|
