diff options
Diffstat (limited to 'src/usr.bin/gzsig/gzsig.1')
-rw-r--r-- | src/usr.bin/gzsig/gzsig.1 | 131 |
1 files changed, 131 insertions, 0 deletions
diff --git a/src/usr.bin/gzsig/gzsig.1 b/src/usr.bin/gzsig/gzsig.1 new file mode 100644 index 0000000..87d7b2f --- /dev/null +++ b/src/usr.bin/gzsig/gzsig.1 @@ -0,0 +1,131 @@ +.\" $OpenBSD: gzsig.1,v 1.16 2013/07/16 07:01:02 schwarze Exp $ +.\" $Id: gzsig.1,v 1.16 2013/07/16 07:01:02 schwarze Exp $ +.\" +.\" Copyright (c) 2001 Dug Song <dugsong@arbor.net> +.\" Copyright (c) 2001 Arbor Networks, Inc. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. The names of the copyright holders may not be used to endorse or +.\" promote products derived from this software without specific +.\" prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, +.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY +.\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL +.\" THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +.\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +.\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +.\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF +.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd $Mdocdate: July 16 2013 $ +.Dt GZSIG 1 +.Os +.Sh NAME +.Nm gzsig +.Nd gzip signing utility +.Sh SYNOPSIS +.Nm gzsig +.Ic sign +.Op Fl q | v +.Op Fl f Ar secret_file +.Ar privkey +.Op Ar +.Nm gzsig +.Ic verify +.Op Fl q | v +.Op Fl f Ar secret_file +.Ar pubkey +.Op Ar +.Sh DESCRIPTION +.Nm +embeds or verifies RSA PKCS #1 v2.0 or DSA SHA1 signatures in +.Xr gzip 1 +compressed files using SSH identity keys or X.509 certificates. +.Pp +The +.Ar file +operands are processed in command-line order. +If +.Ar file +is a single dash +.Pq Sq - +or absent, +.Nm +reads from the standard input. +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl f Ar secret_file +Indicates that the passphrase for the key should be read from +.Ar secret_file +instead of being supplied manually. +.It Fl q +Enable quiet mode. +The options +.Fl q +and +.Fl v +are mutually exclusive; +the last one specified takes precedence. +.It Fl v +Enable verbose mode. +This is the default. +The options +.Fl q +and +.Fl v +are mutually exclusive; +the last one specified takes precedence. +.It Ic sign +Sign the input using the private key in +.Ar privkey . +.It Ic verify +Verify the signature using the public key in +.Ar pubkey . +.El +.Sh EXIT STATUS +.Ex -std gzsig +.Sh EXAMPLES +Sign +.Ar file1 +and +.Ar file2 +with the SSH2 identity key in +.Ar ~/.ssh/id_rsa : +.Pp +.Dl $ gzsig sign ~/.ssh/id_rsa file1 file2 +.Pp +Sign +.Ar file1 +with the SSH2 identity key, saving the signed file in +.Ar file2 : +.Pp +.Dl $ gzsig sign ~/.ssh/id_rsa \*(Ltfile1 \*(Gtfile2 +.Pp +Verify the signature on +.Ar file1 +using the SSL certificate in +.Ar /etc/ssl/server.crt : +.Pp +.Dl $ gzsig verify /etc/ssl/server.crt \*(Ltfile1 +.Sh SEE ALSO +.Xr gzip 1 , +.Xr ssh-keygen 1 , +.Xr ssl 8 +.Sh AUTHORS +.An -nosplit +.An Dug Song Aq Mt dugsong@arbor.net . +.Pp +SSH2 support by +.An Marius Eriksen Aq Mt marius@openbsd.org . |