.\" Automatically generated by Pandoc
.\"
.TH "mmdblookup" "1" "" "" ""
.hy
.SH NAME
.PP
mmdblookup \- a utility to look up an IP address in a MaxMind DB file
.SH SYNOPSIS
.PP
mmdblookup \[en]file [FILE PATH] \[en]ip [IP ADDRESS] [DATA PATH]
.SH DESCRIPTION
.PP
\f[C]mmdblookup\f[] looks up an IP address in the specified MaxMind DB
file.
The record for the IP address is displayed in a JSON\-like structure
with type annotations.
.PP
If an IP's data entry resolves to a map or array, you can provide a
lookup path to only show part of that data.
.PP
For example, given a JSON structure like this:
.IP "" 4
.nf
\f[C]
{
\ \ \ \ "names":\ {
\ \ \ \ \ \ \ \ "en":\ "Germany",
\ \ \ \ \ \ \ \ "de":\ "Deutschland"
\ \ \ \ },
\ \ \ \ "cities":\ [\ "Berlin",\ "Frankfurt"\ ]
}
\f[]
.fi
.PP
You could look up just the English name by calling mmdblookup with a
lookup path of:
.IP "" 4
.nf
\f[C]
mmdblookup\ \-\-file\ ...\ \-\-ip\ ...\ names\ en
\f[]
.fi
.PP
Or you could look up the second city in the list with:
.IP "" 4
.nf
\f[C]
mmdblookup\ \-\-file\ ...\ \-\-ip\ ...\ cities\ 1
\f[]
.fi
.PP
Array numbering begins with zero (0).
.PP
If you do not provide a path to lookup, all of the information for a
given IP will be shown.
.SH OPTIONS
.PP
This application accepts the following options:
.TP
.B \-f, \[en]file
The path to the MMDB file.
Required.
.RS
.RE
.TP
.B \-i, \[en]ip
The IP address to look up.
Required.
.RS
.RE
.TP
.B \-v, \[en]verbose
Turns on verbose output.
Specifically, this causes this application to output the database
metadata.
.RS
.RE
.TP
.B \[en]version
Print the program's version number and exit.
.RS
.RE
.TP
.B \-h, \-?, \[en]help
Show usage information.
.RS
.RE
.SH BUG REPORTS AND PULL REQUESTS
.PP
Please report all issues to our GitHub issue
tracker (https://github.com/maxmind/libmaxminddb/issues).
We welcome bug reports and pull requests.
Please note that pull requests are greatly preferred over patches.
.SH AUTHORS
.PP
This utility was written by Boris Zentner (bzentner\@maxmind.com) and
Dave Rolsky (drolsky\@maxmind.com).
.SH COPYRIGHT AND LICENSE
.PP
Copyright 2013\-2014 MaxMind, Inc.
.PP
Licensed under the Apache License, Version 2.0 (the \[lq]License\[rq]);
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
.IP "" 4
.nf
\f[C]
http://www.apache.org/licenses/LICENSE\-2.0
\f[]
.fi
.PP
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an \[lq]AS IS\[rq]
BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
.SH SEE ALSO
.PP
libmaxminddb(3)