Annotation of src/usr.bin/gzsig/gzsig.1, Revision 1.5
1.5 ! jmc 1: .\" $OpenBSD: gzsig.1,v 1.4 2005/05/29 08:54:13 djm Exp $
! 2: .\" $Id: gzsig.1,v 1.4 2005/05/29 08:54:13 djm 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.1 marius 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.4 djm 44: .Op Fl f Ar secret_file
1.1 marius 45: .Ar pubkey
46: .Op Ar
47: .Sh DESCRIPTION
48: .Nm
49: embeds or verifies RSA PKCS #1 v2.0 or DSA SHA1 signatures in
50: .Xr gzip 1
1.2 marius 51: compressed files using SSH identity keys or X509 certificates.
1.1 marius 52: .Pp
53: The
54: .Ar file
1.5 ! jmc 55: operands are processed in command-line order.
! 56: If
1.1 marius 57: .Ar file
58: is a single dash
59: .Pq Sq \&-
60: or absent,
61: .Nm
62: reads from the standard input.
63: .Pp
64: The options are as follows:
65: .Bl -tag -width Ds
66: .It Nm sign
67: Sign the input using the private key in
68: .Ar privkey .
69: .It Nm verify
70: Verify the signature using the public key in
71: .Ar pubkey .
1.3 djm 72: .It Fl q
73: Enable quiet mode.
1.4 djm 74: .It Fl f Ar secret_file
75: Indicates that the passphrase for the key should be read from
76: .Ar secret_file
77: instead of being supplied manually.
1.1 marius 78: .El
79: .Pp
80: The
81: .Nm
82: utility exits 0 on success or >0 if an error occured.
83: .Sh EXAMPLES
1.5 ! jmc 84: Sign
1.1 marius 85: .Ar file1
86: and
87: .Ar file2
88: with the SSH2 identity key in
1.5 ! jmc 89: .Ar ~/.ssh/id_rsa :
1.1 marius 90: .Pp
1.5 ! jmc 91: .Dl $ gzsign sign ~/.ssh/id_rsa file1 file2
1.1 marius 92: .Pp
93: Sign
94: .Ar file1
95: with the SSH2 identity key, saving the signed file in
1.5 ! jmc 96: .Ar file2 :
1.1 marius 97: .Pp
1.5 ! jmc 98: .Dl $ gzsign sign ~/.ssh/id_rsa < file1 > file2
1.1 marius 99: .Pp
100: Verify the signature on
101: .Ar file1
102: using the SSL certificate in
1.5 ! jmc 103: .Ar /etc/ssl/server.crt :
1.1 marius 104: .Pp
1.5 ! jmc 105: .Dl $ gzsign verify /etc/ssl/server.crt < file1
1.1 marius 106: .Sh SEE ALSO
107: .Xr gzip 1 ,
108: .Xr ssh-keygen 1 ,
109: .Xr ssl 8
110: .Sh AUTHORS
111: Dug Song
112: .Aq dugsong@arbor.net
113: .Pp
114: SSH2 support by
115: Marius Eriksen
116: .Aq marius@openbsd.org