xfnw/plan9fox
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

ec(2): english

Browse source
This commit is contained in:
stanley lieber 2012-06-05 20:05:24 -05:00
parent d389d63f65
commit 9decd26354
1 changed files with 16 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
sys/man/2/ec
View file

@ -8,7 +8,7 @@ ecgen,
ecverify, ecverify,
ecpubverify, ecpubverify,
ecdsasign, ecdsasign,
ecdsaverify \- Elliptic Curve Cryptography ecdsaverify \- elliptic curve cryptography
.SH SYNOPSIS .SH SYNOPSIS
.B #include <u.h> .B #include <u.h>
.br .br
@ -46,8 +46,8 @@ void ecdsasign(ECdomain *dom, ECpriv *priv, uchar *dig, int dlen, mpint *r, mpin
int ecdsaverify(ECdomain *dom, ECpub *pub, uchar *dig, int dlen, mpint *r, mpint *s); int ecdsaverify(ECdomain *dom, ECpub *pub, uchar *dig, int dlen, mpint *r, mpint *s);
.DT .DT
.SH DESCRIPTION .SH DESCRIPTION
These function implement elliptic curve cryptography. These functions implement elliptic curve cryptography.
An elliptic curve together with cryptographic parameters are specified using a An elliptic curve together with cryptographic parameters are specified using an
.B ECdomain .B ECdomain
struct. struct.
Points on the curve are represented by Points on the curve are represented by
@ -55,11 +55,13 @@ Points on the curve are represented by
structs. structs.
.PP .PP
.BR ecassign ", " ecadd " and " ecmul .BR ecassign ", " ecadd " and " ecmul
work analogous to their counterparts in are analogous to their counterparts in
.IR mp (2). .IR mp (2).
.PP .PP
.B strtoec .B strtoec
converts a hex string representing an octet string as specified in SEC 1 to a converts a hex string representing an octet string as specified in
.I Standards for Efficient Cryptography (SEC) 1
to an
.B ECpoint .B ECpoint
struct. Both uncompressed and compressed formats are supported. struct. Both uncompressed and compressed formats are supported.
If If
@ -74,7 +76,7 @@ space is allocated automatically, else the given struct is used.
.B ecverify .B ecverify
and and
.B ecpubverify .B ecpubverify
verify that the given point or public key, resp., is valid. verify that the given point or public key, respectively, is valid.
.PP .PP
.B ecgen .B ecgen
generates a keypair and returns a pointer to it. generates a keypair and returns a pointer to it.
@ -85,7 +87,8 @@ space is allocated automatically, else the given struct is used.
.B ecdsasign .B ecdsasign
and and
.B ecdsaverify .B ecdsaverify
create or verify, resp., a signature using the ECDSA scheme specified in SEC 1. create or verify, respectively, a signature using the ECDSA scheme specified in
.I SEC 1.
It is absolutely vital that It is absolutely vital that
.B dig .B dig
is a cryptographic hash to the message. is a cryptographic hash to the message.
@ -100,9 +103,13 @@ functions return
for a positive result. for a positive result.
Functions returning pointers may return Functions returning pointers may return
.B nil .B nil
in case of error (e.g. failing in case of error
.I (e.g.
failing
.IR malloc (2)). .IR malloc (2)).
.SH SOURCE .SH SOURCE
.B /sys/src/libsec/ec.c .B /sys/src/libsec/ec.c
.SH SEE ALSO .SH SEE ALSO
Standards for Efficient Cryptography (SEC) 1: Elliptic Curve Cryptography, Certicom Research, 2009 .I
Standards for Efficient Cryptography (SEC) 1: Elliptic Curve Cryptography
- Certicom Research, 2009