Return to gzsig.1 CVS log

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

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

1.3     ! djm         1: .\" $OpenBSD: gzsig.1,v 1.2 2005/05/29 02:41:42 marius Exp $
        !             2: .\" $Id: gzsig.1,v 1.2 2005/05/29 02:41:42 marius Exp $
1.1       marius      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
1.3     ! djm        38: .Op Fl q
1.1       marius     39: .Ar privkey
                     40: .Op Ar
                     41: .Pp
                     42: .Nm gzsig verify
1.3     ! djm        43: .Op Fl q
1.1       marius     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
1.2       marius     50: compressed files using SSH identity keys or X509 certificates.
1.1       marius     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 .
1.3     ! djm        70: .It Fl q
        !            71: Enable quiet mode.
1.1       marius     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