Man page of QSGEO
Author: Pascal Buchbinder
Keywords: Quality of Service, QoS, Apache Web Server, Web application security, WAF, Open Source Software, Security, Proxy

# QSGEO

Section: qsgeo man page (1)
Updated: February 2026
Index Return to Main Contents

## NAME

qsgeo - an utility to lookup a client's country code.

## SYNOPSIS

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

## DESCRIPTION

Use this utility to resolve the country codes of IP addresses within existing log files. The utility reads the log file data from stdin and writes them, with the injected country code, to stdout.

## OPTIONS

-d <path>
  Specifies the path to the geographical database files (CSV file containing IP address ranges and country codes).
-s
  Writes a summary of the requests per country only.
-l
  Writes the database to stdout (ignoring stdin) inserting local (127.*) and private (10.*, 172.16*, 192.168.*) network addresses.
-ip <ip>
  Resolves a single IP address instead of processing a log file.

## 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 ALSO

qslog(1), qsre(1), qsrespeed(1)

## AUTHOR

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

## Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO
AUTHOR