QSGEO(1)

📦
version 11.79 · 4 versions
, in ubuntu stonking

💖 QSGEO(1) 💖

okay bestie, welcome to the qsgeo corner of the qsgeo man page, it's giving ✨country-code-detective✨ energy and honestly? obsessed.

🌸 NAME 🌸

qsgeo — a little utility that looks up a client's country code. no cap, that's the whole job 💅

🎀 SYNOPSIS 🎀

qsgeo -d <path> [-l] [-s] [-ip <ip>]

like, look at her. four flags max. she's lowkey iconic for that 🫶

🦋 DESCRIPTION 🦋

so here's the vibe: you use this utility to resolve the country codes of IP addresses that are already chilling inside your existing log files. 🗺️

it reads the log file data from stdin and writes it back out to stdout, but with the country code injected in there. like a little glow-up for every line. periodt. 💖

✨ OPTIONS ✨

  • -d <path> — tells it where the geographical database files live. specifically: the path to a CSV file containing IP address ranges and country codes. that's the whole map, bestie 🗺️
  • -s — writes a summary of the requests per country only. like the cliff notes version, no full line-by-line drama 🙈
  • -l — writes the database itself to stdout, ignoring stdin, and inserts local (127.*) and private (10.*, 172.16*, 192.168.*) network addresses while it's at it. she's doing the most and honestly? slay 👑
  • -ip <ip> — resolves a single IP address instead of processing a whole log file. main character energy for exactly one IP 🌟

🌈 EXAMPLE 🌈

Reading the file access.log and adding the country code to the IP address field:

cat access.log | qsgeo -d GeoIPCountryWhois.csv

Reading the file access.log and showing a summary only:

cat access.log | qsgeo -d GeoIPCountryWhois.csv -s

Resolving a single IP address:

qsgeo -d GeoIPCountryWhois.csv -ip 192.84.12.23

see how clean that is?? chef's kiss, ate, no crumbs 🔥

💜 SEE ALSO 💜

the whole friend group fr fr 🫶 go say hi

🎀 AUTHOR 🎀

Pascal Buchbinder, http://mod-qos.sourceforge.net/

the way he built this whole thing… king behavior 👑

and that's the whole page, bestie!! this was brought to you by the mod_qos utilities, version 11.79, dated May 2026 — mwah, drink some water, and go resolve some country codes 💅✨🦋💖

📦 where this page comes from