.TH "CFVERSD.CONF" "5" 
.SH "NAME" 
cfversd.conf \(em cfversd.conf configuration file for the cfversd daemon 
.SH "DESCRIPTION" 
.PP 
This manual page documents the \fB/etc/cfvers/cfversd.conf\fP configuration file 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 
\fBcfversd.conf\fP is the configuration file for the server \fBcfversd\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 available sections are \fBserver\fR, \fBrepository\fR, \fBauth\fR and the per-user \fBuser-NAME\fR, where NAME is the user's name. 
.SS "server section" 
.PP 
The \fBport\fP key selects the port number to listen on. 
.PP 
The \fBpidfile\fP key selects the filename into which to write the pid of the server. 
.SS "repository section" 
.PP 
The \fBmethod\fP key selects the driver for the repository. Currently defined are postgresql and sqlite. 
.PP 
The \fBconnect\fP key selects the driver-specific connection string. For example, for sqlite it is the filename into which to store the database. 
.SS "auth section" 
.PP 
The \fBusers\fP key is the only one valid and it contains a comma separated list of valid users. For each user, a separate \fBuser-NAME\fR section must exist, with NAME being the user's name in this list. 
.SS "user-NAME section" 
.PP 
The user-NAME sections each define a valid user togheter with its rights. 
.PP 
The \fBvalid_from\fP option contains the comma separated list of valid IP addresses. The list must contain only host ip addresses, without netmasks. 
.PP 
The \fBareas\fP option contains the comma separated list of valid areas for this user, if the user hasn't the \fBadmin\fP flag true. 
.PP 
The \fBadmin\fP boolean option specifies if this user is a regular user or an admin user. Only an admin user can create areas, and the admin users can access all areas. 
.PP 
The \fBclient_password\fP and \fBserver_password\fP key contain the client-to-server and server-to-client password. They can be the same thing or not. 
.SS "Postgresql driver" 
.PP 
For postgresql, the connect information to the database, is in the following format: \f(CWdbname=\fImydb\fR user=\fImyuser\fR password=\fImypassword\fR\fP. The available keys/value pairs are: 
 
.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; 	For more options possible, please consult the Postgresql documentation. 
 
.SS "Sqlite driver" 
.PP 
For sqlite, the connection data is simply a string containing a filename. In it the database will be written. 
 
.SH "EXAMPLES" 
.SS "server with sqlite" 
.PP 
.nf 
[server] 
port = 9999 
pidfile = /var/run/cfvers/cfversd.pid 
 
[repository] 
method=sqlite 
connect=/var/lib/cfvers/database 
 
[auth] 
users=user1 
 
[user_user1] 
client_password=cpw 
server_password=spw 
valid_from=127.0.0.1,192.168.0.2 
areas=default 
admin=true 
.fi 
.SS "server with postgresql" 
.PP 
.nf 
[server] 
port = 9999 
pidfile = /var/run/cfvers/cfversd.pid 
 
[repository] 
method=postgresql 
connect=dbname=mydb user=myuser password=mypass 
 
[auth] 
users=user1 
 
[user_user1] 
client_password=cpw 
server_password=spw 
valid_from=127.0.0.1,192.168.0.2 
areas=default 
admin=true 
.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