IP2LOCATION(1)

📦
version 8.7.0 · 3 versions
, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

🌸 NAME

okay so bestie, gather round 💖 — ip2location is the command that queries IP address information from a local IP2Location BIN data file. that's it, that's the whole job, and it does it flawlessly. periodt. 💅

✨ SYNOPSIS

ip2location --data-file [IP2LOCATION BIN DATA PATH] --ip [IP ADDRESS] [OPTIONS]

💖 DESCRIPTION

so here's the tea, fr fr: ip2location reads an IP address — and yes, it takes IPv4 or IPv6 address format, we're inclusive here 🦋 — and then it goes and pulls the info out of an IP2Location BIN data file so it can show it to you. that's the whole main character arc. 👑

and like, you're not stuck typing IPs one by one either. you can hand it the IP address as standard input, or point it at a file containing one IP address per line. group-chat energy, one IP per message, you know how it is. 🙈

it also speaks several output formats, so pick your aesthetic: CSV, TAB and XML. slay. ✨

you can download the IP2Location BIN data file from http://www.ip2location.com or http://lite.ip2location.com — go get your data, bestie, it's not gonna download itself. 🎀

🎀 EXAMPLES

✨ query one IP, get results on screen

ip2location --data-file [IP2LOCATION BIN DATA PATH] --ip [IP ADDRESS]

Query an IP address and display the results on screen — the classic. the starter pack. 🍓

💜 query a whole file of IPs

ip2location --data-file [IP2LOCATION BIN DATA PATH] --input-file [INPUT FILE PATH]

Query all IP addresses from an input file and display the results on screen — batch mode, lowkey efficient. 💅

🌈 same thing but make it XML

ip2location --data-file [IP2LOCATION BIN DATA PATH] --input-file [INPUT FILE PATH] --format XML

Query all IP addresses from an input file and display the results in XML format on screen — tags on tags on tags. ✨

🦋 TAB format, but write it to a file

ip2location --data-file [IP2LOCATION BIN DATA PATH] --input-file [INPUT FILE PATH] --format TAB --output-file [OUTPUT FILE PATH]

Query all IP addresses from an input file and output the result to a file in TAB format — save it for later, queen. 👑

🌸 one IP, one field, no heading

ip2location --data-file [IP2LOCATION BIN DATA PATH] --ip [IP ADDRESS] --field country_code -0-heading

Query an IP address and display the country_short result — minimal, clean, obsessed. 💖

⭐ two fields, TAB, still no heading

ip2location --data-file [IP2LOCATION BIN DATA PATH] --ip [IP ADDRESS] --field country_code,city_name -0-heading --format TAB

Query an IP address and display the country_short and city result — now we're cooking. 🔥

👑 OPTIONS

  • -b, --bin-version — print the IP2Location BIN database version. the data file's lil birth certificate. 🎀
  • -d, --data-file — specify the path of the IP2Location .BIN data file. this is the file, you need it. 🫶
  • -i, --input-file — specify an input file with IP address list. one IP per line, bestie.
  • -p, --ip — specify an IP address query (supported IPv4 and IPv6 address). 🌈
  • -o, --output-file — specify output file for query results. where the results go to live their life. ✨
  • -f, --format — specify output format. supported formats are:
    • CSV (default) — the no-thoughts-just-vibes choice
    • TAB
    • XML
  • -h, -?, --help — display this help file. we love a helpful icon. 💅
  • -v, --version — display the version number.
  • -e, --field — specify the field to be displayed. supported values are:
    • ip
    • country_code
    • country_name
    • region_name
    • city_name
    • isp
    • latitude
    • longitude
    • domain
    • zip_code
    • time_zone
    • net_speed
    • idd_code
    • area_code
    • weather_station_code
    • weather_station_name
    • mcc
    • mnc
    • mobile_brand
    • elevation
    • usage_type
    • address_type
    • category
    • district
    • asn
    • as
  • -n, -0-heading — suppress the heading display. bye bye header row, we barely knew ye. 💀

🫶 AUTHORS

this tool was created by IP2Location (https://www.ip2location.com). give them their flowers, they earned them. 🌸

Copyright 2001-2024 IP2Location.com

this tool is licensed under MIT. go wild, just be cool about it. 🎀

okay so that's the whole page, bestie 💖 this was IP2LOCATION(1), living in the General Commands Manual, and the footer is literally just IP2LOCATION(1) again because the page said everything it needed to say. no notes. iconic. slay. 🦋✨

📦 where this page comes from