cfvadmin -- cfvers command line administration tool


cfvadmin [global_options] {command} [command_options] [command_arguments]

cfvadmin [--version]

cfvadmin [--help]


This manual page documents briefly the cfvadmin command, version 0.5.4.

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

cfvadmin is the command-line administration tool used to initialise repositories, add and remove areas in them, etc.


These options follow the usual GNU command line syntax, with long options starting with two dashes (`-'). cfvadmin has two classes of options: global options and command options.


These are the global options to cfvadmin

-h, --help

Show summary of options.


Show the version of the program and copyright information.


Connect directly to the repository, in contrast to connecting through the cfversd server. When selecting this option, you can specify the repository through:


Selects the repository type: either sqlite or postgresql.


The connection info for the repository; this is repository-dependent. For sqlite it is a file name; for postgresql, a string of the form "dbname=mydb user=myuser password=mypw host=...".


Connects through a cfversd server. When selecting this option, you can also give the connection details directly in the command line:

-s, --server HOSTNAME

The name or address of the server.

-p, --port PORT

The port on which the server is listening.

-u, --username USER

The username used for authentication to the server

Note that unless you put in the configuration file (~/.cfvers) the password for the client and server or in the environment, you will be prompted for them.

cfvadmin command summary

Here are the brief descriptions of the cfvadmin commands:


Creates a new area in the repository.


Shows informations about the repository, like number of area present, the number of items in each area, etc.


Initialises the repository and create the first area. Warning:This command is destructive, erasing all your versioned information. Be careful!


Here are details on all the cfvadmin commands and the options each accepts.



Creates a new area in the repository. The area name is mandatory and must be given as the first and only argument. Additional properties of the area can be specified using:

  • -dDESCRIPTION - the area description. Defaults to none.

  • -pROOTPATH - the root path of this area. Defaults to /, and could be useful for chroots or individual user backups.


Shows informations about the repository. This is an example output:

	  Local repository has 2 area(s)
	  Name: default
	  Created at 2003-10-18 12:42:29 EET
	  Root path: /
	  Description: Default area
	  Revision number: 3
	  Number of items: 3
	  ID #2
	  Name: test
	  Created at 2003-10-18 15:22:02 EET
	  Root path: /home/jdoe
	  Description: test area
	  Revision number: 1
	  Number of items: 1


init [--force] [--skip-data]

This command will initialise the selected repository. It will also initialise a default area, named "default", on the local server.

To reinitialize an already-existing repository, pass the --force option. This will drop the existing schema first (please ignore any errors which show up in this stage), and afterwards init the repository in the standard way.

To skip the area creation, pass the --skip-data option. This will only initialize the repository, without creating the default area, allowing you to create it later with customized properties.


There should be a command to modifiy the properties of an area.

There should be a command to delete an area (and all the items it contains).


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

cvs(1), svn(1)


This manual page was written by Iustin Pop

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.