# Manual Page: dbmmanage

    NAME
         dbmmanage - Create and update user authentication  files  in
         DBM format

    SYNOPSIS
         dbmmanage filename [ command ] [ username [ encpasswd ] ]

    DESCRIPTION
         dbmmanage is used to create and update the DBM format  files
         used  to  store usernames and password for basic authentica-
         tion of HTTP users.   Resources  available  from  the  httpd
         Apache web server can be restricted to just the users listed
         in the files created by dbmmanage. This program can only  be
         used  when  the usernames are stored in a DBM file. To use a
         flat-file database see htpasswd.

         This manual page only lists the command line arguments.  For
         details  of  the  directives  necessary  to  configure  user
         authentication in httpd see the Apache manual, which is part
         of   the   Apache   distribution   or   can   be   found  at
         http://www.apache.org/.

    OPTIONS
         filename
              The filename of the DBM format  file.  Usually  without
              the extension .db, .pag, or .dir.

         command
              This selects the operation to perform:

         add         Adds an entry for username to filename using the
                     encrypted password encpassword.

         adduser     Asks for a password and then adds an  entry  for
                     username to filename .

         check       Asks for a password and then checks if  username
                     is  in filename and if it's password matches the
                     specified one.

         delete      Deletes the username entry from filename.

         import      Reads username:password entries (one  per  line)
                     from  STDIN and adds them to filename. The pass-
                     words already has to be crypted.

         update      Same as the "adduser" command,  except  that  it
                     makes sure username already exists in filename.

         view        Just displays the complete contents of  the  DBM
                     file.

         username    The user for which the update operation is  per-
                     formed.

    BUGS
         One should be aware that there are a number of different DBM
         file   formats   in  existence,  and  with  all  likelihood,
         libraries for more than one format may exist on your system.
         The three primary examples are NDBM, the GNU project's GDBM,
         and Berkeley DB 2.  Unfortunately, all these  libraries  use
         different file formats, and you must make sure that the file
         format used by filename is the same  format  that  dbmmanage
         expects  to see. dbmmanage currently has no way of determin-
         ing what type of DBM file it is looking at.  If used against
         the  wrong format, will simply return nothing, or may create
         a different DBM file with a different name, or at worst,  it
         may  corrupt the DBM file if you were attempting to write to
         it.

         dbmmanage has a list of DBM format preferences,  defined  by
         the  @AnyDBM::ISA  array  near the beginning of the program.
         Since we prefer the Berkeley DB 2 file format, the order  in
         which  dbmmanage  will look for system libraries is Berkeley
         DB 2, then NDBM, and then GDBM.   The  first  library  found
         will  be  the  library dbmmanage will attempt to use for all
         DBM file transactions.  This ordering is slightly  different
         than  the standard @AnyDBM::ISA ordering in perl, as well as
         the ordering used by the simple dbmopen() call in  Perl,  so
         if  you  use  any  other utilities to manage your DBM files,
         they must also follow  this  preference  ordering.   Similar
         care  must  be  taken  if using programs in other languages,
         like C, to access these files.

         Apache's mod_auth_db.c module corresponds to Berkeley  DB  2
         library,   while  mod_auth_dbm.c  corresponds  to  the  NDBM
         library.  Also, one can usually use the  file  program  sup-
         plied  with  most Unix systems to see what format a DBM file
         is in.

    SEE ALSO
         httpd(8)