contrib/bind9/bin/dnssec/dnssec-importkey.8

   1 .\" Copyright (C) 2013  Internet Systems Consortium, Inc. ("ISC")
   2 .\"
   3 .\" Permission to use, copy, modify, and/or distribute this software for any
   4 .\" purpose with or without fee is hereby granted, provided that the above
   5 .\" copyright notice and this permission notice appear in all copies.
   6 .\"
   7 .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
   8 .\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
   9 .\" AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  10 .\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  11 .\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  12 .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  13 .\" PERFORMANCE OF THIS SOFTWARE.
  14 .\"
  15 .\" $Id$
  16 .\"
  17 .hy 0
  18 .ad l
  19 '\" t
  20 .\"     Title: dnssec-importkey
  21 .\"    Author: [see the "AUTHOR" section]
  22 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
  23 .\"      Date: August 30, 2013
  24 .\"    Manual: BIND9
  25 .\"    Source: BIND9
  26 .\"  Language: English
  27 .\"
  28 .TH "DNSSEC\-IMPORTKEY" "8" "August 30, 2013" "BIND9" "BIND9"
  29 .\" -----------------------------------------------------------------
  30 .\" * Define some portability stuff
  31 .\" -----------------------------------------------------------------
  32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33 .\" http://bugs.debian.org/507673
  34 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36 .ie \n(.g .ds Aq \(aq
  37 .el       .ds Aq '
  38 .\" -----------------------------------------------------------------
  39 .\" * set default formatting
  40 .\" -----------------------------------------------------------------
  41 .\" disable hyphenation
  42 .nh
  43 .\" disable justification (adjust text to left margin only)
  44 .ad l
  45 .\" -----------------------------------------------------------------
  46 .\" * MAIN CONTENT STARTS HERE *
  47 .\" -----------------------------------------------------------------
  48 .SH "NAME"
  49 dnssec-importkey \- Import DNSKEY records from external systems so they can be managed\&.
  50 .SH "SYNOPSIS"
  51 .HP 17
  52 \fBdnssec\-importkey\fR [\fB\-f\ \fR\fB\fIfilename\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-P\ \fR\fB\fIdate/offset\fR\fR] [\fB\-D\ \fR\fB\fIdate/offset\fR\fR] [\fB\-h\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fBkeyname\fR]
  53 .SH "DESCRIPTION"
  54 .PP
  55 \fBdnssec\-importkey\fR
  56 read a DNSKEY record and generated a \&.key/\&.private key pair\&. Publication (\fB\-P\fR) and deletions (\fB\-D\fR) times can be set for the key\&.
  57 .SH "OPTIONS"
  58 .PP
  59 \-f \fIfilename\fR
  60 .RS 4
  61 Filename to read the key from\&.
  62 .RE
  63 .PP
  64 \-K \fIdirectory\fR
  65 .RS 4
  66 Sets the directory in which the key files are to reside\&.
  67 .RE
  68 .PP
  69 \-L \fIttl\fR
  70 .RS 4
  71 Sets the default TTL to use for this key when it is converted into a DNSKEY RR\&. If the key is imported into a zone, this is the TTL that will be used for it, unless there was already a DNSKEY RRset in place, in which case the existing TTL would take precedence\&. importkey the default TTL to
  72 0
  73 or
  74 none
  75 removes it\&.
  76 .RE
  77 .PP
  78 \-h
  79 .RS 4
  80 Emit usage message and exit\&.
  81 .RE
  82 .PP
  83 \-v \fIlevel\fR
  84 .RS 4
  85 Sets the debugging level\&.
  86 .RE
  87 .SH "TIMING OPTIONS"
  88 .PP
  89 Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS\&. If the argument begins with a \*(Aq+\*(Aq or \*(Aq\-\*(Aq, it is interpreted as an offset from the present time\&. For convenience, if such an offset is followed by one of the suffixes \*(Aqy\*(Aq, \*(Aqmo\*(Aq, \*(Aqw\*(Aq, \*(Aqd\*(Aq, \*(Aqh\*(Aq, or \*(Aqmi\*(Aq, then the offset is computed in years (defined as 365 24\-hour days, ignoring leap years), months (defined as 30 24\-hour days), weeks, days, hours, or minutes, respectively\&. Without a suffix, the offset is computed in seconds\&. To unset a date, use \*(Aqnone\*(Aq\&.
  90 .PP
  91 \-P \fIdate/offset\fR
  92 .RS 4
  93 Sets the date on which a key is to be published to the zone\&. After that date, the key will be included in the zone but will not be used to sign it\&.
  94 .RE
  95 .PP
  96 \-D \fIdate/offset\fR
  97 .RS 4
  98 Sets the date on which the key is to be deleted\&. After that date, the key will no longer be included in the zone\&. (It may remain in the key repository, however\&.)
  99 .RE
 100 .SH "SEE ALSO"
 101 .PP
 102 \fBdnssec-keygen\fR(8),
 103 \fBdnssec-signzone\fR(8),
 104 BIND 9 Administrator Reference Manual,
 105 RFC 5011\&.
 106 .SH "AUTHOR"
 107 .PP
 108 Internet Systems Consortium
 109 .SH "COPYRIGHT"
 110 .br
 111 Copyright \(co 2013 Internet Systems Consortium, Inc. ("ISC")
 112 .br