.TH "CFVERS.CONF" "5" 
.SH "NAME" 
cfvers.conf \(em cfvers.conf configuration file for the cfv/cfvadmin command line tools 
.SH "DESCRIPTION" 
.PP 
This manual page documents the \fB/etc/cfvers/cfvers.conf\fP and \fB~/.cfvers\fP configuration files for the \fBcfvers\fP system version 0.5.4. 
.PP 
\fBcfvers\fP is a version control system designed for the management of configuration files in Unix-like operating systems.. 
.PP 
\fBcfvers.conf\fP is the configuration file for the command-line clients \fBcfv\fR and \fBcfvadmin\fR. 
.PP 
The filename structure is that of an .ini file (it's parsed by Python's ConfigParser module): 
 
.PP 
.nf 
[section1] 
key1=value1 
key2=value2 
[section2] 
.fi 
 
.SS "Available sections" 
.PP 
The only available section is \fBserver\fR. It hols the configuration data needed for connecting to the server. 
.SS "server section keys" 
.PP 
The \fBarea\fP key selects the default area to work on after connecting to the repository. 
.PP 
The \fBserver_type\fP key selects between the two kinds of servers in \fBcfvers\fP: \fIlocal\fR server (in-process) and \fIremote\fR server (through Pyro remote objects). Examples: 
 
.PP 
.nf 
[server] 
server_type=local 
.fi 
or:  
.PP 
.nf 
[server] 
server_type=remote 
.fi 
 
.SS "Local server configuration" 
.PP 
In a local server configuration, there are only two items to configure: the repository type and the connect information: 
 
.IP "repo_meth" 10 
This is the repository type. Currently, the \fBsqlite\fP and \fBpostgresql\fP options are available. 
.IP "repo_data" 10 
This is the connect information and depends on the repository type. For sqlite, it is the name of a (writeable) file. For postgresql, it is the connect information to the database, in the following format: \f(CWdbname=\fImydb\fR user=\fImyuser\fR password=\fImypassword\fR...\fP. The available keys/value pairs are: 
 
.RS 
.IP "dbname" 10 
the name of the database to connect to (required); 
.IP "user" 10 
the username to use when connecting to the database; not required (in which case the connection will use your login name); 
.IP "password" 10 
the password for the database; not required if you use the \fBtrust\fP authentication method; 
.IP "host" 10 
the IP address or name of the database server; if not given, the connection will be on localhost through UNIX sockets; 
.RE 
For more options possible, please consult the Postgresql documentation. 
 
.SS "Remote server configuration" 
.PP 
The remote server configuration is more complex. The possible values are: 
 
.IP "host" 10 
the hostname or ip address of the machine on which the \fBcfversd\fR server is running; 
.IP "port" 10 
the port number on which the server is listening; 
.IP "username" 10 
the username used to connect; 
.IP "client_password" 10 
the password used to authenticate (the client) to the server; 
.IP "server_password" 10 
the password used to authenticate the server (to the client);        
.SH "EXAMPLES" 
.SS "Local server with sqlite" 
.PP 
.nf 
[server] 
server_type=local 
repo_meth=sqlite 
repo_data=/path/to/file.db 
area=default 
.fi 
.SS "Local server with postgresql" 
.PP 
.nf 
[server] 
server_type=local 
repo_meth=postgresql 
repo_data=dbname=mydb user=myuser password=mypass 
area=default 
.fi 
.SS "Remote server" 
.PP 
.nf 
[server] 
server_type=remote 
host=192.168.0.1 
port=9999 
username=user1 
client_password=cpw 
server_password=spw 
area=default 
.fi 
.SH "SEE ALSO" 
.PP 
\fBcfv\fP\fB(1)\fP, 
\fBcfvadmin\fP\fB(1)\fP, 
\fBcfversd\fP\fB(1)\fP, 
\fBcfversd.conf\fP\fB(5)\fP, 
\fIcfvers user manual\fP      
.PP 
\fBcvs\fP\fB(1)\fP, 
\fBsvn\fP\fB(1)\fP      
.SH "AUTHOR" 
.PP 
This manual page was written by Iustin Pop iusty@k1024.org  
.PP 
The manual pages \fBcvs\fP\fB(1)\fP and \fBsvn\fP\fB(1)\fP were used as sources of inspiration (and copy-paste in some cases), since these are real versioning programs :\-), with proper man pages. 
 
.\" created by instant / docbook-to-man, Sun 30 Oct 2005, 13:21