rcbench/api/link__update__image_8h_source.html

#ifndef RCBENCH_LINK_UPDATE_IMAGE_H

#define RCBENCH_LINK_UPDATE_IMAGE_H


#include <stdbool.h>

#include <stdint.h>


#include "link_sha256.h"


#ifdef __cplusplus

extern "C" {

#endif


#define LINK_IMAGE_SCAN_BYTES 4096u

#define LINK_IMAGE_MAX_BLOCKS 8u

#define LINK_IMAGE_TBYB_BIT 0x80u


int32_t link_update_tbyb_byte(const uint8_t *img, uint32_t len);


typedef struct {

    link_sha256_t sha;

    uint32_t      pos;

    uint32_t      len;

    int32_t       flag_at;

    bool          flag_set;

} link_image_hash_t;


void link_image_hash_begin(link_image_hash_t *h, uint32_t len,

                           int32_t flag_at, bool flag_set);


uint8_t link_image_byte(const uint8_t *img, uint32_t at, int32_t flag_at,

                        bool flag_set);


bool link_image_hash_step(link_image_hash_t *h, const uint8_t *src,

                          uint32_t n);


void link_image_hash_end(link_image_hash_t *h,

                         uint8_t out[LINK_SHA256_BYTES]);


void link_update_build_hash(const uint8_t *img, uint32_t len,

                            uint8_t out[LINK_SHA256_BYTES]);


#ifdef __cplusplus

}

#endif


#endif /* RCBENCH_LINK_UPDATE_IMAGE_H */

link_sha256.h
SHA-256 (Secure Hash Algorithm, 256-bit digest), as FIPS (Federal Information Processing Standard) 18...

LINK_SHA256_BYTES
#define LINK_SHA256_BYTES
Bytes in a digest.
Definition link_sha256.h:27

link_image_hash_end
void link_image_hash_end(link_image_hash_t *h, uint8_t out[LINK_SHA256_BYTES])
Write the digest; only meaningful once link_image_hash_step() said so.
Definition link_update_image.c:196

link_image_hash_step
bool link_image_hash_step(link_image_hash_t *h, const uint8_t *src, uint32_t n)
Fold in up to n bytes from src, which holds the image's bytes from h->pos on.
Definition link_update_image.c:169

link_image_byte
uint8_t link_image_byte(const uint8_t *img, uint32_t at, int32_t flag_at, bool flag_set)
The byte at at of img as the hash and the transfer read it: the TBYB bit set or cleared at flag_at,...
Definition link_update_image.c:159

link_image_hash_begin
void link_image_hash_begin(link_image_hash_t *h, uint32_t len, int32_t flag_at, bool flag_set)
Start a hash of an image.
Definition link_update_image.c:133

link_update_build_hash
void link_update_build_hash(const uint8_t *img, uint32_t len, uint8_t out[LINK_SHA256_BYTES])
The SHA-256 that names the build in img: every byte, the TBYB flag read as clear.
Definition link_update_image.c:204

link_update_tbyb_byte
int32_t link_update_tbyb_byte(const uint8_t *img, uint32_t len)
The byte offset of the TBYB flag in img: byte 3 of the IMAGE_TYPE item of the last IMAGE_DEF block of...
Definition link_update_image.c:92

link_image_hash_t
A SHA-256 over len bytes fed in pieces, the byte at flag_at read with LINK_IMAGE_TBYB_BIT set or clea...
Definition link_update_image.h:60

link_sha256_t
The state of a SHA-256 computation in progress.
Definition link_sha256.h:32