NAME

DNS::BL::cmds::add - Add an entry to the database

SYNOPSIS

use DNS::BL::cmds::add;

DESCRIPTION

This module implements the add command, used to include entries into a DNSBL managed by DNS::BL. The general syntax of this command, is as follows

add ip <ip-address> [code <return-code>] [text <text>] [time <timestamp>]

where each argument has the following function:

ip <ip-address>

Specifies which IP address or network this command refers to. Essentially, anything that NetAddr::IP will understand.

code <return-code>

The value returned by the DNSBL when a match with this entry is found. Usually, this is something that can be returned in a DNS A RR, an IP address. If not specified, '127.0.0.1' will be used as a default.

text <text>

The text associated with this entry in the DNSBL. Usually this is associated with a DNS TXT RR. Defaults to an empty string.

time <timestamp>

The time associated with this entry in seconds since the epoch. Defaults to the current time. Some converters might add this item to the text description.

This functionality is provided by the following method:

->execute()

See DNS::BL::cmds for information on this method's general purpose and calling convention.

This method implements the behavior specified above.

EXPORT

None by default.

HISTORY

$Log: add.pm,v $ Revision 1.3 2004/10/12 18:14:27 lem Added collision check

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.