Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CREDNSC(8)			CREDNSC	0.2.10			    CREDNSC(8)

NAME
       crednsc - credns	control	script.

SYNOPSIS
       crednsc	[-c  configfile]  start	 | stop	| reload | rebuild | restart |
       running | update	| notify | patch

DESCRIPTION
       Crednsc is the shell script that	used to	control	credns(8) and zonec(8)
       from  credns  distribution.  Crednsc is also suitable to	be linked into
       /etc/rc.d directory on  BSD  like  systems  for	automatic  startup  of
       credns(8) at boot time.

       At  every  invokation, crednsc will try to read the credns.conf(5) con-
       figuration file.	An example of such configuration file  is  distributed
       with  the  credns  package  as  credns.conf.sample.  The	config file is
       checked for errors before it is used, see credns-checkconf(8).

       Possible	crednsc	applications are:

       start  Start credns(8).

       stop   Shut down	credns(8) by sending SIGTERM to	it.

       reload Initiate credns(8) name space database reload by sending SIGHUP.

       rebuild
	      Rebuild the credns(8) database by	invoking zonec(8) with	appro-
	      priate arguments.

       restart
	      Restart  crednsc(8).  This  equals  to  crednsc  stop && crednsc
	      start.

       running
	      Check whether credns(8) is running. Returns  error  message  and
	      error  code  if it is not	running, and no	message	and zero error
	      code otherwise.

       update Updates all the slave zones which	have allow-notify: from	local-
	      host (127.0.0.1 or ::1) allowed.	If a TSIG key is specified for
	      the allow-notify statement in the	config file, it	will  be  used
	      to secure	the notify. Note that credns keeps track of zone time-
	      outs automatically, this is only needed if you want to  manually
	      force updates by sending notify messages to the localhost.

	      Another  method  you  can	 use  is  to  stop  credns, delete the
	      xfrd.state file and then start credns again. It will try to  up-
	      date  all	 zones.	  This	method	does not require allow-notify:
	      statements.

       notify Sends notify messages to all the slaves for all the  zones  that
	      have  the	notify:	keyword	in the credns.conf file. If a TSIG key
	      is specified for a notify	statement, it will be used  to	secure
	      the notification message to that slave server.

       patch  Merge  zone transfer changes back	to zone	files. It reads	in the
	      credns database (credns.db) and difffile	(ixfr.db),  and	 over-
	      writes  the  zone	 text files if they have been updated. Running
	      this regularly ensures that the difffile does  not  grow	infin-
	      itely. If	any zone text files have been changed (including those
	      of the master zones), the	credns.db is  rebuild  and  credns  is
	      reloaded.

OPTIONS
       -c configfile
	      Specify  configfile  to  use  instead  of	 the  default /usr/lo-
	      cal/etc/credns/credns.conf.

FILES
       /usr/local/etc/credns/credns.conf
	      Configuration file for credns to change  default	pathnames  and
	      credns flags. The	zone names, pathnames to zone files and	access
	      control lists are	also in	credns.conf(5).

       /var/db/nsd/nsd.db
	      default credns database

       /var/db/nsd/nsd.db.lock
	      Lockfile for the credns database access by operator tools.

       /var/db/nsd/ixfr.db
	      Journal of zone transfers, the diff file containing the new zone
	      contents transferred.

       /var/db/nsd/xfrd.state
	      State  for  the zone transfer process of credns.	Contains time-
	      outs for the zones and whether zones are expired.

       /var/run/nsd/nsd.pid
	      the process id of	the name server.

DIAGNOSTICS
       Crednsc will return zero	return code if operation was successful	and an
       error message to	standard output	plus a non-zero	return code otherwise.

SEE ALSO
       credns(8),   credns.conf(5),   credns-checkconf(8),   credns-notify(8),
       credns-patch(8),	credns-xfer(8)

AUTHORS
       Credns was written by NLnet Labs.

       NSD was written by NLnet	Labs and RIPE NCC joint	team. Please see CRED-
       ITS file	in the distribution for	further	details.

BUGS
       Syntax  checking	 of  the config	file is	rudimentary and	error messages
       may be wrong. If	you do a crednsc patch,	whilst a (long)	zone  transfer
       is  busy,  the  zone  transfer contents will be partially lost. After a
       reload,	this  will  be	detected  and  the  zone  transfer  should  be
       restarted.  The	reload	that  happens at the end of crednsc patch also
       frees up	memory churn in	credns caused by zone transfers.

NLnet Labs			 jun 22, 2012			    CREDNSC(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | DIAGNOSTICS | SEE ALSO | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=crednsc&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help