'\" t
.\"     Title: mmdbresolve
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-18
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MMDBRESOLVE" "1" "2024-04-18" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
mmdbresolve \- Read IPv4 and IPv6 addresses and print their IP geolocation information.
.SH "SYNOPSIS"
.sp
\fBmmdbresolve\fP
\fB\-f\~<dbfile>\fP
[\~\fB\-f\~<dbfile>\fP\~]
\fI...\fP
.SH "DESCRIPTION"
.sp
\fBmmdbresolve\fP reads IPv4 and IPv6 addresses on stdin and prints their IP geolocation information
on stdout. Each input line must contain exactly one address. Output is in INI format, with a section
delimiter named after the query address followed by a set of "key: value" pairs. A comment
beginning with "# End" is appended to each section.
.sp
At startup an "[init]" section is printed that shows the status of each datbase and of mmdbresolve
itself.
.SH "OPTIONS"
.sp
\-f
.RS 4
Path to a MaxMind Database file. Multiple databases may be specified.
.RE
.SH "EXAMPLES"
.sp
To resolve a single address:
.sp
.if n .RS 4
.nf
.fam C
echo 4.4.4.4 | mmdbresolve \-f /usr/share/GeoIP/GeoLite2\-City.mmdb
.fam
.fi
.if n .RE
.sp
.B Example output
.br
.sp
.if n .RS 4
.nf
.fam C
[init]
db.0.path: /usr/share/GeoIP/GeoLite2\-City.mmdb
db.0.status: OK
mmdbresolve.status: true
# End init
[4.4.4.4]
# GeoLite2\-City
country.iso_code: US
country.names.en: United States
location.latitude: 37.751000
location.longitude: \-97.822000
# End 4.4.4.4
.fam
.fi
.if n .RE
.SH "SEE ALSO"
.sp
wireshark(1), tshark(1)
.SH "NOTES"
.sp
\fBmmdbresolve\fP is part of the \fBWireshark\fP distribution. The latest version
of \fBWireshark\fP can be found at \c
.URL "https://www.wireshark.org" "" "."
.sp
HTML versions of the Wireshark project man pages are available at
.URL "https://www.wireshark.org/docs/man\-pages" "" "."
.SH "AUTHORS"
.sp
.B Original Author
.br
Gerald Combs <gerald[AT]wireshark.org>