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