DragonFly On-Line Manual Pages

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)
       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, \n and \t. Translating to  the  entry  it-
self, the
	      entrytime	 (in  human readable form), the	entrytime
(as
	      timestamp), a newline character, and a tab  charac-
ter.  The
	      default  format is: "%time -> %entry\n". Don't for-
get the
	      trailing newline.

       -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  <value>
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
       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
       /usr/local/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.

       /usr/local/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".

       /usr/local/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)