CFVADMIN

DESCRIPTION

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.

OPTIONS

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.

GLOBAL OPTIONS

These are the global options to cfvadmin

-h, --help

Show summary of options.

--version

Show the version of the program and copyright information.

--local

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

--rtype: Selects the repository type: either sqlite or postgresql.
--rdata: 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=...".

--remote

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:

create: Creates a new area in the repository.
info: Shows informations about the repository, like number of area present, the number of items in each area, etc.
init: Initialises the repository and create the first area. Warning:This command is destructive, erasing all your versioned information. Be careful!

CFVADMIN COMMANDS

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

create

create [-dDESCRIPTION] [-pROOTPATH] {ITEM}

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.

info

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

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.

BUGS

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).

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.