mmdblookup - a utility to look up an IP address in a MaxMind DB file
mmdblookup --file [FILE PATH] --ip [IP ADDRESS] [DATA PATH]
mmdblookup 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
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.
For example, given a JSON structure like this:
"cities": [ "Berlin", "Frankfurt" ]
You could look up just the English name by calling mmdblookup with a lookup path
mmdblookup --file ... --ip ... names en
Or you could look up the second city in the list with:
mmdblookup --file ... --ip ... cities 1
Array numbering begins with zero (0).
If you do not provide a path to lookup, all of the information for a given IP
will be shown.
This application accepts the following options:
- -f, --file
- The path to the MMDB file. Required.
- -i, --ip
- The IP address to look up. Required.
- -v, --verbose
- Turns on verbose output. Specifically, this causes this application to
output the database metadata.
- Print the program's version number and exit.
- -h, -?, --help
- Show usage information.
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
This utility was written by Boris Zentner (firstname.lastname@example.org) and Dave Rolsky
Copyright 2013-2014 MaxMind, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you
may not use this file except in compliance with the License. You may obtain a
copy of the License at
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under