CFVERS.CONF

DESCRIPTION

This manual page documents the /etc/cfvers/cfvers.conf and ~/.cfvers configuration files for the cfvers system version 0.5.4.

cfvers is a version control system designed for the management of configuration files in Unix-like operating systems..

cfvers.conf is the configuration file for the command-line clients cfv and cfvadmin.

The filename structure is that of an .ini file (it's parsed by Python's ConfigParser module):

[section1]
key1=value1
key2=value2
[section2]

Available sections

The only available section is server. It hols the configuration data needed for connecting to the server.

server section keys

The area key selects the default area to work on after connecting to the repository.

The server_type key selects between the two kinds of servers in cfvers: local server (in-process) and remote server (through Pyro remote objects). Examples:

[server]
server_type=local

or:

[server]
server_type=remote

Local server configuration

In a local server configuration, there are only two items to configure: the repository type and the connect information:

repo_meth

This is the repository type. Currently, the sqlite and postgresql options are available.

repo_data

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: dbname=mydb user=myuser password=mypassword.... The available keys/value pairs are:

dbname: the name of the database to connect to (required);
user: the username to use when connecting to the database; not required (in which case the connection will use your login name);
password: the password for the database; not required if you use the trust authentication method;
host: 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.

Remote server configuration

The remote server configuration is more complex. The possible values are:

host: the hostname or ip address of the machine on which the cfversd server is running;
port: the port number on which the server is listening;
username: the username used to connect;
client_password: the password used to authenticate (the client) to the server;
server_password: the password used to authenticate the server (to the client);

EXAMPLES

Local server with sqlite

[server]
server_type=local
repo_meth=sqlite
repo_data=/path/to/file.db
area=default

Local server with postgresql

[server]
server_type=local
repo_meth=postgresql
repo_data=dbname=mydb user=myuser password=mypass
area=default

Remote server

[server]
server_type=remote
host=192.168.0.1
port=9999
username=user1
client_password=cpw
server_password=spw
area=default

AUTHOR

This manual page was written by Iustin Pop <iusty@k1024.org>

The manual pages cvs(1) and svn(1) were used as sources of inspiration (and copy-paste in some cases), since these are real versioning programs :-), with proper man pages.