NAME
dwmrdapd —
Server to fetch RDAP data
and cache IPv4 to country code mappings
SYNOPSIS
| dwmrdapd |
[-c
configuration_file]
[-p
pid_file]
[-d] |
DESCRIPTION
dwmrdapd is the server portion of a system for storing and
updating IPv4 address to country code mappings. It will query the NIC
registries' RDAP servers when necessary, and stores only the IPv4 address to
country code mappings locally. It may be qeuried for the country code of a
given IPv4 address with
dwmrdapc(1). Other clients
of
dwmrdapd include
mcblockd(8) and
mcflowd(8).
The following command line options are available:
- -c
configuration_file
- Specify the configuration
file. The default is /usr/local/etc/dwmrdapd.conf. See
dwmrdapd.conf(5)
for configuration file syntax.
- -p pid_file
- Specify the process ID (pid)
file. dwmrdapd will store its PID in this file at
startup and remove the file on SIGTERM. The default is
/var/run/dwmrdapd.pid
- -d
- Run in the foreground and emit
syslog messages on stderr.
BOOTSTRAPPING
dwmrdapd(8) does not ship with
a database. It is wise to create one before starting it the first time, to
avoid the latency of RDAP lookups. Some of the registry RDAP servers are
painfully slow (LACNIC in particular). Currently, the database can be created
from a GeoLite2 database by using
geolite2db(1) or an
ipdeny.com database using
ipdeny2db(1).
FILES
- /usr/local/etc/dwmrdapd.conf
- dwmrdapd
configuration file. See
dwmrdapd.conf(5)
for more information and
/usr/local/etc/dwmrdapd.conf.sample for an example.
- /usr/local/var/ipv4country.db
- dwmrdapd
default database file, which may be changed in
dwmrdapd.conf(5).
- /usr/local/etc/dwmrdapd/id_rsa
- dwmrdapd
private key file, created with
dwmauth(1). This file
should be owned by root with permissions 0600. It must contain the private
part of a 2048-bit RSA key pair.
- /usr/local/etc/dwmrdapd/id_rsa.pub
- dwmrdapd
public key file, created with
dwmauth(1). This file
should be owned by root with permissions 0600. It must contain the public
part of a 2048-bit RSA key pair.
- /usr/local/etc/dwmrdapd/authorized_keys
- dwmrdapd
authorized keys file. This file contains a list of public keys (one per
line) that are permitted access to dwmrdapd.
SEE ALSO
dwmrdapd.conf(5),
dwmauth(1),
dwmrdapc(1),
geolite2db(1),
ipdeny2db(1)
COPYRIGHT
Copyright (c) 2017 Daniel W. McRobb
dwm@mcplex.net