ref: bbcfae7fc557fc786cf2a8365ff9bb26aab8bd3a
parent: c0c6fcee3211275d841bde7b3dbd8e99f41e80ef
author: cinap_lenrek <cinap_lenrek@centraldogma>
date: Thu Apr 14 10:00:46 EDT 2011
add cwfs(4) manpage
--- a/sys/man/4/cwfs
+++ b/sys/man/4/cwfs
@@ -4,7 +4,7 @@
.SH SYNOPSIS
.B cwfs
[
-.B -cf
+.B -csC
] [
.B -a
.I announce-string
@@ -11,8 +11,10 @@
] ... [
.B -m
.I device-map
-]
+] [
+.B -f
.I config-device
+]
.SH DESCRIPTION
.I Cwfs
is a cached-worm file server that runs
@@ -46,12 +48,22 @@
These parameters can be changed by recompilation.
.PP
.I Cwfs
-expects to find the configuration block on
-.IR config-device .
+places its server 9P connaction in
+.BI /srv/ name\f1
+and its command pipe in
+.BI /srv/ name\f1 .cmd,
+where
+.I name
+is the service name.
.PP
Options are:
-.TF -m
.TP
+.B -f
+specify
+.IR config-device
+other than the default
+.LR /dev/sdC0/cwfs .
+.TP
.B -a
announce on
.I announce-string
@@ -58,7 +70,7 @@
instead of
.LR tcp!*!9fs .
.TP
-.B -c
+.B -C
use a newer, faster, and incompatible cache-device layout.
To convert an old file system's cache to the new layout,
dump the file system, note the last superblock number,
@@ -67,18 +79,23 @@
restart
.I cwfs
with
-.BR -cf ,
+.BR -cC ,
.I recover
the file system, and start
.I cwfs
with
-.B -c
+.B -C
thereafter.
.TP
-.B -f
+.B -c
enter the file server's configuration mode
before starting normal operation.
.TP
+.B -s
+Post file descriptor zero in
+.BI /srv/ service
+and read and write protocol messages on file descriptor one.
+.TP
.B -m
the file
.I device-map
@@ -224,6 +241,18 @@
(see
.IR auth/wrkey ).
.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
device names
.L h
@@ -288,7 +317,6 @@
.IR yesterday (1),
.IR fs (3),
.IR sd (3),
-.IR fossil (4),
.IR fs (4),
.IR srv (4),
.IR fs (8),
@@ -310,8 +338,3 @@
.PP
File system block size and disk address size (32- or 64-bit) are fixed
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.