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 /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.

       -i, --interactive
              Interactive mode (do not daemonize).

       -h, --help
              Print help and usage.

   Actions:
       stop   Stop server (no-op if not running).

       reload Reload configuration and changed zones.

       flush  Flush journal and update zone files.

       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)

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.