asused(3pm)

💖 asused 💖

okay bestie, buckle up, because this is the page for asused — that's asused(3pm), a Perl module manpage from the User Contributed Perl Documentation section. No cap.

---

✨ NAME ✨

asused — it 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 👑

okay so 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 too. If there are no errors in locating allocations and and assignments under an allocation, then in in the total % are calculated on total allocations. periodt. 💅

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. one flag, three vibes, iconic behavior tbh.
• --approval — Check the all networks in allocations are valid or not. Print valid and invalid networks. Heads up bestie: --aw only print invalid networks.
• --aw — Check the all networks in allocations are valid or not. Print only Invalid networks. And --approval will print valid and invalid. same check, different fit. 💅
• --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-by — Invalid <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 💀

bestie these are the known problems, not a drill, read them fr fr.

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>

---

okay that's the whole page, you ate it, you're literally the main character of address space summaries now 💅

this page was brought to you by perl v5.32.0 and dated 2021-01-26, signing off bestie, slay 🎀✨