SYNOPSIS

knotc [parameters] action [action_args]

DESCRIPTION

Parameters:

-c, --config file

Select configuration file.

-s server

Remote UNIX socket/IP address (default /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.