bird/lib/sha1.h

69 lines
2 KiB
C
Raw Normal View History

2015-11-13 23:11:51 +08:00
/*
* BIRD Library -- SHA-1 Hash Function (FIPS 180-1, RFC 3174)
2015-11-13 23:11:51 +08:00
*
* (c) 2015 CZ.NIC z.s.p.o.
*
* Based on the code from libucw-6.4
* (c) 2008--2009 Martin Mares <mj@ucw.cz>
*
* Based on the code from libgcrypt-1.2.3, which is
* (c) 1998, 2001, 2002, 2003 Free Software Foundation, Inc.
*
* Can be freely distributed and used under the terms of the GNU GPL.
*/
#ifndef _BIRD_SHA1_H_
#define _BIRD_SHA1_H_
#include "nest/bird.h"
2015-11-24 20:47:28 +08:00
#define SHA1_SIZE 20 /* Size of the SHA1 hash in its binary representation */
#define SHA1_HEX_SIZE 41 /* Buffer length for a string containing SHA1 in hexadecimal format. */
#define SHA1_BLOCK_SIZE 64 /* SHA1 splits input to blocks of this size. */
2015-11-13 23:11:51 +08:00
/*
* Internal SHA1 state.
* You should use it just as an opaque handle only.
*/
struct hash_context;
2015-11-13 23:11:51 +08:00
struct sha1_context {
2015-11-24 20:47:28 +08:00
u32 h0, h1, h2, h3, h4;
byte buf[SHA1_BLOCK_SIZE];
uint nblocks;
uint count;
};
void sha1_init(struct hash_context *ctx); /* Initialize new algorithm run in the @ctx context. **/
2015-11-13 23:11:51 +08:00
/*
2015-11-24 20:47:28 +08:00
* Push another @len bytes of data pointed to by @buf onto the SHA1 hash
* currently in @ctx. You can call this any times you want on the same hash (and
* you do not need to reinitialize it by @sha1_init()). It has the same effect
* as concatenating all the data together and passing them at once.
2015-11-13 23:11:51 +08:00
*/
void sha1_update(struct hash_context *ctx, const byte *buf, uint len);
2015-11-13 23:11:51 +08:00
/*
2015-11-24 20:47:28 +08:00
* No more @sha1_update() calls will be done. This terminates the hash and
* returns a pointer to it.
2015-11-13 23:11:51 +08:00
*
2015-11-24 20:47:28 +08:00
* Note that the pointer points into data in the @ctx context. If it ceases to
* exist, the pointer becomes invalid.
2015-11-13 23:11:51 +08:00
*/
byte *sha1_final(struct hash_context *ctx);
2015-11-13 23:11:51 +08:00
/*
2015-11-24 20:47:28 +08:00
* A convenience one-shot function for SHA1 hash. It is equivalent to this
* snippet of code:
2015-11-13 23:11:51 +08:00
*
2015-11-24 20:47:28 +08:00
* sha1_context ctx;
* sha1_init(&ctx);
* sha1_update(&ctx, buffer, length);
* memcpy(outbuf, sha1_final(&ctx), SHA1_SIZE);
2015-11-13 23:11:51 +08:00
*/
void sha1_hash_buffer(byte *outbuf, const byte *buffer, uint length);
#endif /* _BIRD_SHA1_H_ */