EPITOOL(1)                 OpenBSD Reference Manual                 EPITOOL(1)

NAME
     epitool - backend maintenance

SYNOPSIS
     epitool [-h] [-c command] [-D backend_name] [-N hostname] [-S hostport]
             [-T backend_type] [-U user]

DESCRIPTION
     The epitool command issues maintenance commands to the backend.

     The following flag must be present:

     -c      Issue specified command.  Currently supported commands are: df,
             du, fsck, and recreate

     In addition to the flags mentioned above, any of the following flags may
     be used:

     -D backend_name
             Depending on the backend_type this value is the identifier of the
             backend.  For example for the file type, this is the target di-
             rectory of the backend.

     -h      Add human readable flag to commands that deal with sizes.  For
             example df and dh.

     -N hostname
             When running over the network this is the hostname of the epitome
             server.

     -S hostport
             When running over the network this is the hostport of the epitome
             server.  Default is 1337.

     -T backend_type
             Select backend type.  Currently supported types are file, bdb,
             and raw.  There is an experimental Postgresql backend.

             Note: when using the file backend one should use a filesystem
             with many inodes and a block size roughly the same as the epito-
             mize block size.

     -U user
             When using with a database type, this is the database user.

EXAMPLES
     The following command illustrates how to query the backend for free
     space:

        # epitool -c df -h

SEE ALSO
     epitomize(1), eprepare(1), epitome(3), epitome.conf(5)

HISTORY
     The epitool command first appeared in OpenBSD 4.5.

AUTHORS
     The epitome suite was written by Marco Peereboom <marco@peereboom.us>.

CAVEATS
     The epitome suite is currently considered experimental.

OpenBSD 4.4                     October 6, 2008                              1