CCSHA(3cc) LOCAL CCSHA(3cc)

NAME
     CCCCSSHHAA11IInniitt CCCCSSHHAA11UUppddaattee CCCCSSHHAA11FFiinnaall CCCCSSHHAA11

     CCCCSSHHAA222244IInniitt CCCCSSHHAA222244UUppddaattee CCCCSSHHAA222244FFiinnaall CCCCSSHHAA222244

     CCCCSSHHAA225566IInniitt CCCCSSHHAA225566UUppddaattee CCCCSSHHAA225566FFiinnaall CCCCSSHHAA225566

     CCCCSSHHAA338844IInniitt CCCCSSHHAA338844UUppddaattee CCCCSSHHAA338844FFiinnaall CCCCSSHHAA338844

     CCCCSSHHAA551122IInniitt CCCCSSHHAA551122UUppddaattee CCCCSSHHAA551122FFiinnaall CCCCSSHHAA551122

     - Secure Hash Algorithms

SYNOPSIS
     ##iinncclluuddee <>

     extern int
     CCCCSSHHAA11IInniitt(CCSHA1CTX *c);

     extern int
     CCCCSSHHAA11UUppddaattee(CCSHA1CTX *c, const void *data, CCLONG len);

     extern int
     CCCCSSHHAA11FFiinnaall(unsigned char *md, CCSHA1CTX *c);

     extern unsigned char *
     CCCCSSHHAA11(const void *data, CCLONG len, unsigned char *md);

     extern int
     CCCCSSHHAA222244IInniitt(CCSHA224CTX *c);

     extern int
     CCCCSSHHAA222244UUppddaattee(CCSHA224CTX *c, const void *data, CCLONG len);

     extern int
     CCCCSSHHAA222244FFiinnaall(unsigned char *md, CCSHA224CTX *c);

     extern unsigned char *
     CCCCSSHHAA222244(const void *data, CCLONG len, unsigned char *md);

     extern int
     CCCCSSHHAA225566IInniitt(CCSHA256CTX *c);

     extern int
     CCCCSSHHAA225566UUppddaattee(CCSHA256CTX *c, const void *data, CCLONG len);

     extern int
     CCCCSSHHAA225566FFiinnaall(unsigned char *md, CCSHA256CTX *c);

     extern unsigned char *
     CCCCSSHHAA225566(const void *data, CCLONG len, unsigned char *md);

     extern int
     CCCCSSHHAA338844IInniitt(CCSHA384CTX *c);

     extern int
     CCCCSSHHAA338844UUppddaattee(CCSHA384CTX *c, const void *data, CCLONG len);

     extern int
     CCCCSSHHAA338844FFiinnaall(unsigned char *md, CCSHA384CTX *c);

     extern unsigned char *
     CCCCSSHHAA338844(const void *data, CCLONG len, unsigned char *md);

     extern int
     CCCCSSHHAA551122IInniitt(CCSHA512CTX *c);

     extern int
     CCCCSSHHAA551122UUppddaattee(CCSHA512CTX *c, const void *data, CCLONG len);

     extern int
     CCCCSSHHAA551122FFiinnaall(unsigned char *md, CCSHA512CTX *c);

     extern unsigned char *
     CCCCSSHHAA551122(const void *data, CCLONG len, unsigned char *md);

DESCRIPTION
     SHA-1 (Secure Hash Algorithm) is a cryptographic hash function with a 160
     bit output.

     CCCCSSHHAA11() computes the SHA-1 message digest of the len bytes at data and
     places it in md (which must have space for CCSHA1DIGESTLENGTH == 20
     bytes of output). It returns the md pointer.

     CCCCSSHHAA11IInniitt() initializes a CCSHA1CTX structure.

     CCCCSSHHAA11UUppddaattee() can be called repeatedly with chunks of the message to
     be hashed (len bytes at data).

     CCCCSSHHAA11FFiinnaall() places the message digest in md, which must have space
     for CCSHA1DIGESTLENGTH == 20 bytes of output, and erases the
     CCSHA1CTX.

     The successor versions of SHA-1, SHA-2, are also implemented for hash bit
     lengths of 224, 256, 384, and 512.  The functions to call to invoke the
     larger hash-size versions of the algorithms include the hash size as part
     of the function names:

     CCCCSSHHAA222244IInniitt(), CCCCSSHHAA222244UUppddaattee(), CCCCSSHHAA222244FFiinnaall(), CCCCSSHHAA222244()

     CCCCSSHHAA225566IInniitt(), CCCCSSHHAA225566UUppddaattee(), CCCCSSHHAA225566FFiinnaall(), CCCCSSHHAA225566()

     CCCCSSHHAA338844IInniitt(), CCCCSSHHAA338844UUppddaattee(), CCCCSSHHAA338844FFiinnaall(), CCCCSSHHAA338844()

     CCCCSSHHAA551122IInniitt(), CCCCSSHHAA551122UUppddaattee(), CCCCSSHHAA551122FFiinnaall(), CCCCSSHHAA551122()

RETURN VALUES
     All routines return 1 except for the one-shot routines ( CCCCSSHHAA11(),
     etc.), which return the pointer passed in via the md parameter.

CCOONNFFOORRMMIINNGG TTOO
     SHA-1: US Federal Information Processing Standard FIPS PUB 180-1 (Secure
     Hash Standard), ANSI X9.30

     SHA-2: US Federal Information Processing Standard FIPS PUB 180-2 (Secure
     Hash Standard)

HISTORY     These functions are available in OS X 10.4 and later.

     These functions provide similar functionality to the routines found in
     OpenSSL 0.9.6 and may use the same implementation.

SEE ALSO
     CCMD5(3cc), CCCryptor(3cc), CCHmac(3cc), CCcrypto(3cc)

BSD                              April 5, 2007                             BSD