doc/man_pages/mmdbresolve.adoc

   1 include::../attributes.adoc[]
   2 = mmdbresolve(1)
   3 :doctype: manpage
   4 :stylesheet: ws.css
   5 :linkcss:
   6 :copycss: {css_dir}/{stylesheet}
   7
   8 == NAME
   9
  10 mmdbresolve - Read IPv4 and IPv6 addresses and print their IP geolocation information.
  11
  12 == SYNOPSIS
  13
  14 [manarg]
  15 *mmdbresolve*
  16 *-f <dbfile>*
  17 [ *-f <dbfile>* ]
  18 __...__
  19
  20 == DESCRIPTION
  21
  22 *mmdbresolve* reads IPv4 and IPv6 addresses on stdin and prints their IP geolocation information
  23 on stdout. Each input line must contain exactly one address. Output is in INI format, with a section
  24 delimiter named after the query address followed by a set of "key: value" pairs. A comment
  25 beginning with "# End" is appended to each section.
  26
  27 At startup an "[init]" section is printed that shows the status of each database and of mmdbresolve
  28 itself.
  29
  30 == OPTIONS
  31
  32 -f::
  33 Path to a MaxMind Database file. Multiple databases may be specified.
  34
  35 == EXAMPLES
  36
  37 To resolve a single address:
  38
  39     echo 4.4.4.4 | mmdbresolve -f /usr/share/GeoIP/GeoLite2-City.mmdb
  40
  41 .Example output
  42     [init]
  43     db.0.path: /usr/share/GeoIP/GeoLite2-City.mmdb
  44     db.0.status: OK
  45     mmdbresolve.status: true
  46     # End init
  47     [4.4.4.4]
  48     # GeoLite2-City
  49     country.iso_code: US
  50     country.names.en: United States
  51     location.latitude: 37.751000
  52     location.longitude: -97.822000
  53     # End 4.4.4.4
  54
  55 == SEE ALSO
  56
  57 xref:wireshark.html[wireshark](1), xref:tshark.html[tshark](1)
  58
  59 == NOTES
  60
  61 *mmdbresolve* is part of the *Wireshark* distribution. The latest version
  62 of *Wireshark* can be found at https://www.wireshark.org.
  63
  64 HTML versions of the Wireshark project man pages are available at
  65 https://www.wireshark.org/docs/man-pages.
  66
  67 == AUTHORS
  68
  69 .Original Author
  70 [%hardbreaks]
  71 Gerald Combs <gerald[AT]wireshark.org>