.TH SKS-ECC 1 "abril 21, 2006" "sks-ecc 0.93" ""
.SH NAME
\fBsks-ecc \- Provides public key encryption/authentication
\fB
.SH SYNOPSIS
.nf
.fam C
\fBsks-ecc\fP \fIcommand\fP [\fIargs\fP]
.fam T
.fi
.SH DESCRIPTION
\fBsks-ecc\fP is a public key application for encryption/authentication, based on Elliptic Curve Cryptografy (ECC). Its minimalist design points to simple, light, fast, easy to use and multiplatform product, unencumbered by patents that is indeed distributed under GPL. All these features are given along with high quality cryptografy.
.PP
Its cryptografic elements are:
.IP \(bu 3
Public key module: elliptic curve over GF (2^191)
.IP \(bu 3
Simmetric key module: AES 192-bits key, with CTR mode
.IP \(bu 3
Hash (for signatures, HMAC and passwords): TIGER (192 bits)
.IP \(bu 3
PRNG module: /dev/urandom. User can provide her own entropy source
.SH OPTIONS
.TP
.B
\fB\-l\fP
Shows license terms.
.PP
Commands in interactive mode
.TP
.B
\fB\-c\fP|\fB-C\fP \fIpfile\fP \fIcfile\fP
Ciphers conventionally \fIpfile\fP and outputs \fIcfile\fP. Uppercase precompress \fIpfile\fP. Password is asked.
.TP
.B
\fB\-e\fP|\fB-E\fP \fIpfile\fP \fIcfile\fP [\fIkeyid\fP] [\.\.\.]
Ciphers \fIpfile\fP with public \fBkey\fP(s) identified by \fIkeyid\fP(s). Output is driven to \fIcfile\fP. Uppercase precompress \fIpfile\fP.
.TP
.B
\fB\-d\fP \fIcfile\fP \fIpfile\fP
Deciphers \fIcfile\fP onto \fIpfile\fP, whatever the ciphering mode was. Password is asked.
.TP
.B
\fB\-s\fP \fIpfile\fP \fIdsign\fP
Signs \fIpfile\fP and outputs detached signature to \fIdsign\fP. Password is asked.
.TP
.B
\fB\-S\fP \fIpfile\fP
Signs printable \fIpfile\fP and outputs through stdout the clearsigned text. Password is asked.
.TP
.B
\fB\-v\fP \fIpfile\fP \fIdsign\fP
Verifies that \fIdsign\fP is a valid signature of \fIpfile\fP. A verify report is output to stderr. If verification is OK, date and key id. of signer are given.
.TP
.B
\fB\-V\fP \fIpfile\fP
Verifies clearsigned texts on \fIpfile\fP and outputs through stdout the original texts. Verify report are output to stderr. Wheather a good verification is found, date and key id. of signer are given.
.TP
.B
\fB\-r\fP \fIpfile\fP [\.\.\.]
Outputs the TIGER-hash of given \fIpfile\fP(s), in a 'md5sum' fashion.
.PP
Commands in filter mode. Text filter is introduced by \fB\-f\fP. Binary filter is introduced by \fB-b\fP
.TP
.B
\fB\-fc\fP|\fB-fC\fP|\fB-bc\fP|\fB-bC\fP "\fIpassw\fP"
Ciphers conventionally stdin with password string \fIpassw\fP, and gives output through stdout. Uppercase precompress input.
.TP
.B
\fB\-fe\fP|\fB-fE\fP|\fB-be\fP|\fB-bE\fP [\fIkeyid\fP] [\.\.\.]
Ciphers stdin with \fBpublic\fP(s) \fBkey\fP(s) identified by \fIkeyid\fP(s). Output is driven to stdout. Uppercase precompress input.
.TP
.B
\fB\-fd\fP|\fB-bd\fP "\fIpassw\fP"
Deciphers stdin onto stdout by means of password string \fIpassw\fP, whatever the ciphering mode was.
.TP
.B
\fB\-fS\fP "\fIpassw\fP"
Signs stdin with password string \fIpassw\fP, and outputs through stdout the clearsigned text.
.TP
.B
\fB\-fV\fP
Verifies clearsigned texts on stdin and outputs through stdout the original texts. Verify reports are output to stderr. Wheather a good verification is found, date and key id. of signer are given.
.PP
Commands to manage keyring.
.TP
.B
\fB\-kg\fP
Public/private key generation. It asks for a descriptive identifier and then asks for a password. Both can be input in a pipe through stdin: the first line is taken as the identifier and the second as the password. The public key is stored in keyring and is output to stdout. The private key is not stored.
.TP
.B
\fB\-ki\fP \fIkeyfile\fP
Imports all keys in \fIkeyfile\fP. Alternatively, \fIkeyfile\fP can be piped through stdin.
.TP
.B
\fB\-kd\fP \fInumid\fP
Deletes key identified by hexadecimal id. \fInumid\fP.
.TP
.B
\fB\-kl\fP [\fIkeyid\fP] [\.\.\.]
Lists the hexadecimal and description ids. of keys matched by \fIkeyid\fP(s).
.TP
.B
\fB\-kf\fP [\fIkeyid\fP] [\.\.\.]
List the fingerprint of keys matched by \fIkeyid\fP(s). Fingerprint is given in base 36, with ICAO alfabet.
.TP
.B
\fB\-ke\fP [\fIkeyid\fP] [\.\.\.]
Exports the keys matched by \fIkeyid\fP(s) through stdout.
.SH HINTS
All files are parsed in a streamish almost unbuffered mode. This means that in interactive mode, \fIpfile\fP and \fIcfile\fP must not coincide. Unpredictible results may occur otherwise.
.PP
All keys that matches the patterns given by \fIkeyid\fP parameters are selected. \fIkeyid\fP(s) can match partially hexadecimal and/or description identifiers. If no \fIkeyid\fP is given, all keys will be selected. Exception is \fB\-kd\fP \fIcommand\fP, that only admits one hexadecimal pattern that completely matches the target key hexadecimal id.
.SH AUTHOR
Written by Manuel Pancorbo Castro <mpancorbo@gmail.com>.
.SH BUGS
Report bugs to <mpancorbo@gmail.com>.
.SH COPYRIGHT
Copyright \(co 2004-2006 M. Pancorbo \- All Rights Reserved
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, Inc.
.SH SEE ALSO
Complete manual and design notes (in spanish):
.PP
.nf
.fam C
 http://sks.merseine.nu