NAME

DNS::BL::cmds::connect::db - Implement the DB connect command for DNS::BL

SYNOPSIS

use DNS::BL::cmds::connect::db;

DESCRIPTION

This module implements the connection to a DB backend where DNS::BL data will be stored. On each call to this class' methods, a hash will be tie()d and then untie()d. This guarantees that the underlying DB structure will be unlocked and available for other commands that may, for instance, replace or manipulate the hash "from under us".

The following methods are implemented by this module:

->execute()

See DNS::BL::cmds for information on this method's purpose.

The connect command follows a syntax such as

connect db <args> ...

Note that the 'connect' token must be removed by the calling class, usually DNS::BL::cmds::connect. args are key - value pairs specifying different parameters as described below. Unknown parameters are reported as errors. The complete calling sequence is as

connect db file "filename"

Where "filename" refers to the DB file where data is to be found. If the file does not exist, it will be created (provided that permissions allow).

This class will be used and then, its execute() method invoked following the same protocol outlined in DNS::BL. Prior connect() information is to be removed by the calling class.

EXPORT

None by default.

HISTORY

$Log: db.pm,v $ Revision 1.2 2004/10/12 17:44:46 lem Updated docs. Added print with format

Revision 1.1 2004/10/11 21:16:34 lem Basic db and commands added

SEE ALSO

Perl(1), DNS::BL.

AUTHOR

Luis Muñoz, <luismunoz@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2004 by Luis Muñoz

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