knotc [parameters] action [action_args]
If no action is specified, the program is executed in interactive mode.
Empty or – zone parameter means all zones or all zones with a transaction.
Use @ owner to denote the zone name.
Type item parameter in the form of section[[id]][.name].
(*) indicates a local operation which requires a configuration.
(#) indicates an optionally blocking operation.
The -b and -f options can be placed right after the command name.
Responses returned by knotc commands depend on the mode:
Actions zone-flush, zone-backup, and zone-restore are carried out by the knotd process. The directory specified must be accessible to the user account that knotd runs under and if the directory already exists, its permissions must be appropriate for that user account.
The utility provides interactive mode with basic line editing functionality, command completion, and command history.
Interactive mode behavior can be customized in ~/.editrc. Refer to editrc(5) for details.
Command history is saved in ~/.knotc_history.
Exit status of 0 means successful operation. Any other exit status indicates an error.
$ knotc reload
$ knotc zone-flush example.com example.org
$ knotc conf-read server
$ knotc conf-read zone.domain
$ knotc conf-read 'zone[example.com].master'
$ knotc conf-begin
$ knotc conf-set 'zone[example.org]'
$ knotc conf-set 'zone[example.org].file' '/var/zones/example.org.zone'
$ knotc conf-commit
$ knotc zone-read -- @ SOA
knotd(8), knot.conf(5), editrc(5).