mirror of
https://github.com/php/php-src.git
synced 2024-09-23 02:47:26 +00:00
ada776c84c
* Modify php_hash_ops to contain the algorithm name and serialize and unserialize methods. * Implement __serialize and __unserialize magic methods on HashContext. Note that serialized HashContexts are not necessarily portable between PHP versions or from architecture to architecture. (Most are, though Keccak and slow SHA3s are not.) An exception is thrown when an unsupported serialization is attempted. Because of security concerns, HASH_HMAC contexts are not currently serializable; attempting to serialize one throws an exception. Serialization exposes the state of HashContext memory, so ensure that memory is zeroed before use by allocating it with a new php_hash_alloc_context function. Performance impact is negligible. Some hash internal states have logical pointers into a buffer, or sponge, that absorbs input provided in bytes rather than chunks. The unserialize functions for these hash functions must validate that the logical pointers are all within bounds, lest future hash operations cause out-of-bounds memory accesses. * Adler32, CRC32, FNV, joaat: simple state, no buffer positions * Gost, MD2, SHA3, Snefru, Tiger, Whirlpool: buffer positions must be validated * MD4, MD5, SHA1, SHA2, haval, ripemd: buffer positions encoded bitwise, forced to within bounds on use; no need to validate
56 lines
2.3 KiB
C
56 lines
2.3 KiB
C
/*
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) The PHP Group |
|
|
+----------------------------------------------------------------------+
|
|
| This source file is subject to version 3.01 of the PHP license, |
|
|
| that is bundled with this package in the file LICENSE, and is |
|
|
| available through the world-wide-web at the following url: |
|
|
| http://www.php.net/license/3_01.txt |
|
|
| If you did not receive a copy of the PHP license and are unable to |
|
|
| obtain it through the world-wide-web, please send a note to |
|
|
| license@php.net so we can mail you a copy immediately. |
|
|
+----------------------------------------------------------------------+
|
|
| Author: Sara Golemon <pollita@php.net> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
#ifndef PHP_HASH_SHA3_H
|
|
#define PHP_HASH_SHA3_H
|
|
|
|
#include "php.h"
|
|
|
|
typedef struct {
|
|
#ifdef HAVE_SLOW_HASH3
|
|
unsigned char state[200]; // 5 * 5 * sizeof(uint64)
|
|
uint32_t pos;
|
|
#else
|
|
unsigned char state[224]; // this must fit a Keccak_HashInstance
|
|
#endif
|
|
} PHP_SHA3_CTX;
|
|
#ifdef HAVE_SLOW_HASH3
|
|
#define PHP_SHA3_SPEC "b200l."
|
|
#endif
|
|
|
|
typedef PHP_SHA3_CTX PHP_SHA3_224_CTX;
|
|
typedef PHP_SHA3_CTX PHP_SHA3_256_CTX;
|
|
typedef PHP_SHA3_CTX PHP_SHA3_384_CTX;
|
|
typedef PHP_SHA3_CTX PHP_SHA3_512_CTX;
|
|
|
|
PHP_HASH_API void PHP_SHA3224Init(PHP_SHA3_224_CTX*);
|
|
PHP_HASH_API void PHP_SHA3224Update(PHP_SHA3_224_CTX*, const unsigned char*, size_t);
|
|
PHP_HASH_API void PHP_SAH3224Final(unsigned char[32], PHP_SHA3_224_CTX*);
|
|
|
|
PHP_HASH_API void PHP_SHA3256Init(PHP_SHA3_256_CTX*);
|
|
PHP_HASH_API void PHP_SHA3256Update(PHP_SHA3_256_CTX*, const unsigned char*, size_t);
|
|
PHP_HASH_API void PHP_SAH3256Final(unsigned char[32], PHP_SHA3_256_CTX*);
|
|
|
|
PHP_HASH_API void PHP_SHA3384Init(PHP_SHA3_384_CTX*);
|
|
PHP_HASH_API void PHP_SHA3384Update(PHP_SHA3_384_CTX*, const unsigned char*, size_t);
|
|
PHP_HASH_API void PHP_SAH3384Final(unsigned char[32], PHP_SHA3_384_CTX*);
|
|
|
|
PHP_HASH_API void PHP_SHA3512Init(PHP_SHA3_512_CTX*);
|
|
PHP_HASH_API void PHP_SHA3512Update(PHP_SHA3_512_CTX*, const unsigned char*, size_t);
|
|
PHP_HASH_API void PHP_SAH3512Final(unsigned char[32], PHP_SHA3_512_CTX*);
|
|
|
|
#endif
|