Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
mmdblookup(1)		     General Commands Manual		   mmdblookup(1)

NAME
     mmdblookup - a utility to look up an IP address in a MaxMind DB file

SYNOPSIS
     mmdblookup --file [FILE PATH] --ip [IP ADDRESS] [DATA PATH]

DESCRIPTION
     mmdblookup  looks	up  an	IP address in the specified MaxMind DB file. The
     record for the IP address is displayed with {} to denote maps and [] to de-
     note arrays. The values are followed by type annotations.	This  output  is
     not  JSON	and is not intended to be used as such. If you need JSON, please
     see mmdbinspect.

     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:

     {
	 "names": {
	     "en": "Germany",
	     "de": "Deutschland"
	 },
	 "cities": [ "Berlin", "Frankfurt" ]
     }

     You could look up just the English name by calling mmdblookup with a lookup
     path of:

     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.

OPTIONS
     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.

     --version
	Print the program's version number and exit.

     -h, -?, --help
	Show usage information.

BUG REPORTS AND PULL REQUESTS
     Please  report  all  issues to our GitHub issue tracker. We welcome bug re-
     ports and pull requests. Please note that pull requests  are  greatly  pre-
     ferred over patches.

AUTHORS
     This  utility  was written by Boris Zentner (bzentner@maxmind.com) and Dave
     Rolsky (drolsky@maxmind.com).

COPYRIGHT AND LICENSE
     Copyright 2013-2026 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

     https://www.apache.org/licenses/LICENSE-2.0

     Unless  required  by  applicable law or agreed to in writing, software dis-
     tributed under the License is distributed on an "AS IS" BASIS, WITHOUT WAR-
     RANTIES OR CONDITIONS OF ANY KIND, either express or implied. See	the  Li-
     cense for the specific language governing permissions and limitations under
     the License.

SEE ALSO
     libmaxminddb(3)

								   mmdblookup(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mmdblookup&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help