CVSFS(4) CVSFS(4)
NAME
cvsfs - cvs repository viewer
SYNOPSIS
cvsfs [ -Ddabv ] [ -s srv ] [ -k keyp ] [ -m mntpnt ]
[:method:[user@]]host:/root module
DESCRIPTION
Cvsfs creates a readonly view of a remote CVS repository
module. Two views are presented onto the repository, one
indexed by date - similar to venti(1)'s dump filesystem, the
other indexed by tag name. A special tag directory HEAD
conatins most up-to-date view of the repository. The file
Changelog at the top level contains an auto-generated can-
nonical history of the changes to the module.
File metadata is only filled in when the file is first read.
A file's owner is the author of the last change, and its
group is the name of the locker of the file or unlocked if
none, the last modifier's ID is the CVS release number.
Empty directories are not stored by CVS and thus are not
listed.
The options are:
-v Display server version string and some stats at
startup. (See BUGS below)
-a -b
The same after and before options as documented in
mount(1).
-D 9P request debug.
-d CVS protocol debug.
-m mntpnt
set the mount point for the remote filesystem; the
default is /n/cvs.
-k keyparam
lists extra parameters which will be passed to facto-
tum(4) to remove key ambiguity.
-s srvname
set the mount point for the published /srv file the
default is not to publish a /srv file.
method
CVS has allows several methods for attaching to
servers, cvsfs only :ext: and :pserver: are supported.
CVSFS(4) CVSFS(4)
The :ext method attempts to use ssh(1), cpu(1) rx(1) in
that order.
username
the username to attach as.
host the name of the machine to attach to.
cvsroot
the path to the root of the CVS filesystem on the
remote machine.
module
The name of the module on the remote server
BUGS
No support for Kerberos GSSAPI authentication - the
:gserver: method.
All files are read (checked out) on demand. Files not
accessed for 10 mins have their contents flushed. The CVS
server rembembers which files have been checked out and
refuses to resend these. As a result we must disconnect &
reconnect on each read→idle→reread cycle. This is handled by
cvsfs but may cause a delay on open(2).
cvsfs relies on parsing CVS rlog data to build its knowledge
of the tree, This data is designed to be human readable and
is thus liable to change between CVS server versions, though
the authors of CVS do endevour not to change it needlessly.
The -v option causes a CVS ver request to be sent. This can
cause some servers (E.G those used by sourceforge) to abort
with the error Terminated with fatal signal 11; do not use
the -v option with such servers.
Cvsfs has currently (Feb-05) been tested with cvs V1.12.9
and V1.11.1p1.