dnssec-signzone(1M)					  System Administration Commands				       dnssec-signzone(1M)

NAME

       dnssec-signzone - DNSSEC zone signing tool

SYNOPSIS

       dnssec-signzone	[-ahpt]  [-c  class] [-d directory] [-s start-time] [-e end-time] [-f output-file] [-i interval] [-n nthreads] [-o origin]
       [-r randomdev] [-v level] zonefile [key...]

DESCRIPTION

       The dnssec-signzone utility signs a zone. It generates NXT and SIG records and produces a signed version of the zone. If there is a signed-
       key  file from the zone's parent, the parent's signatures is incorporated into the generated signed zone file. The security status of dele-
       gations from the signed zone (that is, whether the child zones are secure or not) is determined by the presence or absence of  a  signedkey
       file for each child zone.

OPTIONS

       The following options are supported:

       -a	       Verify all generated signatures.

       -c class        Specify the DNS class of the zone.

       -d directory    Look for signedkey files in directory.

       -e end-time     Specify	the  date  and	time  when  the generated SIG records expire. As with start-time, an absolute time is indicated in
		       YYYYMMDDHHMMSS notation. A time relative to the start time is indicated with +N, which is N seconds from the start time.  A
		       time relative to the current time is indicated with now+N. If no end-time is specified, 30 days from the start time is used
		       as a default.

       -f output-file  The name of the output file containing the signed zone. The default is to append .signed to the input file.

       -h	       Prints a short summary of the options and arguments to dnssec-signzone().

       -i interval     Specify the cycle interval as an offset from the current time (in seconds). When a previously  signed  zone  is	passed	as
		       input,  records	could be resigned. If a SIG record expires after the cycle interval, it is retained. Otherwise, it is con-
		       sidered to be expiring soon and will be replaced.  The default cycle interval is one quarter of the difference between  the
		       signature  end  and start times. If neither end-time or start-time are specified, dnssec-signzone generates signatures that
		       are valid for 30 days, with a cycle interval of 7.5 days. Any existing SIG records due to expire  in  less  than  7.5  days
		       would be replaced.

       -n ncpus        Specify the number of threads to use. By default, one thread is started for each detected CPU.

       -o origin       Specify the zone origin. If not specified, the name of the zone file is assumed to be the origin.

       -p	       Use pseudo-random data when signing the zone. This is faster, but less secure, than using real random data. This option can
		       be useful when signing large zones or when the entropy source is limited.

       -r randomdev    Specify the source of randomness. If the operating system does not provide a /dev/random or equivalent device, the  default
		       source  of randomness is keyboard input. The randomdev argument specifies the name of a character device or file containing
		       random data to be used instead of the default. The special value keyboard indicates that keyboard input should be used.

       -s start-time   Specify the date and time when the generated SIG records become valid. This can be either an absolute or relative time.	An
		       absolute  start	time is indicated by a number in YYYYMMDDHHMMSS notation; 20000530144500 denotes 14:45:00 UTC on May 30th,
		       2000. A relative start time is indicated by +N, which is N seconds from the current time. If no	start-time  is	specified,
		       the current time is used.

       -t	       Print statistics at completion.

       -v level        Set the debugging level.

OPERANDS

       The following options are supported:

       zonefile        The file containing the zone to be signed. This file sets the debugging level.

       key	       The  keys  used to sign the zone. If no keys are specified, the default is all zone keys that have private key files in the
		       current directory.

EXAMPLES

       Example 1: Sign a zone with a DSA key.

       The following command signs the example.com zone with the DSA key generated in the example on the dnssec-keygen(1M) manual page. The zone's
       keys must be in the zone. If there are signedkey files associated with this zone or any child zones, they must be in the current directory.

       dnssec-signzone -o example.com db.example.com

       The command would print a string of the form:

       Kexample.com.+003+26160

       In this example, dnssec-signzone creates the file db.example.com.signed. This file should be referenced in a zone statement in a named.conf
       file.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWbind9 		   |
       |Interface Stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       dnssec-keygen(1M), dnssec-signkey(1M), attributes(5)

       RFC 2535

       BIND 9 Administrator Reference Manual

NOTES

       Source for BIND9 is available in the SUNWbind9S package.

SunOS 5.10							    15 Dec 2004 					       dnssec-signzone(1M)