knotc (8) - Linux Manuals

knotc: Knot DNS control utility

Command to display knotc manual in Linux: $ man 8 knotc

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.