location-query - Query the location database


location-query lookup ADDRESS [ADDRESS...]
location-query get-as ASN [ASN...]
location-query search-as STRING
location-query list-networks-by-as ASN
location-query list-networks-by-cc COUNTRY_CODE
location-query list-networks-by-flags [--anonymous-proxy|--satellite-provider|--anycast]


The location-query retrieves information from the location database. This data can be used to determine someone’s location on the Internet and for building firewall rulesets to block access from certain ASes or countries.


--database FILE

The path of the database which is being opened.
If this option is omitted, the system’s database will be opened.


Enable debugging mode



This command returns the network the given IP address has been found in as well as its Autonomous System if that information is available.

get-as ASN [ASN…]

This command returns the name of the owning organisation of the Autonomous System.

search-as STRING

Lists all Autonomous Systems which match the given string.
The search will be performed case-insensitively.

list-networks-by-as [--family=[ipv6|ipv4]] [--output-format FORMAT] ASN

Lists all networks which belong to this Autonomous System.
The --family parameter can be used to filter output to only IPv6 or IPv4 addresses.
The --output-format parameter can change the output so that it can be directly loaded into other software. The following options are available:

  • list (default): Just lists all networks, one per line

  • ipset: For ipset

  • nftables: For nftables

  • xt_geoip: Returns a list of networks to be loaded into the xt_geoip kernel module

list-networks-by-cc [--family=[ipv6|ipv4]] [--output-format FORMAT] COUNTRY_CODE

Lists all networks that belong to a country.
The country has to be encoded in ISO3166 Alpha-2 notation.
See above for usage of the --family and --output-format parameters.

list-networks-by-flags [--family=[ipv6|ipv4]] [--output-format FORMAT] [--anonymous-proxy|--satellite-provider|--anycast]

Lists all networks that have a certain flag.
See above for usage of the --family and --output-format parameters.


Shows a short help text on using this program.


Shows the program’s version and exists.


The location-query command will normally exit with code zero. If there has been a problem and the requested action could not be performed, the exit code is unequal to zero.


Please report all bugs to the bugtracker at


Michael Tremer