CVSPROXY(8)					      CVSPROXY(8)



NAME
       cvsproxy - cvs pserver proxy server

SYNOPSIS
       cvsproxy [option...]

DESCRIPTION
       cvsproxy  is  a relay server for the cvs pserver protocol.
       It runs as a child process of inetd.

       To use cvsproxy, you don't have to update or  change  your
       cvs client.  Suppose that the remote repository name is:

	     :pserver:me@cvs.example.org:2401/cvsroot

       and  that cvsproxy is running on the host `relay'.  To use
       cvsproxy, tell your cvs client the repository name is:

	     :pserver:me%cvs.example.org@relay:2401/cvsroot

       When your client accesses the repository, it establishes a
       connection  with  `relay',  instead  of `cvs.example.org'.
       Then, cvsproxy running on `relay' forwards the connection
       to  `cvs.example.org',  so  that it  behaves  as the  cvs
       server on `cvs.example.org' toward your client.

       If port number is not  specified  by  a	repository  name,
       cvsproxy  uses the destination port number of the TCP con-
       nection between the client and cvsproxy.

       The following options are available:

       -4, --ipv4
	      Forces cvsproxy to use IPv4 addresses for a connec-
	      tion with a CVS server.

       -6, --ipv6
	      Forces cvsproxy to use IPv6 addresses for a connec-
	      tion with a CVS server.  This option  is	available
	      only if cvsproxy has been configured with IPv6 sup-
	      port.

       -l facility, --syslog-facility facility
	      Specifies syslog faicility.  cvsproxy writes infor-
	      mation messages using syslog.  The default facility
	      is daemon.  If an error occurs before parsing  com-
	      mand  line  arguments  has been completed, cvsproxy
	      writes error message with facility daemon.

       -t seconds, --timeout seconds
	      Sets the inactivity timeout period to seconds.  The
	      default is 90.

SETTING UP CVSPROXY
       If  the	service  name  data  base on your system (usually
       `/etc/services') lacks  `cvspserver',  add  the	following
       line:

	     cvspserver  2401/tcp

       If your system is using traditional inetd, add a line like
       as below to  the  configuration	file  of  inetd  (usually
       `/etc/inetd.conf'):

	     cvspserver stream tcp nowait nobody \
	       /usr/local/libexec/cvsproxy cvsproxy [option...]

       If your system is  using  xinetd  instead  of  traditional
       inetd, add an entry like as follows to the xinetd configu-
       ration file:

	     service cvspserver
	     {
		socket_type  = stream
		wait	     = no
		user	     = nobody
		server	     = /usr/local/libexec/cvsproxy
		server_args  = [option...]
	     }

       where `nobody' is a name of less privileged  user,  widely
       used in UNIX derived systems.

SEE ALSO
       cvs(1),	  inetd.conf(5),   services(5),   syslog.conf(5),
       inetd(8), xinetd(8), syslogd(8)



						      CVSPROXY(8)