knotc(8)

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

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

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.