AIRPORTSD(8) AIRPORTSD(8)
NAME
airportsd ‐ IATA airport code lookup server
SYNOPSIS
airportsd [‐v]
DESCRIPTION
airportsd is an HTTP‐accessible IATA airport code lookup daemon. We
created this as a service students can use on lab machines for develop‐
ing an Ansible lookup plugin during trainings.
When running on a tty the program will output brief debugging informa‐
tion on startup, and when it’s queried.
The (currently hard‐coded) CDB database must exist and be readable by
the owner of the airportsd process.
EXAMPLE
$ curl ‐i http://127.0.0.1:8812/lookup?iata=bcn
HTTP/1.1 200 OK
Connection: Keep‐Alive
Content‐Length: 166
Content‐Type: application/json
Date: Fri, 02 Oct 2020 09:49:30 GMT
{
"id": "4004",
"iata": "BCN",
"cc": "ES",
"city": "Barcelona",
"lat": "41.2971",
"lon": "2.07846",
"name": "Barcelona International Airport",
"type": "large_airport"
}
ENDPOINTS
All airportsd API endpoints are obtained via GET requests.
lookup
This endpoint expects iata query parameter with a case insensitive
3‐letter IATA airport code; the key is looked up in the database and
the JSON data or HTTP status code 404 are returned.
OPTIONS
airportsd understands the following global options.
‐v show version information and exit
ENVIRONMENT
AIRPORTSD_IP
optionally sets the listen address for airportsd; defaults to
127.0.0.1 and we strongly recommend this is not changed to any‐
thing other than a loopback address.
AIRPORTSD_PORT
optionally sets the TCP listen port to something other than the
default 8812.
FILES
/usr/local/share/airports.cdb
the database file to query.
REQUIREMENTS
freebsd
$ pkg install libmicrohttpd tinycdb
$ cat > config.mk <<EOF
DBNAME= "/usr/local/share/airports.cdb"
LISTEN_HOST= "127.0.0.1"
LISTEN_PORT= "8812"
INC = ‐I/usr/local/include
LIBS = ‐L /usr/local/lib
EOF
rhel/centos
yum install tinycdb
debian
apt‐get install tinycdb
macos
brew install libmicrohttpd tinycdb
all
· libmicrohttpd (https://www.gnu.org/software/libmicrohttpd/)
· tinycdb (http://www.corpit.ru/mjt/tinycdb.html)
CREDITS
· Airport data gratefully put into the Public Domain by ourairports.com
(https://ourairports.com/data/).
AVAILABILITY
<https://github.com/jpmens/airportsd>
AUTHOR
Jan‐Piet Mens <https://jpmens.net>
User Manuals AIRPORTSD(8)