NAME

       knotc - Knot DNS control utility

SYNOPSIS

       knotc [parameters] action [action_args]

DESCRIPTION

   Parameters
       -c, --config file
              Use a textual configuration file (default is @config_dir@/knot.conf).

       -C, --confdb directory
              Use  a  binary  configuration  database  directory (default is @storage_dir@/confdb).  The default
              configuration database, if exists, has a preference to the default configuration file.

       -s, --socket path
              Use a remote control UNIX socket path (default is @run_dir@/knot.sock).

       -f, --force
              Forced operation. Overrides some checks.

       -v, --verbose
              Enable debug output.

       -h, --help
              Print the program help.

       -V, --version
              Print the program version.

   Actions
       status Check if the server is running.

       stop   Stop the server if running.

       reload Reload the server configuration and modified zone files.

       zone-check [zone...]
              Test if  the  server  can  load  the  zone.  Semantic  checks  are  executed  if  enabled  in  the
              configuration. (*)

       zone-memstats [zone...]
              Estimate memory use for the zone. (*)

       zone-status [zone...]
              Show the zone status. (*)

       zone-reload [zone...]
              Trigger  a  zone  reload  from  a disk without checking its modification time. For slave zone, the
              refresh from a master server is scheduled; for master zone, the notification of slave  servers  is
              scheduled.

       zone-refresh [zone...]
              Trigger  a  check  for  the  zone  serial  on the zone's master. If the master has a newer zone, a
              transfer is scheduled. This command is valid for slave zones.

       zone-retransfer [zone...]
              Trigger a zone transfer from the zone's master.  The  server  doesn't  check  the  serial  of  the
              master's zone. This command is valid for slave zones.

       zone-flush [zone...]
              Trigger a zone journal flush into the zone file.

       zone-sign [zone...]
              Trigger  a DNSSEC re-sign of the zone. Existing signatures will be dropped.  This command is valid
              for zones with automatic DNSSEC signing.

       conf-init
              Initialize the configuration database. (*)

       conf-check
              Check the server configuration. (*)

       conf-import filename
              Import a configuration file into the configuration database. Ensure the server is  not  using  the
              configuration database! (*)

       conf-export filename
              Export the configuration database into a config file. (*)

       conf-list [item]
              List the configuration database sections or section items.

       conf-read [item]
              Read the item from the active configuration database.

       conf-begin
              Begin a writing configuration database transaction. Only one transaction can be opened at a time.

       conf-commit
              Commit the configuration database transaction.

       conf-abort
              Rollback the configuration database transaction.

       conf-diff [item]
              Get the item difference in the transaction.

       conf-get [item]
              Get the item data from the transaction.

       conf-set item [data...]
              Set the item data in the transaction.

       conf-unset [item] [data...]
              Unset the item data in the transaction.

NOTE

       Empty zone parameter means all zones.

       Type item parameter in the form of section[[id]][.name].

       (*) indicates a local operation which requires a configuration.

EXAMPLES

   Reload the whole server configuration
          $ knotc reload

   Flush the example.com and example.org zones
          $ knotc zone-flush example.com example.org

   Get the current server configuration
          $ knotc conf-read server

   Get the list of the current zones
          $ knotc conf-read zone.domain

   Get the master remotes for the example.com zone
          $ knotc conf-read 'zone[example.com].master'

   Add example.org zone with a zonefile location
          $ knotc conf-begin
          $ knotc conf-set 'zone[example.org]'
          $ knotc conf-set 'zone[example.org].file' '/var/zones/example.org.zone'
          $ knotc conf-commit

SEE ALSO

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

AUTHOR

       CZ.NIC Labs <http://www.knot-dns.cz>

COPYRIGHT

       Copyright 2010–2016, CZ.NIC, z.s.p.o.

2.1.1                                              2016-02-10                                           KNOTC(8)