debian man page for damnit

DAMNIT(8)
DAMNIT(8)

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)  sys-
temadministra-
       tors  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,	
  and  	.  Translating  to  the  entry
itself,  the
	      entrytime  (in  human  readable  form),  the entry-
time (as time-
	      stamp),  a  newline character, and a tab character.
The  default
	      format  is: "%time -> %entry
". Don't  forget  the
trailing new-
	      line.

       -d <file> [<value>]
	      Delete  <value> from <file>. If <value> is  omited,
damnit	will
	      read  <value>  from stdin (one per line), until ei-
ther 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 <val-
ue>; is omited,
	      damnit will read <value> from stdin (one per line),
until either
	      EOF or an emtpy 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	ter-
       minated	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 architec-
tures.

AUTHOR
       Patrick Ahlbrecht <p.ahlbrecht@billiton.de>

SEE ALSO
       gnarwl(8)

FILES
       /tmp/buildd/gnarwl-3.6.dfsg/debian/gnarwl/var/lib/gnarwl/block/*
	      Every file in this directory represents an emailad-
dress,	gnarwl
	      (already)  received  a mail for. Every time, gnarwl
sends out an
	      autorreply  for  an  address, the recepient 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.

       /tmp/buildd/gnarwl-3.6.dfsg/debian/gnarwl/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   speci-
fied  here,  as
	      gnarwl checks these "as-is".

       /tmp/buildd/gnarwl-3.6.dfsg/debian/gnarwl/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)