1.\"	$QNS: cvswrap.1,v 1.2 2001/12/26 20:55:05 bright Exp $
2.Dd December 17, 2001
3.Dt CVSWRAP 1
4.Sh NAME
5.Nm cvswrap
6.Nd wrapper over cvs to enable fine grained access control to repositories
7.Sh SYNOPSIS
8.Nm
9.Oo cvs options
10.Oc
11.Sh DESCRIPTION
12.Nm cvswrap
13is a program written to sit in front of cvs.
14It provides an administrator with fine grained access over cvs repositories.
15.Pp
16On startup it determines the CVSROOT environment variable by way of command
17line options, environment or by parsing the pserver command stream.
18It then reads a config file
19.Xr cvswrap.conf 5
20to determine the which wrapper to execute.
21.Pp
22If the CVSROOT is not set or can not be determined then
23.Xr cvs 1
24will be executed normally.
25.Pp
26Typical usage for
27.Nm cvswrap
28is to use it to invoke a custom wrapper which may be setgid to
29a special group in order to enforce ACLs over
30.Xr cvs 1
31operations.
32.Sh INSTALLATION
33To make this program work one should rename the installed
34.Xr cvs 1
35binary to /usr/bin/ncvs and install cvswrap in the location where
36the
37.Xr cvs 1
38binary was.
39.Sh BUGS
40The default install of this program is not particulary helpful.
41See the installation section for help.
42.Sh "SEE ALSO"
43.Xr cvswrap.conf 5 ,
44.Xr cvs 1 ,
45.Bl -tag -width <examplesdir>/accesscheck.c -compact
46.It Pa <examplesdir>/accesscheck.c
47.It Pa <examplesdir>/cvswrap.conf
48.El
49.Sh AUTHOR
50Alfred Perlstein <alfred@freebsd.org>
51