The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 181:

Non-ASCII character seen before =encoding in 'Muñoz,'. Assuming CP1252