Return to plainrsa-gen.8 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / ipsec-tools / src / racoon

Annotation of embedaddon/ipsec-tools/src/racoon/plainrsa-gen.8, revision 1.1

1.1     ! misho       1: .\"    $NetBSD: plainrsa-gen.8,v 1.13 2006/09/19 18:54:39 wiz Exp $
        !             2: .\"
        !             3: .\" Id: plainrsa-gen.8,v 1.4 2005/04/18 11:07:55 manubsd Exp
        !             4: .\"
        !             5: .\" Copyright (C) 2004 SuSE Linux AG, Nuernberg, Germany.
        !             6: .\" Contributed by: Michal Ludvig <mludvig@suse.cz>, SUSE Labs
        !             7: .\" All rights reserved.
        !             8: .\"
        !             9: .\" Redistribution and use in source and binary forms, with or without
        !            10: .\" modification, are permitted provided that the following conditions
        !            11: .\" are met:
        !            12: .\" 1. Redistributions of source code must retain the above copyright
        !            13: .\"    notice, this list of conditions and the following disclaimer.
        !            14: .\" 2. Redistributions in binary form must reproduce the above copyright
        !            15: .\"    notice, this list of conditions and the following disclaimer in the
        !            16: .\"    documentation and/or other materials provided with the distribution.
        !            17: .\" 3. Neither the name of the project nor the names of its contributors
        !            18: .\"    may be used to endorse or promote products derived from this software
        !            19: .\"    without specific prior written permission.
        !            20: .\"
        !            21: .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
        !            22: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        !            23: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        !            24: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
        !            25: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        !            26: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        !            27: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        !            28: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        !            29: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        !            30: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        !            31: .\" SUCH DAMAGE.
        !            32: .\"
        !            33: .Dd June 14, 2004
        !            34: .Dt PLAINRSA-GEN 8
        !            35: .Os
        !            36: .\"
        !            37: .Sh NAME
        !            38: .Nm plainrsa-gen
        !            39: .Nd generator for Plain RSA keys
        !            40: .\"
        !            41: .Sh SYNOPSIS
        !            42: .Nm plainrsa-gen
        !            43: .Bk -words
        !            44: .Op Fl b Ar bits
        !            45: .Op Fl e Ar pubexp
        !            46: .Op Fl f Ar outfile
        !            47: .Op Fl h
        !            48: .Ek
        !            49: .\"
        !            50: .Sh DESCRIPTION
        !            51: .Nm
        !            52: can be used to generate
        !            53: .Li Plain RSA keys
        !            54: for authentication purposes.
        !            55: Using
        !            56: .Li Plain RSA keys
        !            57: is optional.
        !            58: Other possibilities are
        !            59: .Li Pre-shared keys
        !            60: or
        !            61: .Li X.509 certificates .
        !            62: .\"
        !            63: .Bl -tag -width Ds
        !            64: .It Fl b Ar bits
        !            65: bit length of the key.
        !            66: Default is
        !            67: .Li 1024 ,
        !            68: recommended length is
        !            69: .Li 2048
        !            70: or even
        !            71: .Li 4096
        !            72: bits.
        !            73: Note that generating longer keys takes longer time.
        !            74: .It Fl e Ar pubexp
        !            75: value of RSA public exponent.
        !            76: Default is
        !            77: .Li 0x3 .
        !            78: Don't change this unless you really know what you are doing!
        !            79: .It Fl f Ar outfile
        !            80: .Ar outfile
        !            81: instead of
        !            82: .Li stdout .
        !            83: If the file already exists it won't be overwritten.
        !            84: You wouldn't like to lose your private key by accident, would you?
        !            85: .El
        !            86: .\"
        !            87: .Sh OUTPUT FILE FORMAT
        !            88: This is the secret
        !            89: .Li private key
        !            90: that should
        !            91: .Ic never
        !            92: leave your computer:
        !            93: .Bd -literal
        !            94: : RSA  {
        !            95:        # RSA 1024 bits
        !            96:        # pubkey=0sAQOrWlcwbAIdNSMhDt...
        !            97:        Modulus: 0xab5a57306c021d3523...
        !            98:        PublicExponent: 0x03
        !            99:        PrivateExponent: 0x723c3a2048...
        !           100:        Prime1: 0xd309b30e6adf9d85c01...
        !           101:        Prime2: 0xcfdc2a8aa5b2b3c90e3...
        !           102:        Exponent1: 0x8cb122099c9513ae...
        !           103:        Exponent2: 0x8a92c7071921cd30...
        !           104:        Coefficient: 0x722751305eafe9...
        !           105:   }
        !           106: .Ed
        !           107: .Pp
        !           108: The line
        !           109: .Li pubkey=0sAQOrW...
        !           110: of the
        !           111: .Li private key
        !           112: contains a
        !           113: .Li public key
        !           114: that should be stored in the other peer's configuration in this format:
        !           115: .Bd -literal
        !           116: : PUB 0sAQOrWlcwbAIdNSMhDt...
        !           117: .Ed
        !           118: .\"
        !           119: .Pp
        !           120: You can also specify
        !           121: .Li from
        !           122: and
        !           123: .Li to
        !           124: addresses for which the key is valid:
        !           125: .Bd -literal
        !           126: 0.0.0.0/0 10.20.30.0/24 : PUB 0sAQOrWlcwbAIdNSMhDt...
        !           127: .Ed
        !           128: .\"
        !           129: .Sh SEE ALSO
        !           130: .Xr racoon.conf 5 ,
        !           131: .Xr racoon 8
        !           132: .\"
        !           133: .Sh HISTORY
        !           134: .Nm
        !           135: was written by
        !           136: .An Michal Ludvig Aq michal@logix.cz
        !           137: and first appeared in
        !           138: .Ic ipsec-tools 0.4 .