Return to gzsig.1 CVS log

Up to [local] / src / usr.bin / gzsig

Annotation of src/usr.bin/gzsig/gzsig.1, Revision 1.1

1.1     ! marius      1: .\" $OpenBSD$
        !             2: .\" $Id: gzsig.1,v 1.2 2005/04/01 16:47:31 dugsong Exp $
        !             3: .\"
        !             4: .\"  Copyright (c) 2001 Dug Song <dugsong@arbor.net>
        !             5: .\"  Copyright (c) 2001 Arbor Networks, Inc.
        !             6: .\"
        !             7: .\"    Redistribution and use in source and binary forms, with or without
        !             8: .\"    modification, are permitted provided that the following conditions
        !             9: .\"    are met:
        !            10: .\"
        !            11: .\"    1. Redistributions of source code must retain the above copyright
        !            12: .\"       notice, this list of conditions and the following disclaimer.
        !            13: .\"    2. Redistributions in binary form must reproduce the above copyright
        !            14: .\"       notice, this list of conditions and the following disclaimer in the
        !            15: .\"       documentation and/or other materials provided with the distribution.
        !            16: .\"    3. The names of the copyright holders may not be used to endorse or
        !            17: .\"       promote products derived from this software without specific
        !            18: .\"       prior written permission.
        !            19: .\"
        !            20: .\"    THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
        !            21: .\"    INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
        !            22: .\"    AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
        !            23: .\"    THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
        !            24: .\"    EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
        !            25: .\"    PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
        !            26: .\"    OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
        !            27: .\"    WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
        !            28: .\"    OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
        !            29: .\"    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
        !            30: .\"
        !            31: .Dd July 6, 2001
        !            32: .Dt GZSIG 1
        !            33: .Sh NAME
        !            34: .Nm gzsig
        !            35: .Nd gzip signing utility
        !            36: .Sh SYNOPSIS
        !            37: .Nm gzsig sign
        !            38: .Op Fl v
        !            39: .Ar privkey
        !            40: .Op Ar
        !            41: .Pp
        !            42: .Nm gzsig verify
        !            43: .Op Fl v
        !            44: .Ar pubkey
        !            45: .Op Ar
        !            46: .Sh DESCRIPTION
        !            47: .Nm
        !            48: embeds or verifies RSA PKCS #1 v2.0 or DSA SHA1 signatures in
        !            49: .Xr gzip 1
        !            50: compressed files using SSH2 identity keys or X509 certificates.
        !            51: .Pp
        !            52: The
        !            53: .Ar file
        !            54: operands are processed in command-line order. If
        !            55: .Ar file
        !            56: is a single dash
        !            57: .Pq Sq \&-
        !            58: or absent,
        !            59: .Nm
        !            60: reads from the standard input.
        !            61: .Pp
        !            62: The options are as follows:
        !            63: .Bl -tag -width Ds
        !            64: .It Nm sign
        !            65: Sign the input using the private key in
        !            66: .Ar privkey .
        !            67: .It Nm verify
        !            68: Verify the signature using the public key in
        !            69: .Ar pubkey .
        !            70: .It Fl v
        !            71: Enable verbose mode.
        !            72: .It Fl p
        !            73: Supply a passphrase for decrypting private keys when signing.
        !            74: .El
        !            75: .Pp
        !            76: The
        !            77: .Nm
        !            78: utility exits 0 on success or >0 if an error occured.
        !            79: .Sh EXAMPLES
        !            80: .Cm gzsign sign ~/.ssh/id_rsa file1 file2
        !            81: .Pp
        !            82: Sign
        !            83: .Ar file1
        !            84: and
        !            85: .Ar file2
        !            86: with the SSH2 identity key in
        !            87: .Ar ~/.ssh/id_rsa .
        !            88: .Pp
        !            89: .Cm gzsign sign ~/.ssh/id_rsa < file1 > file2
        !            90: .Pp
        !            91: Sign
        !            92: .Ar file1
        !            93: with the SSH2 identity key, saving the signed file in
        !            94: .Ar file2 .
        !            95: .Pp
        !            96: .Cm gzsign verify /etc/ssl/server.crt < file1
        !            97: .Pp
        !            98: Verify the signature on
        !            99: .Ar file1
        !           100: using the SSL certificate in
        !           101: .Ar /etc/ssl/server.crt .
        !           102: .Pp
        !           103: .Sh SEE ALSO
        !           104: .Xr gzip 1 ,
        !           105: .Xr ssh-keygen 1 ,
        !           106: .Xr ssl 8
        !           107: .Sh AUTHORS
        !           108: Dug Song
        !           109: .Aq dugsong@arbor.net
        !           110: .Pp
        !           111: SSH2 support by
        !           112: Marius Eriksen
        !           113: .Aq marius@openbsd.org