Return to sha1.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / bird / lib

Annotation of embedaddon/bird/lib/sha1.h, revision 1.1

1.1     ! misho       1: /*
        !             2:  *     BIRD Library -- SHA-1 Hash Function (FIPS 180-1, RFC 3174)
        !             3:  *
        !             4:  *     (c) 2015 CZ.NIC z.s.p.o.
        !             5:  *
        !             6:  *     Based on the code from libucw-6.4
        !             7:  *     (c) 2008--2009 Martin Mares <mj@ucw.cz>
        !             8:  *
        !             9:  *     Based on the code from libgcrypt-1.2.3, which is
        !            10:  *     (c) 1998, 2001, 2002, 2003 Free Software Foundation, Inc.
        !            11:  *
        !            12:  *     Can be freely distributed and used under the terms of the GNU GPL.
        !            13:  */
        !            14: 
        !            15: #ifndef _BIRD_SHA1_H_
        !            16: #define _BIRD_SHA1_H_
        !            17: 
        !            18: #include "nest/bird.h"
        !            19: 
        !            20: 
        !            21: #define SHA1_SIZE              20      /* Size of the SHA1 hash in its binary representation */
        !            22: #define SHA1_HEX_SIZE          41      /* Buffer length for a string containing SHA1 in hexadecimal format. */
        !            23: #define SHA1_BLOCK_SIZE                64      /* SHA1 splits input to blocks of this size. */
        !            24: 
        !            25: 
        !            26: /*
        !            27:  * Internal SHA1 state.
        !            28:  * You should use it just as an opaque handle only.
        !            29:  */
        !            30: struct hash_context;
        !            31: 
        !            32: struct sha1_context {
        !            33:   u32 h0, h1, h2, h3, h4;
        !            34:   byte buf[SHA1_BLOCK_SIZE];
        !            35:   uint nblocks;
        !            36:   uint count;
        !            37: };
        !            38: 
        !            39: void sha1_init(struct hash_context *ctx); /* Initialize new algorithm run in the @ctx context. **/
        !            40: /*
        !            41:  * Push another @len bytes of data pointed to by @buf onto the SHA1 hash
        !            42:  * currently in @ctx. You can call this any times you want on the same hash (and
        !            43:  * you do not need to reinitialize it by @sha1_init()). It has the same effect
        !            44:  * as concatenating all the data together and passing them at once.
        !            45:  */
        !            46: void sha1_update(struct hash_context *ctx, const byte *buf, uint len);
        !            47: /*
        !            48:  * No more @sha1_update() calls will be done. This terminates the hash and
        !            49:  * returns a pointer to it.
        !            50:  *
        !            51:  * Note that the pointer points into data in the @ctx context. If it ceases to
        !            52:  * exist, the pointer becomes invalid.
        !            53:  */
        !            54: byte *sha1_final(struct hash_context *ctx);
        !            55: 
        !            56: /*
        !            57:  * A convenience one-shot function for SHA1 hash. It is equivalent to this
        !            58:  * snippet of code:
        !            59:  *
        !            60:  *  sha1_context ctx;
        !            61:  *  sha1_init(&ctx);
        !            62:  *  sha1_update(&ctx, buffer, length);
        !            63:  *  memcpy(outbuf, sha1_final(&ctx), SHA1_SIZE);
        !            64:  */
        !            65: void sha1_hash_buffer(byte *outbuf, const byte *buffer, uint length);
        !            66: 
        !            67: 
        !            68: #endif /* _BIRD_SHA1_H_ */