(cvs.info.gz) The connection method
Info Catalog
(cvs.info.gz) Server requirements
(cvs.info.gz) Remote repositories
(cvs.info.gz) Connecting via rsh
2.9.2 The connection method
---------------------------
In its simplest form, the METHOD portion of the repository string
( Remote repositories) may be one of `ext', `fork', `gserver',
`kserver', `local', `pserver', and, on some platforms, `server'.
If METHOD is not specified, and the repository name starts with a
`/', then the default is `local'. If METHOD is not specified, and the
repository name does not start with a `/', then the default is `ext' or
`server', depending on your platform; both the `ext' and `server'
methods are described in Connecting via rsh.
The `ext', `fork', `gserver', and `pserver' connection methods all
accept optional method options, specified as part of the METHOD string,
like so:
:METHOD[;OPTION=ARG...]:OTHER_CONNECTION_DATA
CVS is not sensitive to the case of METHOD or OPTION, though it may
sometimes be sensitive to the case of ARG. The possible method options
are as follows:
`proxy=HOSTNAME'
`proxyport=PORT'
These two method options can be used to connect via an HTTP tunnel
style web proxy. HOSTNAME should be the name of the HTTP proxy
server to connect through and PORT is the port number on the HTTP
proxy server to connect via. PORT defaults to 8080.
server - please see Write proxies for more on CVS write
proxies.*
For example, to connect pserver via a web proxy listening on port
8000 of www.myproxy.net, you would use a method of:
:pserver;proxy=www.myproxy.net;proxyport=8000:PSERVER_CONNECTION_STRING
*NOTE_ In the above example, PSERVER_CONNECTION_STRING is still
required to connect and authenticate to the CVS server, as noted
in the upcoming sections on password authentication, `gserver', and
`kserver'. The example above only demonstrates a modification to
the METHOD portion of the repository name.*
These options first appeared in CVS version 1.12.7 and are valid as
modifcations to the `gserver' and `pserver' connection methods.
`CVS_RSH=PATH'
This method option can be used with the `ext' method to specify
the path the CVS client will use to find the remote shell used to
contact the CVS server and takes precedence over any path
specified in the `$CVS_RSH' environment variable ( Connecting
via rsh). For example, to connect to a CVS server via the local
`/path/to/ssh/command' command, you could choose to specify the
following PATH via the `CVS_RSH' method option:
:ext;CVS_RSH=/path/to/ssh/command:EXT_CONNECTION_STRING
This method option first appeared in CVS version 1.12.11 and is
valid only as a modifcation to the `ext' connection method.
`CVS_SERVER=PATH'
This method option can be used with the `ext' and `fork' methods to
specify the path CVS will use to find the CVS executable on the
CVS server and takes precedence over any path specified in the
`$CVS_SERVER' environment variable ( Connecting via rsh).
For example, to select the remote `/path/to/cvs/command'
executable as your CVS server application on the CVS server
machine, you could choose to specify the following PATH via the
`CVS_SERVER' method option:
:ext;CVS_SERVER=/path/to/cvs/command:EXT_CONNECTION_STRING
or, to select an executable named `cvs-1.12.11', assuming it is in
your `$PATH' on the CVS server:
:ext;CVS_SERVER=cvs-1.12.11:EXT_CONNECTION_STRING
This method option first appeared in CVS version 1.12.11 and is
valid as a modifcation to both the `ext' and `fork' connection
methods.
`Redirect=BOOLEAN-STATE'
The `Redirect' method option determines whether the CVS client will
allow a CVS server to redirect it to a different CVS server,
usually for write requests, as in a write proxy setup.
A BOOLEAN-STATE of any value acceptable for boolean
`CVSROOT/config' file options is acceptable here ( config).
For example, `on', `off', `true', and `false' are all valid
values for BOOLEAN-STATE. BOOLEAN-STATE for the `Redirect' method
option defaults to `on'.
This option will have no effect when talking to any non-secondary
CVS server. For more on write proxies and secondary servers,
please see Write proxies.
This method option first appeared in CVS version 1.12.11 and is
valid only as a modifcation to the `ext' connection method.
As a further example, to combine both the `CVS_RSH' and `CVS_SERVER'
options, a method specification like the following would work:
:ext;CVS_RSH=/path/to/ssh/command;CVS_SERVER=/path/to/cvs/command:
This means that you would not need to have the `CVS_SERVER' or
`CVS_RSH' environment variables set correctly. See Connecting
via rsh, for more details on these environment variables.
Info Catalog
(cvs.info.gz) Server requirements
(cvs.info.gz) Remote repositories
(cvs.info.gz) Connecting via rsh
automatically generated byinfo2html