ETCKEEPER(8)															      ETCKEEPER(8)

NAME

       etckeeper - store /etc in git, mercurial, bazaar, or darcs

SYNOPSIS

       etckeeper command [-d directory]

DESCRIPTION

       etckeeper  manages /etc be stored in a git, mercurial, bazaar, or darcs repository. By default each of the commands operates on /etc, but a
       different directory can be specified to operate on a clone of the /etc repository located elsewhere.

COMMANDS

       init   This initialises and sets up a git, mercurial, bazaar, or darcs repository (depending on the  VCS  setting  in  /etc/etckeeper/etck-
	      eeper.conf).  Typically  this  is  run in /etc once when starting to use etckeeper on a machine. It can also be used to initialise a
	      clone of the /etc repository located elsewhere.

       commit [message]
	      Commits all changes in /etc to the repository. A commit message can be specified. You may also use the underlying VCS to commit man-
	      ually.   (Note  that  etckeeper commit will notice if a user has used sudo or su to become root, and record the original username in
	      the commit.)

       pre-commit
	      This is called as a pre-commit hook. It stores metadata and does sanity checks.

       pre-install
	      This is called by apt's DPkg::Pre-Install-Pkgs hook, or by equivalent hooks of other package  managers.  It  allows  committing  any
	      uncommitted changes before packages are installed, upgraded, etc.

       post-install
	      This  is	called by apt's DPkg::Post-Invoke hook, or by equivalent hooks of other package managers. It commits changes made by pack-
	      ages into the repository. (You can also call this by hand after running dpkg by hand.)

       unclean
	      This returns true if the directory contains uncommitted changes.

       update-ignore [-a]
	      This updates the VCS ignore file. Content outside a "managed by etckeeper" block is not touched. This is generally run when  upgrad-
	      ing to a new version of etckeeper. (The -a switch will add a "managed by etckeeper" block if one is not present.)

       vcs subcommand [options ...]
	      You  can	use this to run any subcommand of the VCS that etckeeper is configured to run. It will be run in /etc. For example, "etck-
	      eeper vcs diff" will run "git diff", etc.

       uninit [-f]
	      This command DESTROYS DATA! It is the inverse of the init command, removing VCS information and etckeeper's own bookkeeping informa-
	      tion  from the directory. Use with caution. A typical use case would be to run etckeeper uninit, then modify etckeeper.conf to use a
	      different VCS, and then run etckeeper init. (The -f switch can be used to force uninit without prompting.)

FILES

       /etc/etckeeper/etckeeper.conf is the configuration file.

       /etc/etckeeper also contains directories containing the programs that are run for each of the above commands.

ENVIRONMENT VARIABLES

       ETCKEEPER_CONF_DIR path to configuration directory instead of default /etc/etckeeper.

SEE ALSO

       /usr/share/doc/etckeeper/README.gz

AUTHOR

       Joey Hess <joey@kitenet.net>

																      ETCKEEPER(8)