Return to gzsig.1 CVS log

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

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

1.12    ! jmc         1: .\" $OpenBSD: gzsig.1,v 1.11 2010/01/02 19:48:56 schwarze Exp $
        !             2: .\" $Id: gzsig.1,v 1.11 2010/01/02 19:48:56 schwarze Exp $
1.1       marius      3: .\"
                      4: .\"  Copyright (c) 2001 Dug Song <dugsong@arbor.net>
                      5: .\"  Copyright (c) 2001 Arbor Networks, Inc.
1.5       jmc         6: .\"
1.1       marius      7: .\"    Redistribution and use in source and binary forms, with or without
                      8: .\"    modification, are permitted provided that the following conditions
                      9: .\"    are met:
1.5       jmc        10: .\"
1.1       marius     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.
1.5       jmc        19: .\"
1.1       marius     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.
1.5       jmc        30: .\"
1.12    ! jmc        31: .Dd $Mdocdate: January 2 2010 $
1.1       marius     32: .Dt GZSIG 1
1.11      schwarze   33: .Os
1.1       marius     34: .Sh NAME
                     35: .Nm gzsig
                     36: .Nd gzip signing utility
                     37: .Sh SYNOPSIS
1.8       jmc        38: .Nm gzsig
                     39: .Ic sign
1.3       djm        40: .Op Fl q
1.8       jmc        41: .Op Fl f Ar secret_file
1.1       marius     42: .Ar privkey
                     43: .Op Ar
1.8       jmc        44: .Nm gzsig
                     45: .Ic verify
1.3       djm        46: .Op Fl q
1.4       djm        47: .Op Fl f Ar secret_file
1.1       marius     48: .Ar pubkey
                     49: .Op Ar
                     50: .Sh DESCRIPTION
                     51: .Nm
                     52: embeds or verifies RSA PKCS #1 v2.0 or DSA SHA1 signatures in
                     53: .Xr gzip 1
1.2       marius     54: compressed files using SSH identity keys or X509 certificates.
1.1       marius     55: .Pp
                     56: The
                     57: .Ar file
1.5       jmc        58: operands are processed in command-line order.
                     59: If
1.1       marius     60: .Ar file
                     61: is a single dash
1.8       jmc        62: .Pq Sq -
1.1       marius     63: or absent,
                     64: .Nm
                     65: reads from the standard input.
                     66: .Pp
                     67: The options are as follows:
                     68: .Bl -tag -width Ds
1.8       jmc        69: .It Fl f Ar secret_file
                     70: Indicates that the passphrase for the key should be read from
                     71: .Ar secret_file
                     72: instead of being supplied manually.
                     73: .It Fl q
                     74: Enable quiet mode.
                     75: .It Ic sign
1.1       marius     76: Sign the input using the private key in
                     77: .Ar privkey .
1.8       jmc        78: .It Ic verify
1.1       marius     79: Verify the signature using the public key in
                     80: .Ar pubkey .
                     81: .El
1.12    ! jmc        82: .Sh EXIT STATUS
1.10      sobrado    83: .Ex -std gzsig
1.1       marius     84: .Sh EXAMPLES
1.5       jmc        85: Sign
1.1       marius     86: .Ar file1
                     87: and
                     88: .Ar file2
                     89: with the SSH2 identity key in
1.5       jmc        90: .Ar ~/.ssh/id_rsa :
1.1       marius     91: .Pp
1.6       jmc        92: .Dl $ gzsig sign ~/.ssh/id_rsa file1 file2
1.1       marius     93: .Pp
                     94: Sign
                     95: .Ar file1
                     96: with the SSH2 identity key, saving the signed file in
1.5       jmc        97: .Ar file2 :
1.1       marius     98: .Pp
1.8       jmc        99: .Dl $ gzsig sign ~/.ssh/id_rsa \*(Ltfile1 \*(Gtfile2
1.1       marius    100: .Pp
                    101: Verify the signature on
                    102: .Ar file1
                    103: using the SSL certificate in
1.5       jmc       104: .Ar /etc/ssl/server.crt :
1.1       marius    105: .Pp
1.8       jmc       106: .Dl $ gzsig verify /etc/ssl/server.crt \*(Ltfile1
1.1       marius    107: .Sh SEE ALSO
                    108: .Xr gzip 1 ,
                    109: .Xr ssh-keygen 1 ,
                    110: .Xr ssl 8
                    111: .Sh AUTHORS
                    112: Dug Song
1.8       jmc       113: .Aq dugsong@arbor.net .
1.1       marius    114: SSH2 support by
                    115: Marius Eriksen
1.8       jmc       116: .Aq marius@openbsd.org .