Annotation of src/usr.bin/gzsig/gzsig.1, Revision 1.4
1.4 ! djm 1: .\" $OpenBSD: gzsig.1,v 1.3 2005/05/29 07:34:34 djm Exp $
! 2: .\" $Id: gzsig.1,v 1.3 2005/05/29 07:34:34 djm 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.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
55: operands are processed in command-line order. If
56: .Ar file
57: is a single dash
58: .Pq Sq \&-
59: or absent,
60: .Nm
61: reads from the standard input.
62: .Pp
63: The options are as follows:
64: .Bl -tag -width Ds
65: .It Nm sign
66: Sign the input using the private key in
67: .Ar privkey .
68: .It Nm verify
69: Verify the signature using the public key in
70: .Ar pubkey .
1.3 djm 71: .It Fl q
72: Enable quiet mode.
1.4 ! djm 73: .It Fl f Ar secret_file
! 74: Indicates that the passphrase for the key should be read from
! 75: .Ar secret_file
! 76: instead of being supplied manually.
1.1 marius 77: .El
78: .Pp
79: The
80: .Nm
81: utility exits 0 on success or >0 if an error occured.
82: .Sh EXAMPLES
83: .Cm gzsign sign ~/.ssh/id_rsa file1 file2
84: .Pp
85: Sign
86: .Ar file1
87: and
88: .Ar file2
89: with the SSH2 identity key in
90: .Ar ~/.ssh/id_rsa .
91: .Pp
92: .Cm gzsign sign ~/.ssh/id_rsa < file1 > file2
93: .Pp
94: Sign
95: .Ar file1
96: with the SSH2 identity key, saving the signed file in
97: .Ar file2 .
98: .Pp
99: .Cm gzsign verify /etc/ssl/server.crt < file1
100: .Pp
101: Verify the signature on
102: .Ar file1
103: using the SSL certificate in
104: .Ar /etc/ssl/server.crt .
105: .Pp
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