version 1.5, 2013/12/31 18:18:36 |
version 1.6, 2014/01/01 17:50:33 |
|
|
.Nd cryptographically sign and verify files |
.Nd cryptographically sign and verify files |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm signify |
.Nm signify |
.Op Fl N |
.Op Fl n |
.Op Fl I Ar input |
.Op Fl i Ar input |
.Op Fl O Ar output |
.Op Fl o Ar output |
.Op Fl P Ar pubkey |
.Op Fl p Ar pubkey |
.Op Fl S Ar seckey |
.Op Fl s Ar seckey |
.Fl V Ar generate | sign | verify |
.Fl G | S | V |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
utility creates and verifies cryptographic signatures. |
utility creates and verifies cryptographic signatures. |
The mode of operation is selected by the |
The mode of operation is selected by the |
|
.Fl G , |
|
.Fl S , |
|
or |
.Fl V |
.Fl V |
option. |
options. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl I Ar input |
.It Fl G |
|
Generate a new keypair. |
|
.It Fl i Ar input |
Input file to sign or verify. |
Input file to sign or verify. |
.It Fl N |
.It Fl n |
Do not ask for a passphrase during key generation. |
Do not ask for a passphrase during key generation. |
Otherwise, |
Otherwise, |
.Nm |
.Nm |
will prompt the user for a passphrase on the terminal. |
will prompt the user for a passphrase on the terminal. |
.It Fl O Ar output |
.It Fl o Ar output |
The signature file to create or verify. |
The signature file to create or verify. |
The default is |
The default is |
.Ar input Ns .sig . |
.Ar input Ns .sig . |
.It Fl P Ar pubkey |
.It Fl p Ar pubkey |
Public key produced by |
Public key produced by |
.Ar generate , |
.Ar G , |
and used by |
and used by |
.Ar verify |
.Ar V |
to check a signature. |
to check a signature. |
.It Fl S Ar seckey |
.It Fl S |
|
Sign the input file. |
|
.It Fl s Ar seckey |
Secret (private) key produced by |
Secret (private) key produced by |
.Ar generate , |
.Ar G , |
and used by |
and used by |
.Ar sign |
.Ar S |
to sign a message. |
to sign a message. |
.It Fl V Ar generate | sign | verify |
.It Fl V |
Select the desired operation. |
Verify the input file and signature match. |
.El |
.El |
.Pp |
.Pp |
The key and signature files created by |
The key and signature files created by |
|
|
.El |
.El |
.Sh EXAMPLES |
.Sh EXAMPLES |
Create a new keypair: |
Create a new keypair: |
.Dl $ signify -P newkey.pub -S newkey.sec -V generate |
.Dl $ signify -p newkey.pub -s newkey.sec -G |
.Pp |
.Pp |
Sign a file, specifying a signature name: |
Sign a file, specifying a signature name: |
.Dl $ signify -S key.sec -I message.txt -O msg.sig -V sign |
.Dl $ signify -s key.sec -i message.txt -o msg.sig -S |
.Pp |
.Pp |
Verify a signature, using the default signature name: |
Verify a signature, using the default signature name: |
.Dl $ signify -P key.pub -I generalsorders.txt -V verify |
.Dl $ signify -p key.pub -i generalsorders.txt -V |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr cmp 1 , |
.Xr cmp 1 , |
.Xr sha256 1 , |
.Xr sha256 1 , |