NAME

       adplugdb - AdPlug database maintenance utility

SYNOPSIS

       adplugdb [OPTION]... COMMAND [ARGUMENT]...

DESCRIPTION

       adplugdb  maintains  database files in AdPlug database format. It can add, list and remove
       records within a central database, or merge a set of databases together  into  one  single
       database.

       adplugdb always operates on a central database file. The location of this database file is
       determined by first checking if the user has a home directory.  If  a  home  directory  is
       present,  the database file will be located in ~/.adplug/adplug.db. If a home directory is
       not present, a database  file  adplug.db  will  be  looked  for  in  the  current  working
       directory.

       A  system-wide database file can be used instead, by specifying the -s commandline option.
       The system-wide database file is located in  /usr/com/adplug/adplug.db  and  may  only  be
       manipulated  as  the  superuser.  An  arbitrary  database  file  might be used as well, by
       specifying the -d commandline parameter. Only one database file may be  manipulated  at  a
       time.

EXIT STATUS

       adplugdb  returns  with  a  successful  exit  status  (0  on  most  systems) on successful
       operation. An unsuccessful exit status (1 on most systems) is returned otherwise.

COMMANDS

       Commands control the main operation mode of  adplugdb.  Commands  can  have  a  number  of
       arguments. Only one command may be specified at a time.

       add    This  command  takes  a  list of filenames, separated by spaces, as arguments. Each
              file is examined and a record is added to the database if the file is supported  by
              AdPlug.  By  default,  the  record will be of type Plain, unless the -t commandline
              option is specified (see  below).  The  default  comment  entry  is  the  specified
              filename. If a record for a file is already in the database, it will be replaced by
              the new record.

       list   This command takes an optional list of filenames or keys, separated by  spaces,  as
              arguments. Each file is examined and the corresponding record is looked up from the
              database and displayed on stdout, in a human-readable form.  If  no  arguments  are
              given, all records from the database are displayed.

       remove This  command takes a list of filenames or keys, separated by spaces, as arguments.
              Each file is examined and the corresponding record is removed from the database.

       merge  This command takes a list of database filenames, separated by spaces, as arguments.
              Each database file is loaded and the contents are merged and written to the central
              database file. The database files are processed in the order they are specified  on
              the commandline. Records from databases that were specified earlier take precedence
              over records from databases that were specified later.  Records  from  the  central
              database  take  precedence  over all other records. This means that only additional
              records from the other databases will be added to the central  database  and  if  a
              record  is  found that is not already in the central database, the version from the
              earliest specified database that contains this record will be taken. In no way will
              records ever be overwritten in the central database.

OPTIONS

       The order of the option commandline parameters is not important.

   Database options:
       -d <file>
              Specify an arbitrary file to use as the central database.

       -s     Use  the  system-wide  database  file  as the central database. This option is only
              present if adplugdb was compiled with system-wide database file support.

       -t <type>
              Specify a record type to be used as the type for  all  newly  added  records.  Each
              record needs a special type to be useful to AdPlug's players. The commandline help,
              displayed using the -h commandline option, presents a list of  types  that  may  be
              specified.

       -c     Prompt  for  record comment. If this option is given, the user will be prompted and
              asked for each newly added record's comment.

       -k     Specify keys instead of filenames. If this option is given, all  command  arguments
              that  normally are filenames are expected to be record keys instead. Each record in
              the database has a unique identifying key, generated from the corresponding  file's
              contents.  To  manipulate  a record entry, you either must have the exact same file
              and specify its name, or you specify the record's key, using this option. Keys  are
              specified  the  same  way they are displayed using the list command, as CRC16:CRC32
              value in hexadecimal format.

   Generic options:
       -q, --quiet
              Be more quiet.

       -v, --verbose
              Be more verbose.

       -h, --help
              Show summary of commandline commands, arguments and options.

       -V, --version
              Show version and author information of the program.

AUTHOR

       Simon Peter <dn.tlp@gmx.net>