.\" Generated by kramdown-man 1.0.1
.\" https://github.com/postmodern/kramdown-man#readme
.TH ronin-asn 1 "2023-02-01" Ronin "User Manuals"
.SH NAME
.PP
ronin\-asn \- Queries or searches for ASN information
.SH SYNOPSIS
.PP
\fBronin asn\fR \[lB]\fIoptions\fP\[rB] \[lB]\fB\-v\fR \[or] \fB\-\-enum\-ips\fR\[rB] \[lC]\fB\-n\fR,\fB\-\-number\fR \fINUMBER\fP \[or] \fB\-c\fR,\fB\-\-country\fR \fICOUNTRY\fP \[or] \fB\-N\fR,\fB\-\-name\fR \fINAME\fP \[or] \fB\-I\fR,\fB\-\-ip\fR \fIIP\fP\[rC]
.SH DESCRIPTION
.PP
Queries ASN information for the given \fIIP\fP or searches for the ASN records for
the given \fINUMBER\fP, \fINAME\fP, or \fICOUNTRY\fP code\.
.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Prints multi\-line human readable output\.
.TP
\fB\-U\fR, \fB\-\-url\fR \fIURI\fP
Overrides the default ASN list URL\. Defaults to
\fBhttps:\[sl]\[sl]iptoasn\.com\[sl]data\[sl]ip2asn\-combined\.tsv\.gz\fR\.
.TP
\fB\-f\fR, \fB\-\-file\fR \fIFILE\fP
Overrides the default ASN list file\. Defaults to
\fB\[ti]\[sl]\.cache\[sl]ronin\[sl]ronin\-support\[sl]ip2asn\-combined\.tsv\.gz\fR\.
.TP
\fB\-u\fR, \fB\-\-update\fR
Updates the ASN list file\.
.TP
\fB\-n\fR, \fB\-\-number\fR \fINUM\fP\[or]AS\fINUM\fP
Searches for all ASN records with the AS number\.
.TP
\fB\-C\fR, \fB\-\-country\-code\fR \fIXX\fP\[or]\fBNone\fR\[or]\fBUnknown\fR
Searches for all ASN records with the country code\.
.TP
\fB\-N\fR, \fB\-\-name\fR \fINAME\fP
Searches for all ASN records with the matching name\.
.TP
\fB\-I\fR, \fB\-\-ip\fR \fIIP\fP
Queries the ASN record for the IP\.
.TP
\fB\-4\fR, \fB\-\-ipv4\fR
Filters ASN records for only IPv4 ranges\.
.TP
\fB\-6\fR, \fB\-\-ipv6\fR
Filter ASN records for only IPv6 ranges\.
.TP
\fB\-E\fR, \fB\-\-enum\-ips\fR
Enumerate over the IPs within the ASN ranges\.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help information
.SH EXAMPLES
.PP
Print verbose output for all ASN records for \fBAS15133\fR:
.PP
.RS 4
.EX
\[Do] ronin asn \-v \-n 15133
.EE
.RE
.PP
Print verbose output for the ASN record for the IP address \fB93\.184\.216\.34\fR:
.PP
.RS 4
.EX
\[Do] ronin asn \-v \-I 93\.184\.216\.34
.EE
.RE
.PP
Prints all ASN records for the given country code:
.PP
.RS 4
.EX
\[Do] ronin asn \-C US
.EE
.RE
.PP
Prints all ASN records for the given ISP:
.PP
.RS 4
.EX
\[Do] ronin asn \-N EDGECAST
.EE
.RE
.PP
Enumerate over the IP addresses in the IP range for \fBAS15133\fR:
.PP
.RS 4
.EX
\[Do] ronin asn \-\-enum\-ips \-n 15133
.EE
.RE
.PP
Enumerate over all IP addresses for all ASN records belonging to the given ISP:
.PP
.RS 4
.EX
\[Do] ronin asn \-\-enum\-ips \-N EDGECAST
.EE
.RE
.SH ENVIRONMENT
.TP
\fIHOME\fP
Alternate location for the user\[cq]s home directory\.
.TP
\fIXDG\[ru]CONFIG\[ru]HOME\fP
Alternate location for the \fB\[ti]\[sl]\.config\fR directory\.
.SH FILES
.TP
\fB\[ti]\[sl]\.cache\[sl]ronin\[sl]ronin\-support\[sl]ip2asn\-combined\.tsv\.gz\fR
The location of the downloaded ASN list\.
.SH AUTHOR
.PP
Postmodern 
.MT postmodern\.mod3\[at]gmail\.com
.ME