vacfs

2 files changed, 89 insertions, 0 deletions

diff --git a/man/man4/INDEX b/man/man4/INDEX
index 407b7b0f..5e1583a9 100644
--- a/man/man4/INDEX
+++ b/man/man4/INDEX
@@ -5,3 +5,4 @@ acme acme.4
 import import.4
 plumber plumber.4
 ramfs ramfs.4
+vacfs vacfs.4
diff --git a/man/man4/vacfs.4 b/man/man4/vacfs.4
new file mode 100644
index 00000000..eae98a9d
--- /dev/null
+++ b/man/man4/vacfs.4
@@ -0,0 +1,88 @@
+.TH VACFS 4
+.SH NAME
+vacfs \- a Venti-based file system
+.SH SYNOPSIS
+.B vacfs
+[
+.B -dips
+]
+[
+.B -c
+.I cachesize
+]
+[
+.B -h
+.I host
+]
+.\" [
+.\" .B -m
+.\" .I mtpt
+.\" ]
+[
+.B -S
+.I srvname
+]
+.I vacfile
+.SH DESCRIPTION
+.I Vacfs
+interprets the file system created by
+.IR vac (1)
+so that it can be mounted into a Plan 9 file hierarchy.
+The data for the file system is stored on
+.IR venti (8)
+with a root fingerprint specified in
+.IR vacfile .
+.I Vacfs
+is currently rather limited: access is read-only,
+clients are not authenticated, and groups are assumed to
+contain a single member with the same name.
+These restrictions should eventually be removed.
+.PP
+Options to 
+.I vacfs
+are:
+.TP
+.BI -c " cachesize
+The number of file system blocks to cache in memory. The default is 1000 blocks.
+.TP
+.B -d
+Print debugging information to standard error.
+.TP
+.BI -h " host
+The network address of the Venti server.
+The default is taken from the environment variable
+.BR venti .
+If this variable does not exist, then the default is the
+metaname 
+.BR $venti ,
+which can be configured via
+.IR ndb (6).
+.TP
+.B -i
+Use file descriptors 0 and 1 as the 9P communication channel rather than create a pipe.
+.\" .TP
+.\" .BI -m " mtpt
+.\" The location to mount the file system. The default is
+.\" .BR /n/vac .
+.TP
+.BI -p
+Disables permission checking.
+.TP
+.B -s
+The name of the 9P service to post.
+The default is
+.BR vacfs. name \fR,
+where
+.I name
+is
+.I vacfile
+without any directory name or
+.L .vac
+extension.
+.PD
+.SH SOURCE
+.B \*9/src/cmd/vac
+.SH "SEE ALSO"
+.IR vac (1),
+Plan 9's \fIventi\fR(8)
+