.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "asused 3pm" .TH asused 3pm "2021-01-26" "perl v5.32.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" asused \- summaries address space used and according to the RIPE DB and REG. .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBasused\fR [\fB\-\-all\fR] [\fB\-\-aw\fR | \fB\-\-approval\fR] [\fB\-\-overlap\fR] [\fB\-\-status\fR | \fB\-\-assign\fR[\fB\-\-pipa\fR] ] \fIregid\fR .PP \&\fBasused\fR [\fB\-\-all\fR] [\fB\-\-aw\fR | [\fB\-\-approval\fR] [\fB\-\-overlap\fR] [\fB\-\-status\fR | \fB\-\-assign\fR [\fB\-\-pipa\fR] ] [\fB\-\-regid\fR \fIregid\fR] (\fIprefix\fR ...) .PP \&\fBasused\fR [\-\-\fB] \fIregid\fR | prefix .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBasused\fR is a tool to summaries address space is registered in the \s-1RIPE\s0 database. For each allocated inetnum object a summary of used and free address space is printed. A grant total summary for all prefixes is also provided. If there are no errors in locating allocations and and assignments under an allocation. In in the total % are calculated on total allocations. .PP where: .PP \&\fIregid\fR is name of registry as in registry database. .PP \&\fIprefix\fR is allocation as in whois database. e.g. a.b.c/16 . Prefix is queried whois \s-1DB\s0 to find all Less specific matches inetnum with \fIna\fR as netname is interpreted as allocation and summerize the allocation. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-assign\fR print all assignments under allocations, size, date and net name . Summary of assignments. And free address space. Summary of status attribute." 4 .IX Item "--assign print all assignments under allocations, size, date and net name . Summary of assignments. And free address space. Summary of status attribute." .PD 0 .IP "\fB\-\-all\fR this same as three options \fB\-\-overlap\fR \fB\-\-status\fR \fB\-\-aw\fR." 4 .IX Item "--all this same as three options --overlap --status --aw." .IP "\fB\-\-approval\fR Check the all networks in allocations are valid or not. Print valid and invalid networks. \fB\-\-aw\fR only print invalid networks." 4 .IX Item "--approval Check the all networks in allocations are valid or not. Print valid and invalid networks. --aw only print invalid networks." .IP "\fB\-\-aw\fR Check the all networks in allocations are valid or not. Print only Invalid networks. \fB\-\-approval\fR will print valid and invalid." 4 .IX Item "--aw Check the all networks in allocations are valid or not. Print only Invalid networks. --approval will print valid and invalid." .IP "\fB\-\-contacts\fR print admin\-c/tech\-c for all inetnums" 4 .IX Item "--contacts print admin-c/tech-c for all inetnums" .IP "\fB\-\-help\fR Shows the usage of \fBasused\fR." 4 .IX Item "--help Shows the usage of asused." .IP "\fB\-\-overlap\fR print the details of overlapping assignments. Summary of overlap per assignment is printed at the end." 4 .IX Item "--overlap print the details of overlapping assignments. Summary of overlap per assignment is printed at the end." .IP "\fB\-\-reg\fR \fIregid\fR. regid to locate the allocation. Netname of allocation is same as regid, translating the first '.' to '\-' \s-1IN\s0 upper case. If not specified uses i2r to get regid." 4 .IX Item "--reg regid. regid to locate the allocation. Netname of allocation is same as regid, translating the first '.' to '-' IN upper case. If not specified uses i2r to get regid." .IP "\fB\-\-status\fR show assignments under allocations with wrong status attribute other than \s-1ASSIGNED PA\s0 or \s-1PI.\s0 \fB\s-1MISSING\s0\fR for missing status. size and net name. Summary of assignments. No of Assignment(s) , No Assignments with status \s-1ASSIGNED PA\s0 or \s-1ASSIGNED PI,\s0 No Assignments with status \fB\s-1ASSIGNED PI\s0\fR,No Assignments, No Assignments with Missing status attribute,No Assignments with other values status attribute, none of other . Warnings on assignments." 4 .IX Item "--status show assignments under allocations with wrong status attribute other than ASSIGNED PA or PI. MISSING for missing status. size and net name. Summary of assignments. No of Assignment(s) , No Assignments with status ASSIGNED PA or ASSIGNED PI, No Assignments with status ASSIGNED PI,No Assignments, No Assignments with Missing status attribute,No Assignments with other values status attribute, none of other . Warnings on assignments." .PD .SH "OTHER OPTIONS" .IX Header "OTHER OPTIONS" .IP "\fBas3\-option\fR" 4 .IX Item "as3-option" .RS 4 .PD 0 .IP "\fB\-\-port\fR \fIport\fR query another whois server on the \fIport\fR. Default is 43." 8 .IX Item "--port port query another whois server on the port. Default is 43." .IP "\fB\-\-host\fR \fIwhoishost\fR query another whois server. Default is whois.ripe.net. Can query only to \s-1RIPE\s0 whois server. Server version tested '2.1'" 8 .IX Item "--host whoishost query another whois server. Default is whois.ripe.net. Can query only to RIPE whois server. Server version tested '2.1'" .IP "\fB\-\-na\fR \fInetname\fR show event table for approval of \fInetname\fR. Used with \fB\-\-aw\fR or \fB\-\-approval\fR" 8 .IX Item "--na netname show event table for approval of netname. Used with --aw or --approval" .IP "\fB\-pipa\fR additional flag to the \fB\-\-assign\fR option to print allocation status in output. \s-1PA\s0 is for \s-1ALLOCATED PA, PI\s0 \- \s-1ALLOCATED PI, UN\s0 for \s-1UNSPECIFED,\s0 \fB\-\-\fR is for missed \fBstatus\fR field." 8 .IX Item "-pipa additional flag to the --assign option to print allocation status in output. PA is for ALLOCATED PA, PI - ALLOCATED PI, UN for UNSPECIFED, -- is for missed status field." .IP "\fB\-\-version\fR print version of asused." 8 .IX Item "--version print version of asused." .RE .RS 4 .RE .PD .SH "DIAGNOSTICS" .IX Header "DIAGNOSTICS" .IP "\fBNo allocations from reg\fR Could not locate any allocations in use from registry." 4 .IX Item "No allocations from reg Could not locate any allocations in use from registry." .PD 0 .IP "\fBNo allocations from \s-1DB\s0\fR No inetnum object was recognized as allocation in the \s-1RIPE\s0 Database." 4 .IX Item "No allocations from DB No inetnum object was recognized as allocation in the RIPE Database." .IP "\fB % No entries found for the selected source(s).\fR No assignment(s) found under the allocation. May be a new allocation or allocation which has no objects in \s-1RIPE DB.\s0 Not sure to treat as 100 % free." 4 .IX Item " % No entries found for the selected source(s). No assignment(s) found under the allocation. May be a new allocation or allocation which has no objects in RIPE DB. Not sure to treat as 100 % free." .IP "\fB\s-1ERROR MISMATCH\s0 Netname regid\fR \s-1RIPE DB\s0 \fBNetame\fR attribute has mismatch with \fIna\fR or regid." 4 .IX Item "ERROR MISMATCH Netname regid RIPE DB Netame attribute has mismatch with na or regid." .IP "\fB\s-1ERROR STATUS\s0\fR May be incorrect status attribute in the \s-1RIPE DB,\s0 Valid status \s-1ALLOCATED\s0 (PA|PI|UNSPECIFIED)" 4 .IX Item "ERROR STATUS May be incorrect status attribute in the RIPE DB, Valid status ALLOCATED (PA|PI|UNSPECIFIED)" .IP "\fB\s-1ERROR\s0 mnt-by\fRInvalid attribute in \s-1RIPE DB\s0 expecting RIPE\-NCC\-MNT|RIPE\-NCC\-HM\-MNT|RIPE\-NCC\-HM\-PI\-MNT" 4 .IX Item "ERROR mnt-byInvalid attribute in RIPE DB expecting RIPE-NCC-MNT|RIPE-NCC-HM-MNT|RIPE-NCC-HM-PI-MNT" .IP "\fBInconsistent with \f(BIinetnum\fB\fR Encountered two inetnum objects with same logical start and end. Logical interpretation of inetnum a.b.c.0 => a.b.c.0 \- a.b.c.255; a.b.c.0 \- a.b.d.0 => a.b.c.0 \- a.b.d.255" 4 .IX Item "Inconsistent with inetnum Encountered two inetnum objects with same logical start and end. Logical interpretation of inetnum a.b.c.0 => a.b.c.0 - a.b.c.255; a.b.c.0 - a.b.d.0 => a.b.c.0 - a.b.d.255" .IP "\fBClassfull notation\fR Intrepreted as class full object. Check if no of address are counted correctly." 4 .IX Item "Classfull notation Intrepreted as class full object. Check if no of address are counted correctly." .IP "\fBMultiple inetnum\fR When tried to locate an allocation inetnum object for \fIregid\fR \fIprefix\fR from \s-1RIPE DB\s0 with option \-L \-F \-T \fIprefix\fR returned multiple objects. Every prefix can have only one allocation object." 4 .IX Item "Multiple inetnum When tried to locate an allocation inetnum object for regid prefix from RIPE DB with option -L -F -T prefix returned multiple objects. Every prefix can have only one allocation object." .IP "\fB\s-1NOT\s0 Counted Assignment\fR If the assignment is outside the boundaries of allocation. It was returned by \-M query \s-1RIPE\s0 whois server." 4 .IX Item "NOT Counted Assignment If the assignment is outside the boundaries of allocation. It was returned by -M query RIPE whois server." .IP "\fBInvalid inetnum\fR Logical interpretation of inetnum fails. Probably can not identify start, end of end < start." 4 .IX Item "Invalid inetnum Logical interpretation of inetnum fails. Probably can not identify start, end of end < start." .IP "\fBAssignments has Invalid Date\fR one of the dates of inetnum in the changed attribute is invalid." 4 .IX Item "Assignments has Invalid Date one of the dates of inetnum in the changed attribute is invalid." .PD .SH "REQUIRES" .IX Header "REQUIRES" Perl 5.00404 or later. Connection to \s-1RIPE\s0 whois server V 2.1, Perl Modules Socket Getopt::Long, regread, ipv4pack .SH "BUGS" .IX Header "BUGS" Could give incorrect summary if logical interpretation of Inetnum is not exact a.b.c.0 \- a.b.c.0 is intended to be an assignment of size 1 \s-1IP\s0 No. .PP \&\fBOut of memory!\fR Noticed that when the no of assignments are very large, like 5000+ per allocation default data segment size of \s-1BSDI 3.1\s0 is not enough. Increasing to 64 M Bytes may help. in bash shell \fBulimit \-d 65536\fR eg. de.schlund .PP \&\fB\s-1IANA\s0 Delegated blocks smaller than /8\fR If the allocations are outside 192,193,194,195,212 /8 and \s-1LIR\s0 allocation is same inetnum as in /ncc/ip\-reg/delegations asused2 will return \fINo allocations in \s-1RIPE DB\s0\fR. eg. de.callisto .SH "SEE ALSO" .IX Header "SEE ALSO" whois reg i2r regread Reg::Asused Reg::Approved Net::RIPEWhois .SH "AUTHOR" .IX Header "AUTHOR" Antony Antony . \s-1RIPE NCC\s0 software group.