asused(3pm)						User Contributed Perl Documentation					       asused(3pm)

NAME

       asused - summaries  address  space used and   according to  the RIPE DB and REG.

SYNOPSIS

       asused  [--all]	[--aw | --approval] [--overlap] [--status | --assign[--pipa] ]	regid

       asused [--all] [--aw | [--approval]  [--overlap]  [--status | --assign [--pipa] ] [--regid regid] (prefix ...)

       asused  [--<options>]  regid | prefix

DESCRIPTION

       asused is a tool to summaries  address space is	registered  in the RIPE 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.

       where:

       regid is name of registry as in registry database.

       prefix  is allocation as in whois  database. e.g. a.b.c/16 . Prefix  is queried	whois DB to  find all Less specific matches   inetnum with
       na as netname is interpreted as allocation  and summerize the allocation.

OPTIONS

       --assign print all assignments under allocations, size, date  and net name .  Summary of assignments. And free address space. Summary of
       status attribute.
       --all this same as three options  --overlap --status --aw.
       --approval  Check the all networks in allocations  are  valid or not. Print valid and invalid networks. --aw only print invalid networks.
       --aw Check the all networks in allocations  are	valid or not. Print only Invalid networks. --approval will print valid and invalid.
       --contacts   print admin-c/tech-c for all inetnums
       --help  Shows the usage of asused.
       --overlap print the details of overlapping assignments. Summary of overlap per assignment is printed at the end.
       --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.
       --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.

OTHER OPTIONS

       as3-option
	   --port port	query another whois server on the port. Default is 43.
	   --host whoishost query another whois server. Default is whois.ripe.net. Can query only to RIPE whois server. Server version tested
	   '2.1'
	   --na netname show event table for approval of netname. Used with --aw or --approval
	   -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.
	   --version print version of asused.

DIAGNOSTICS

       No allocations from reg Could  not locate any allocations in use from registry.
       No allocations from DB No inetnum object was recognized as allocation in the RIPE Database.
	% 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.
       ERROR MISMATCH Netname regid RIPE DB  Netame attribute  has mismatch with na or regid.
       ERROR STATUS May be incorrect  status attribute in the RIPE DB, Valid status ALLOCATED (PA|PI|UNSPECIFIED)
       ERROR mnt-byInvalid <mnt-by> attribute in RIPE DB  expecting  RIPE-NCC-MNT|RIPE-NCC-HM-MNT|RIPE-NCC-HM-PI-MNT
       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
       Classfull notation Intrepreted as class full object.  Check if no of address are counted correctly.
       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.
       NOT Counted  Assignment If the assignment is outside the boundaries of allocation. It was returned by -M query RIPE whois server.
       Invalid inetnum Logical interpretation of inetnum fails.  Probably  can not  identify start,  end of end < start.
       Assignments has Invalid Date one of the dates of inetnum in the changed attribute is invalid.

REQUIRES

       Perl 5.00404 or later.	Connection to RIPE  whois server V 2.1, Perl Modules  Socket Getopt::Long, regread, ipv4pack

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
       IP No.

       Out of memory! Noticed that when  the no of assignments are very large, like 5000+ per allocation default data segment  size of BSDI 3.1 is
       not enough.  Increasing to 64 M Bytes may help.	in bash shell ulimit -d 65536 eg. de.schlund

       IANA Delegated  blocks smaller than /8 If the allocations are outside 192,193,194,195,212 /8 and LIR allocation is same inetnum as in
       /ncc/ip-reg/delegations asused2 will return No allocations in RIPE DB. eg. de.callisto

SEE ALSO

       whois   reg   i2r regread  Reg::Asused Reg::Approved Net::RIPEWhois

AUTHOR

       Antony Antony <antony@ripe.net> . RIPE NCC software group. <softies@ripe.net>

POD ERRORS

       Hey! The above document had some coding errors, which are explained below:

       Around line 46:
	   You forgot a '=back' before '=head1'

       Around line 66:
	   You forgot a '=back' before '=head1'

	   You forgot a '=back' before '=head1'

       Around line 95:
	   You forgot a '=back' before '=head1'

perl v5.10.1							    2003-10-07							       asused(3pm)