xfnw/plan9fox
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

add cwfs(4) manpage

Browse source
This commit is contained in:
cinap_lenrek 2011-04-14 14:00:46 +00:00
parent c0c6fcee32
commit bbcfae7fc5
1 changed files with 38 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

53
sys/man/4/cwfs
View file

@ -4,15 +4,17 @@ cwfs \- cached-worm file server, dump
.SH SYNOPSIS .SH SYNOPSIS
.B cwfs .B cwfs
[ [
.B -cf .B -csC
] [ ] [
.B -a .B -a
.I announce-string .I announce-string
] ... [ ] ... [
.B -m .B -m
.I device-map .I device-map
] ] [
.B -f
.I config-device .I config-device
]
.SH DESCRIPTION .SH DESCRIPTION
.I Cwfs .I Cwfs
is a cached-worm file server that runs is a cached-worm file server that runs
@ -46,11 +48,21 @@ in order to be compatible with some existing file systems, notably
These parameters can be changed by recompilation. These parameters can be changed by recompilation.
.PP .PP
.I Cwfs .I Cwfs
expects to find the configuration block on places its server 9P connaction in
.IR config-device . .BI /srv/ name\f1
and its command pipe in
.BI /srv/ name\f1 .cmd,
where
.I name
is the service name.
.PP .PP
Options are: Options are:
.TF -m .TP
.B -f
specify
.IR config-device
other than the default
.LR /dev/sdC0/cwfs .
.TP .TP
.B -a .B -a
announce on announce on
@ -58,7 +70,7 @@ announce on
instead of instead of
.LR tcp!*!9fs . .LR tcp!*!9fs .
.TP .TP
.B -c .B -C
use a newer, faster, and incompatible cache-device layout. use a newer, faster, and incompatible cache-device layout.
To convert an old file system's cache to the new layout, To convert an old file system's cache to the new layout,
dump the file system, note the last superblock number, dump the file system, note the last superblock number,
@ -67,18 +79,23 @@ halt
restart restart
.I cwfs .I cwfs
with with
.BR -cf , .BR -cC ,
.I recover .I recover
the file system, and start the file system, and start
.I cwfs .I cwfs
with with
.B -c .B -C
thereafter. thereafter.
.TP .TP
.B -f .B -c
enter the file server's configuration mode enter the file server's configuration mode
before starting normal operation. before starting normal operation.
.TP .TP
.B -s
Post file descriptor zero in
.BI /srv/ service
and read and write protocol messages on file descriptor one.
.TP
.B -m .B -m
the file the file
.I device-map .I device-map
@ -224,6 +241,18 @@ and
(see (see
.IR auth/wrkey ). .IR auth/wrkey ).
.PP .PP
Files can be used directly as wren devices by giving
a file name rooted at
.I /
or using double or single quotes. Such a file name
can be appended to the
.L w
device instead of specifying
.L target
and
.L lun
numbers.
.PP
.IR fs (4)'s .IR fs (4)'s
device names device names
.L h .L h
@ -288,7 +317,6 @@ ls -lp /n/dump/1992/02??/mips/bin/vc | uniq
.IR yesterday (1), .IR yesterday (1),
.IR fs (3), .IR fs (3),
.IR sd (3), .IR sd (3),
.IR fossil (4),
.IR fs (4), .IR fs (4),
.IR srv (4), .IR srv (4),
.IR fs (8), .IR fs (8),
@ -310,8 +338,3 @@ deciding which to serve by sniffing the first packet on each connection.
.PP .PP
File system block size and disk address size (32- or 64-bit) are fixed File system block size and disk address size (32- or 64-bit) are fixed
at compilation time, and this is not easily changed. at compilation time, and this is not easily changed.
.PP
.I Cwfs
is probably not the right choice of file server for new file systems.
It's intended to cope with existing file systems on optical jukeboxes
or images thereof.