Annotation of src/usr.bin/gzsig/gzsig.1, Revision 1.16
1.16 ! schwarze 1: .\" $OpenBSD: gzsig.1,v 1.15 2013/03/09 22:36:25 jmc Exp $
! 2: .\" $Id: gzsig.1,v 1.15 2013/03/09 22:36:25 jmc 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.15 jmc 31: .Dd $Mdocdate: March 9 2013 $
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.14 tobias 40: .Op Fl q | v
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.14 tobias 46: .Op Fl q | v
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.13 jmc 54: compressed files using SSH identity keys or X.509 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.
1.15 jmc 75: The options
76: .Fl q
77: and
78: .Fl v
79: are mutually exclusive;
80: the last one specified takes precedence.
1.14 tobias 81: .It Fl v
82: Enable verbose mode.
83: This is the default.
1.15 jmc 84: The options
1.14 tobias 85: .Fl q
86: and
87: .Fl v
88: are mutually exclusive;
89: the last one specified takes precedence.
1.8 jmc 90: .It Ic sign
1.1 marius 91: Sign the input using the private key in
92: .Ar privkey .
1.8 jmc 93: .It Ic verify
1.1 marius 94: Verify the signature using the public key in
95: .Ar pubkey .
96: .El
1.12 jmc 97: .Sh EXIT STATUS
1.10 sobrado 98: .Ex -std gzsig
1.1 marius 99: .Sh EXAMPLES
1.5 jmc 100: Sign
1.1 marius 101: .Ar file1
102: and
103: .Ar file2
104: with the SSH2 identity key in
1.5 jmc 105: .Ar ~/.ssh/id_rsa :
1.1 marius 106: .Pp
1.6 jmc 107: .Dl $ gzsig sign ~/.ssh/id_rsa file1 file2
1.1 marius 108: .Pp
109: Sign
110: .Ar file1
111: with the SSH2 identity key, saving the signed file in
1.5 jmc 112: .Ar file2 :
1.1 marius 113: .Pp
1.8 jmc 114: .Dl $ gzsig sign ~/.ssh/id_rsa \*(Ltfile1 \*(Gtfile2
1.1 marius 115: .Pp
116: Verify the signature on
117: .Ar file1
118: using the SSL certificate in
1.5 jmc 119: .Ar /etc/ssl/server.crt :
1.1 marius 120: .Pp
1.8 jmc 121: .Dl $ gzsig verify /etc/ssl/server.crt \*(Ltfile1
1.1 marius 122: .Sh SEE ALSO
123: .Xr gzip 1 ,
124: .Xr ssh-keygen 1 ,
125: .Xr ssl 8
126: .Sh AUTHORS
1.16 ! schwarze 127: .An -nosplit
! 128: .An Dug Song Aq Mt dugsong@arbor.net .
! 129: .Pp
1.1 marius 130: SSH2 support by
1.16 ! schwarze 131: .An Marius Eriksen Aq Mt marius@openbsd.org .