.\"	$QNS: cvswrap.1,v 1.2 2001/12/26 20:55:05 bright Exp $
.Dd December 17, 2001
.Dt CVSWRAP 1
.Sh NAME
.Nm cvswrap
.Nd wrapper over cvs to enable fine grained access control to repositories
.Sh SYNOPSIS
.Nm
.Oo cvs options
.Oc
.Sh DESCRIPTION
.Nm cvswrap
is a program written to sit in front of cvs.
It provides an administrator with fine grained access over cvs repositories.
.Pp
On startup it determines the CVSROOT environment variable by way of command
line options, environment or by parsing the pserver command stream.
It then reads a config file
.Xr cvswrap.conf 5
to determine the which wrapper to execute.
.Pp
If the CVSROOT is not set or can not be determined then
.Xr cvs 1
will be executed normally.
.Pp
Typical usage for
.Nm cvswrap
is to use it to invoke a custom wrapper which may be setgid to
a special group in order to enforce ACLs over
.Xr cvs 1
operations.
.Sh INSTALLATION
To make this program work one should rename the installed
.Xr cvs 1
binary to /usr/bin/ncvs and install cvswrap in the location where
the
.Xr cvs 1
binary was.
.Sh BUGS
The default install of this program is not particulary helpful.
See the installation section for help.
.Sh "SEE ALSO"
.Xr cvswrap.conf 5 ,
.Xr cvs 1 ,
.Bl -tag -width <examplesdir>/accesscheck.c -compact
.It Pa <examplesdir>/accesscheck.c
.It Pa <examplesdir>/cvswrap.conf
.El
.Sh AUTHOR
Alfred Perlstein <alfred@freebsd.org>