RPSL2ACL(1) User Contributed Perl Documentation RPSL2ACL(1)RPSL2ACLrpsl2acl - create a list of CIDRs from RPSL database
SYNOPSISrpsl2acl [options]
DESCRIPTION
Rpsl2acl queries a set of RPSL objects from a whois server, extracts
members: records and converts them into a list of non-overlapping CIDR
values. The resulting list is sorted lexicographically.
OPTIONS
The following option control the output:
--acl=name
Format output as a bind ACL statement with the given name.
--comment=string
Print string as the heading comment to the output. The argument
can consist of multiple lines. A "#" sign will be printed before
each of them.
--outfile=FILE, -o FILE
Write the result to FILE, instead of the default "netlist".
The following options control selection of RPSL objects and initial
contents of the output list:
--add-network=arg
Add given CIDRs to the output list. Argument is a comma-separated
list of CIDRs.
--from-file=FILE, -T FILE
Populate the output list with CIDRs read from FILE. The file must
list each CIDR on a separate line. Empty lines and comments
(introduced by "#" sign) are ignored.
--objects=objlist, -r objlist
Defines a list of objects to query. Objlist is a comma-separated
list of RPSL object names.
The following options control TCP connections:
--no-persistent
Disable persistent connection. Rpsl2acl will open a new connection
to the whois server for each RPSL object it is about to query.
--whois-server=server
Query this server, instead of the default "whois.ripe.net".
Options controlling log and debug output:
--log-file=FILE, -l FILE
Write diagnostic output to FILE, instead of standard error.
--debug[=spec[,spec...]], -d[spec[,spec...]]
Set debugging level. spec is either category or category=level,
category is a debugging category name and level is a decimal
verbosity level. Valid categories are: "GENERAL" and "WHOIS".
--dry-run, -n
Don't create output file. Instead print the result on the standard
output.
Informational options:
--help, -h
Show a terse help summary and exit.
--man
Prints the manual page and exits.
CONFIGURATION
The program reads its configuration from one of the following
locations:
a. File name given by "RPSL2ACL_CONF" environment variable (if set)
b. ~/.rpsl2acl.conf
c. /etc/rpsl2acl.conf
First of these files that exists is read. It is an error, if the
$RPSL2ACL_CONF variable is set, but points to a file that does not
exist. It is not an error if $RPSL2ACL_CONF is not set and neither of
the two remaining files exist. It is, however, an error if any of
these file exists, but is not readable.
The configuration file uses usual UNIX configuration format. Empty
lines and UNIX comments are ignored. Each non-empty line is either an
option name, or option assignment, i.e. opt=val, with any amount of
optional whitespace around the equals sign. Valid option names are the
same as long command line options, but without the leading --. For
example:
objects = RS-FOO,RS-BAR,RS-BAZ
aclname = mynets
add-network = 10.0.0.0/8
outfile = networks.inc
ENVIRONMENT
RPSL2ACL_CONF
The name of the configuration file to read, instead of the default
/etc/rpsl2acl.conf.
AUTHOR
Sergey Poznyakoff <gray@gnu.org>
perl v5.20.2 2012-03-26 RPSL2ACL(1)
