jordan.im: whois service, misc updates

1 files changed, 48 insertions, 0 deletions

diff --git a/whois.jordan.im/index.7 b/whois.jordan.im/index.7
new file mode 100644
index 0000000..fc91ae2
--- /dev/null
+++ b/whois.jordan.im/index.7
@@ -0,0 +1,48 @@
+.Dd March  24, 2022
+.Dt WHOIS.JORDAN.IM 7
+.Os "Alpine Linux"
+.
+.Sh NAME
+.Nm asn
+.Nd map hosts to their corresponding ASN over the WHOIS protocol
+
+.Sh DESCRIPTION
+.Lk https://git.jordan.im/asn "asn(1)"
+is a WHOIS server which provides BGP announcement information sourced from
+a local database cache generated using the
+.Lk https://location.ipfire.org/ "IPFIRE"
+dataset.
+.Pp
+.Sy whois.jordan.im
+is a public
+.Nm
+instance for personal use.
+.
+.Sh USAGE
+.
+.Pp
+.Lk https://man.openbsd.org/whois.1 "whois(1)"
+can be used to communicate with the server using
+.Ar --host
+and
+.Ar --port
+arguments. Both hostnames and IP address are accepted.
+.
+.Bd -literal -offset indent
+$ whois -h whois.jordan.im google.com
+
+AS Number | Country | AS Name | Announcement
+----------+---------+---------+--------------------
+15169     | US      | GOOGLE  | 142.250.0.0/15
+15169     | IE      | GOOGLE  | 2a00:1450:4009::/48
+
+$ whois -h whois.jordan.im 1.1.1.1
+
+AS Number | Country | AS Name       | Announcement
+----------+---------+---------------+-------------
+13335     | AU      | CLOUDFLARENET | 1.1.1.0/24
+.Ed
+.
+.Pp
+If a hostname is provided, queries for each resolved A/AAAA record will be
+returned. The dataset is regenerated daily to ensure response accuracy.