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 con-
       figuration 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 post-
                 gresql 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
                 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

SEE ALSO

       cfv(1), cfvadmin(1), cfversd(1), cfversd.conf(5), cfvers user manual