damnit - DAtabase MaNagement InTerface
damnit [-h] [-d <file> <value>]
[-a <file> <value>] [-f <string>]
[-l <file>]
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)
- -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>.
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.
Patrick Ahlbrecht <p.ahlbrecht@billiton.de>
/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.