NAME
    FML::Error::Cache - manipulate error/bounce information database.

SYNOPSIS
            use FML::Error::Cache;
            my $db = new FML::Error::Cache $curproc;
            $db->add( $bounce_info );

    where $bounce_info follows:

        $bounce_info = [
                {
                    address => 'rudo@nuinui.net',
                    status  => '5.x.y',
                    reason  => '... reason ... ',
                },
                      ...
        ];

DESCRIPTION
    This class provides database manipluation.

METHODS
  new()
    constructor.

  open()
    dummy.

  close()
    dummy.

  touch()
    dummy.

  add($address, $argv)
    add data given as hash reference $argv into the database.

        $argv = {
            address => STR,
            reason  => STR,
            status  => STR,
        };

    "Tie::JournaledDir" is a simple hash, so $argv is converted to the
    following a set of key ($address) and value.

         $address => "$unixtime status=$status reason=$reason"

  delete($address)
    delete entry for the specified $address.

CACHE IO MANIPULATION
    You need to use primitive methods this class provides for IO into/from
    error database (data cache).

UTILITY FUNCTIONS
  get_primary_keys()
    return primary keys in cache as ARRAY_REF.

CODING STYLE
    See "http://www.fml.org/software/FNF/" on fml coding style guide.

AUTHOR
    Ken'ichi Fukamachi

COPYRIGHT
    Copyright (C) 2002,2003,2004,2005,2006,2008 Ken'ichi Fukamachi

    All rights reserved. This program is free software; you can redistribute
    it and/or modify it under the same terms as Perl itself.

HISTORY
    FML::Error::Cache first appeared in fml8 mailing list driver package.
    See "http://www.fml.org/" for more details.

