Annotation of embedaddon/ntp/util/ntp-keygen-opts.texi, revision 1.1

1.1     ! misho       1: @node ntp-keygen Invocation
        !             2: @section Invoking ntp-keygen
        !             3: @pindex ntp-keygen
        !             4: @cindex Create a NTP host key
        !             5: @ignore
        !             6: # 
        !             7: # EDIT THIS FILE WITH CAUTION  (ntp-keygen-opts.texi)
        !             8: # 
        !             9: # It has been AutoGen-ed  December 24, 2011 at 06:34:45 PM by AutoGen 5.12
        !            10: # From the definitions    ntp-keygen-opts.def
        !            11: # and the template file   aginfo.tpl
        !            12: @end ignore
        !            13: This program has no explanation.
        !            14: 
        !            15: If there is no new host key, look for an existing one.
        !            16: If one is not found, create it.
        !            17: 
        !            18: This section was generated by @strong{AutoGen},
        !            19: the aginfo template and the option descriptions for the @command{ntp-keygen} program.  It documents the @command{ntp-keygen} usage text and option meanings.
        !            20: 
        !            21: This software is released under a specialized copyright license.
        !            22: 
        !            23: @menu
        !            24: * ntp-keygen usage::                  ntp-keygen usage help (-?)
        !            25: * ntp-keygen certificate::           certificate option (-c)
        !            26: * ntp-keygen debug-level::           debug-level option (-d)
        !            27: * ntp-keygen get-pvt-passwd::        get-pvt-passwd option (-q)
        !            28: * ntp-keygen gq-params::             gq-params option (-G)
        !            29: * ntp-keygen host-key::              host-key option (-H)
        !            30: * ntp-keygen id-key::                id-key option (-e)
        !            31: * ntp-keygen iffkey::                iffkey option (-I)
        !            32: * ntp-keygen issuer-name::           issuer-name option (-i)
        !            33: * ntp-keygen md5key::                md5key option (-M)
        !            34: * ntp-keygen modulus::               modulus option (-m)
        !            35: * ntp-keygen mv-keys::               mv-keys option (-v)
        !            36: * ntp-keygen mv-params::             mv-params option (-V)
        !            37: * ntp-keygen pvt-cert::              pvt-cert option (-P)
        !            38: * ntp-keygen pvt-passwd::            pvt-passwd option (-p)
        !            39: * ntp-keygen set-debug-level::       set-debug-level option (-D)
        !            40: * ntp-keygen sign-key::              sign-key option (-S)
        !            41: * ntp-keygen subject-name::          subject-name option (-s)
        !            42: * ntp-keygen trusted-cert::          trusted-cert option (-T)
        !            43: @end menu
        !            44: 
        !            45: @node ntp-keygen usage
        !            46: @subsection ntp-keygen usage help (-?)
        !            47: @cindex ntp-keygen usage
        !            48: 
        !            49: This is the automatically generated usage text for ntp-keygen:
        !            50: 
        !            51: @exampleindent 0
        !            52: @example
        !            53: ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.6p5
        !            54: USAGE:  ntp-keygen [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
        !            55:   Flg Arg Option-Name    Description
        !            56:    -c Str certificate    certificate scheme
        !            57:    -d no  debug-level    Increase output debug message level
        !            58:                                 - may appear multiple times
        !            59:    -D Str set-debug-level Set the output debug message level
        !            60:                                 - may appear multiple times
        !            61:    -e no  id-key         Write IFF or GQ identity keys
        !            62:    -G no  gq-params      Generate GQ parameters and keys
        !            63:    -H no  host-key       generate RSA host key
        !            64:    -I no  iffkey         generate IFF parameters
        !            65:    -i Str issuer-name    set issuer name
        !            66:    -M no  md5key         generate MD5 keys
        !            67:    -m Num modulus        modulus
        !            68:                                 - It must be in the range:
        !            69:                                   256 to 2048
        !            70:    -P no  pvt-cert       generate PC private certificate
        !            71:    -p Str pvt-passwd     output private password
        !            72:    -q Str get-pvt-passwd input private password
        !            73:    -S Str sign-key       generate sign key (RSA or DSA)
        !            74:    -s Str subject-name   set subject name
        !            75:    -T no  trusted-cert   trusted certificate (TC scheme)
        !            76:    -V Num mv-params      generate <num> MV parameters
        !            77:    -v Num mv-keys        update <num> MV keys
        !            78:       opt version        Output version information and exit
        !            79:    -? no  help           Display extended usage information and exit
        !            80:    -! no  more-help      Extended usage information passed thru pager
        !            81:    -> opt save-opts      Save the option state to a config file
        !            82:    -< Str load-opts      Load options from a config file
        !            83:                                 - disabled as --no-load-opts
        !            84:                                 - may appear multiple times
        !            85: 
        !            86: Options are specified by doubled hyphens and their name or by a single
        !            87: hyphen and the flag character.
        !            88: 
        !            89: The following option preset mechanisms are supported:
        !            90:  - reading file $HOME/.ntprc
        !            91:  - reading file ./.ntprc
        !            92:  - examining environment variables named NTP_KEYGEN_*
        !            93: 
        !            94: If there is no new host key, look for an existing one.  If one is not
        !            95: found, create it.
        !            96: 
        !            97: please send bug reports to:  http://bugs.ntp.org, bugs@@ntp.org
        !            98: @end example
        !            99: @exampleindent 4
        !           100: 
        !           101: @node ntp-keygen certificate
        !           102: @subsection certificate option (-c)
        !           103: @cindex ntp-keygen-certificate
        !           104: 
        !           105: This is the ``certificate scheme'' option.
        !           106: 
        !           107: This option has some usage constraints.  It:
        !           108: @itemize @bullet
        !           109: @item
        !           110: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           111: @end itemize
        !           112: 
        !           113: scheme is one of
        !           114: RSA-MD2, RSA-MD5, RSA-SHA, RSA-SHA1, RSA-MDC2, RSA-RIPEMD160,
        !           115: DSA-SHA, or DSA-SHA1.
        !           116: 
        !           117: Select the certificate message digest/signature encryption scheme.
        !           118: Note that RSA schemes must be used with a RSA sign key and DSA
        !           119: schemes must be used with a DSA sign key.  The default without
        !           120: this option is RSA-MD5.
        !           121: 
        !           122: @node ntp-keygen debug-level
        !           123: @subsection debug-level option (-d)
        !           124: @cindex ntp-keygen-debug-level
        !           125: 
        !           126: This is the ``increase output debug message level'' option.
        !           127: 
        !           128: This option has some usage constraints.  It:
        !           129: @itemize @bullet
        !           130: @item
        !           131: may appear an unlimited number of times.
        !           132: @end itemize
        !           133: 
        !           134: Increase the debugging message output level.
        !           135: 
        !           136: @node ntp-keygen get-pvt-passwd
        !           137: @subsection get-pvt-passwd option (-q)
        !           138: @cindex ntp-keygen-get-pvt-passwd
        !           139: 
        !           140: This is the ``input private password'' option.
        !           141: 
        !           142: This option has some usage constraints.  It:
        !           143: @itemize @bullet
        !           144: @item
        !           145: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           146: @end itemize
        !           147: 
        !           148: Set the password for reading files to the specified password.
        !           149: 
        !           150: @node ntp-keygen gq-params
        !           151: @subsection gq-params option (-G)
        !           152: @cindex ntp-keygen-gq-params
        !           153: 
        !           154: This is the ``generate gq parameters and keys'' option.
        !           155: 
        !           156: This option has some usage constraints.  It:
        !           157: @itemize @bullet
        !           158: @item
        !           159: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           160: @end itemize
        !           161: 
        !           162: Generate parameters and keys for the GQ identification scheme,
        !           163: obsoleting any that may exist.
        !           164: 
        !           165: @node ntp-keygen host-key
        !           166: @subsection host-key option (-H)
        !           167: @cindex ntp-keygen-host-key
        !           168: 
        !           169: This is the ``generate rsa host key'' option.
        !           170: 
        !           171: This option has some usage constraints.  It:
        !           172: @itemize @bullet
        !           173: @item
        !           174: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           175: @end itemize
        !           176: 
        !           177: Generate new host keys, obsoleting any that may exist.
        !           178: 
        !           179: @node ntp-keygen id-key
        !           180: @subsection id-key option (-e)
        !           181: @cindex ntp-keygen-id-key
        !           182: 
        !           183: This is the ``write iff or gq identity keys'' option.
        !           184: 
        !           185: This option has some usage constraints.  It:
        !           186: @itemize @bullet
        !           187: @item
        !           188: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           189: @end itemize
        !           190: 
        !           191: Write the IFF or GQ client keys to the standard output.  This is
        !           192: intended for automatic key distribution by mail.
        !           193: 
        !           194: @node ntp-keygen iffkey
        !           195: @subsection iffkey option (-I)
        !           196: @cindex ntp-keygen-iffkey
        !           197: 
        !           198: This is the ``generate iff parameters'' option.
        !           199: 
        !           200: This option has some usage constraints.  It:
        !           201: @itemize @bullet
        !           202: @item
        !           203: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           204: @end itemize
        !           205: 
        !           206: Generate parameters for the IFF identification scheme, obsoleting
        !           207: any that may exist.
        !           208: 
        !           209: @node ntp-keygen issuer-name
        !           210: @subsection issuer-name option (-i)
        !           211: @cindex ntp-keygen-issuer-name
        !           212: 
        !           213: This is the ``set issuer name'' option.
        !           214: 
        !           215: This option has some usage constraints.  It:
        !           216: @itemize @bullet
        !           217: @item
        !           218: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           219: @end itemize
        !           220: 
        !           221: Set the suject name to name.  This is used as the subject field
        !           222: in certificates and in the file name for host and sign keys.
        !           223: 
        !           224: @node ntp-keygen md5key
        !           225: @subsection md5key option (-M)
        !           226: @cindex ntp-keygen-md5key
        !           227: 
        !           228: This is the ``generate md5 keys'' option.
        !           229: Generate MD5 keys, obsoleting any that may exist.
        !           230: 
        !           231: @node ntp-keygen modulus
        !           232: @subsection modulus option (-m)
        !           233: @cindex ntp-keygen-modulus
        !           234: 
        !           235: This is the ``modulus'' option.
        !           236: 
        !           237: This option has some usage constraints.  It:
        !           238: @itemize @bullet
        !           239: @item
        !           240: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           241: @end itemize
        !           242: 
        !           243: The number of bits in the prime modulus.  The default is 512.
        !           244: 
        !           245: @node ntp-keygen mv-keys
        !           246: @subsection mv-keys option (-v)
        !           247: @cindex ntp-keygen-mv-keys
        !           248: 
        !           249: This is the ``update <num> mv keys'' option.
        !           250: 
        !           251: This option has some usage constraints.  It:
        !           252: @itemize @bullet
        !           253: @item
        !           254: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           255: @end itemize
        !           256: 
        !           257: This option has no @samp{doc} documentation.
        !           258: 
        !           259: @node ntp-keygen mv-params
        !           260: @subsection mv-params option (-V)
        !           261: @cindex ntp-keygen-mv-params
        !           262: 
        !           263: This is the ``generate <num> mv parameters'' option.
        !           264: 
        !           265: This option has some usage constraints.  It:
        !           266: @itemize @bullet
        !           267: @item
        !           268: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           269: @end itemize
        !           270: 
        !           271: Generate parameters and keys for the Mu-Varadharajan (MV)
        !           272: identification scheme.
        !           273: 
        !           274: @node ntp-keygen pvt-cert
        !           275: @subsection pvt-cert option (-P)
        !           276: @cindex ntp-keygen-pvt-cert
        !           277: 
        !           278: This is the ``generate pc private certificate'' option.
        !           279: 
        !           280: This option has some usage constraints.  It:
        !           281: @itemize @bullet
        !           282: @item
        !           283: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           284: @end itemize
        !           285: 
        !           286: Generate a private certificate.  By default, the program generates
        !           287: public certificates.
        !           288: 
        !           289: @node ntp-keygen pvt-passwd
        !           290: @subsection pvt-passwd option (-p)
        !           291: @cindex ntp-keygen-pvt-passwd
        !           292: 
        !           293: This is the ``output private password'' option.
        !           294: 
        !           295: This option has some usage constraints.  It:
        !           296: @itemize @bullet
        !           297: @item
        !           298: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           299: @end itemize
        !           300: 
        !           301: Encrypt generated files containing private data with the specified
        !           302: password and the DES-CBC algorithm.
        !           303: 
        !           304: @node ntp-keygen set-debug-level
        !           305: @subsection set-debug-level option (-D)
        !           306: @cindex ntp-keygen-set-debug-level
        !           307: 
        !           308: This is the ``set the output debug message level'' option.
        !           309: 
        !           310: This option has some usage constraints.  It:
        !           311: @itemize @bullet
        !           312: @item
        !           313: may appear an unlimited number of times.
        !           314: @end itemize
        !           315: 
        !           316: Set the output debugging level.  Can be supplied multiple times,
        !           317: but each overrides the previous value(s).
        !           318: 
        !           319: @node ntp-keygen sign-key
        !           320: @subsection sign-key option (-S)
        !           321: @cindex ntp-keygen-sign-key
        !           322: 
        !           323: This is the ``generate sign key (rsa or dsa)'' option.
        !           324: 
        !           325: This option has some usage constraints.  It:
        !           326: @itemize @bullet
        !           327: @item
        !           328: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           329: @end itemize
        !           330: 
        !           331: Generate a new sign key of the designated type, obsoleting any
        !           332: that may exist.  By default, the program uses the host key as the
        !           333: sign key.
        !           334: 
        !           335: @node ntp-keygen subject-name
        !           336: @subsection subject-name option (-s)
        !           337: @cindex ntp-keygen-subject-name
        !           338: 
        !           339: This is the ``set subject name'' option.
        !           340: 
        !           341: This option has some usage constraints.  It:
        !           342: @itemize @bullet
        !           343: @item
        !           344: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           345: @end itemize
        !           346: 
        !           347: Set the issuer name to name.  This is used for the issuer field
        !           348: in certificates and in the file name for identity files.
        !           349: 
        !           350: @node ntp-keygen trusted-cert
        !           351: @subsection trusted-cert option (-T)
        !           352: @cindex ntp-keygen-trusted-cert
        !           353: 
        !           354: This is the ``trusted certificate (tc scheme)'' option.
        !           355: 
        !           356: This option has some usage constraints.  It:
        !           357: @itemize @bullet
        !           358: @item
        !           359: must be compiled in by defining @code{OPENSSL} during the compilation.
        !           360: @end itemize
        !           361: 
        !           362: Generate a trusted certificate.  By default, the program generates
        !           363: a non-trusted certificate.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>