1 /* 2 * Copyright (C) 2016 The Android Open Source Project 3 * 4 * Permission is hereby granted, free of charge, to any person 5 * obtaining a copy of this software and associated documentation 6 * files (the "Software"), to deal in the Software without 7 * restriction, including without limitation the rights to use, copy, 8 * modify, merge, publish, distribute, sublicense, and/or sell copies 9 * of the Software, and to permit persons to whom the Software is 10 * furnished to do so, subject to the following conditions: 11 * 12 * The above copyright notice and this permission notice shall be 13 * included in all copies or substantial portions of the Software. 14 * 15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 18 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS 19 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 20 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 22 * SOFTWARE. 23 */ 24 25 #ifdef AVB_INSIDE_LIBAVB_H 26 #error "You can't include avb_sha.h in the public header libavb.h." 27 #endif 28 29 #ifndef AVB_COMPILATION 30 #error "Never include this file, it may only be used from internal avb code." 31 #endif 32 33 #ifndef AVB_SHA_H_ 34 #define AVB_SHA_H_ 35 36 #ifdef __cplusplus 37 extern "C" { 38 #endif 39 40 #include "avb_crypto.h" 41 #include "avb_sysdeps.h" 42 43 /* The following defines must be set to something appropriate 44 * 45 * AVB_SHA256_CONTEXT_SIZE - the size of AvbSHA256Ctx, excluding the buffer 46 * AVB_SHA512_CONTEXT_SIZE - the size of AvbSHA512Ctx, exclusing the buffer 47 * 48 * For example, if AvbSHA512Ctx is implemented using BoringSSL this would be 49 * defined as sizeof(SHA256_CTX). 50 * 51 * We expect the implementation to provide a header file with the name 52 * avb_crypto_ops_impl.h to do all this. 53 */ 54 #include "avb_crypto_ops_impl.h" 55 56 /* Data structure used for SHA-256. */ 57 typedef struct { 58 uint8_t reserved[AVB_SHA256_CONTEXT_SIZE]; 59 uint8_t buf[AVB_SHA256_DIGEST_SIZE]; /* Used for storing the final digest. */ 60 } AvbSHA256Ctx; 61 62 /* Data structure used for SHA-512. */ 63 typedef struct { 64 uint8_t reserved[AVB_SHA512_CONTEXT_SIZE]; 65 uint8_t buf[AVB_SHA512_DIGEST_SIZE]; /* Used for storing the final digest. */ 66 } AvbSHA512Ctx; 67 68 /* Initializes the SHA-256 context. */ 69 void avb_sha256_init(AvbSHA256Ctx* ctx); 70 71 /* Updates the SHA-256 context with |len| bytes from |data|. */ 72 void avb_sha256_update(AvbSHA256Ctx* ctx, const uint8_t* data, size_t len); 73 74 /* Returns the SHA-256 digest. */ 75 uint8_t* avb_sha256_final(AvbSHA256Ctx* ctx) AVB_ATTR_WARN_UNUSED_RESULT; 76 77 /* Initializes the SHA-512 context. */ 78 void avb_sha512_init(AvbSHA512Ctx* ctx); 79 80 /* Updates the SHA-512 context with |len| bytes from |data|. */ 81 void avb_sha512_update(AvbSHA512Ctx* ctx, const uint8_t* data, size_t len); 82 83 /* Returns the SHA-512 digest. */ 84 uint8_t* avb_sha512_final(AvbSHA512Ctx* ctx) AVB_ATTR_WARN_UNUSED_RESULT; 85 86 #ifdef __cplusplus 87 } 88 #endif 89 90 #endif /* AVB_SHA_H_ */ 91