knotc (8) - Linux Man Pages

knotc: Knot DNS control utility

NAME

knotc - Knot DNS control utility

SYNOPSIS

knotc [parameters] action [action_args]

DESCRIPTION

Parameters:

-c, --config file
Select configuration file.
-s server
Remote UNIX socket/IP address (default /var/run/knot/knot.sock).
-p port
Remote server port (only for IP).
-y [hmac:]name:key
Use key specified on the command line (default algorithm is hmac-md5).
-k file
Use key file (as in config section 'keys').
-f, --force
Force operation - override some checks.
-v, --verbose
Verbose mode - additional runtime information.
-V, --version
Print version of the server.
-h, --help
Print help and usage.

Actions:

stop
Stop server (no-op if not running).
reload [zone]...
Reload configuration and changed zones (all if not specified).
flush [zone]...
Flush journal and update zone files (all if not specified).
status
Check if server is running.
zonestatus
Show status of configured zones.
refresh [zone]...
Refresh slave zones (all if not specified).
checkconf
Check current server configuration.
checkzone [zone]...
Check zone (all if not specified).
memstats [zone]...
Estimate memory consumption for zone (all if not specified).

EXAMPLES

Setup a keyfile for remote control
1. Generate key:
# dnssec-keygen -a hmac-md5 -b 256 -n HOST knotc-key
2. Extract secret in base64 format and create keyfile:
# echo "knotc-key hmac-md5 <secret>" > knotc.key
Make sure the key can be read/written only by the owner for security reasons.
Reload server remotely
# knotc -s 127.0.0.1 -k knotc.key reload

NOTE

The full documentation for Knot DNS is maintained as a Texinfo manual. If the info program is properly installed at your site, the info Knot command should give you an access to the complete manual.

SEE ALSO

knotd(8), knot.conf(5).