NAME

       damnit - DAtabase MaNagement InTerface

SYNOPSIS

       damnit [-h] [-d <file> <value>] [-a <file> <value>] [-f <string>] [-l <file>]

DESCRIPTION

       damnit  is  the  database  management  tool for gnarwl(8) . It allows systemadministrators to list and/or
       manipulate gnarwl's database files. It is not intented to be employed by the average user, who should use
       LDAP as the only interface to gnarwl(8)

OPTIONS

       -h     Print usage information

       -f <string>
              Select output format for database listing (only meaningful with -l).  <string> is the template for
              what the output should look like. The following macros are recognized: %entry, %time, %tstamp, \en
              and  \et.  Translating  to the entry itself, the entrytime (in human readable form), the entrytime
              (as timestamp), a newline character, and a tab  character.   The  default  format  is:  "%time  ->
              %entry\en". Don't forget the trailing newline.

       -d <file> [<value>]
              Delete  <value>  from  <file>.  If <value> is omited, damnit will read <value> from stdin (one per
              line), until either EOF or an empty line is detected.

       -a <file> [<value>]
              Add <value> to <file>. If <value> is already  stored  in  <file>,  damnit  will  only  update  the
              timestamp.  If <value> is omited, damnit will read <value> from stdin (one per line), until either
              EOF or an empty line is detected.

       -l <file>
              List database file specified by <file>.

DATABASE FILES

       gnarwl uses hashfiles for storing information on disk. Meaning, all datasets consist  of  key  and  value
       pairs. The key is always a NULL terminated character string, while the value contains the timestamp, when
       the key was entered (last time) into the file. This timestamp is of type time_t (as returned by  time(2))
       and therefore, gnarwl's database files are not copyable between different system architectures.

AUTHOR

       Patrick Ahlbrecht <p.ahlbrecht@billiton.de>

SEE ALSO

       gnarwl(8)

FILES

       /var/lib/gnarwl/block/*
              Every  file  in  this  directory represents an emailaddress, gnarwl (already) received a mail for.
              Every time, gnarwl sends out an autorreply for an address, the recipient of that  mail  is  locked
              into  the  according  file.  gnarwl will not send any further autoreplies for this sender/receiver
              combo, until the timeout specified in gnarwl.cfg expires.

       /var/lib/gnarwl/blacklist.db
              Emailaddresses listed as keys in this file are not subject to  autoresponding  (the  addresses  of
              root,  postmaster, webmaster and the like should be put herin). Note: The complete mailaddress, as
              it would appear in an email, must be specified here, as gnarwl checks these "as-is".

       /var/lib/gnarwl/badheaders.db
              Each entry in this file represent a line that may not occur in the header  of  a  received  email.
              That  is,  gnarwl  won't reply to any mail, it is able to match a headerline with an entry in this
              file.

                                                                                                       DAMNIT(8)