ra8_c6link_mdl_transfer.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
 
#include "ra8_c6link_mdl.h"
#include "ra8_err.h"

typedef enum : uint64_t {
  k_ra8_mdl_transfer_bytes_max = UINT64_C(67108864), 
} ra8_mdl_transfer_limit_t;

typedef struct ra8_mdl_storage_iface {
  ra8_err_t (*begin)(void* ctx, const char* destination);
  ra8_err_t (*write)(void* ctx, const uint8_t* data, uint16_t len, uint16_t* written);
  ra8_err_t (*validate)(void*         ctx,
                        uint64_t      total_bytes,
                        const uint8_t sha256[k_ra8_mdl_sha256_bytes]);
  ra8_err_t (*commit)(void* ctx);
  ra8_err_t (*abort)(void* ctx);
  void* ctx; 
} ra8_mdl_storage_iface_t;

typedef struct ra8_mdl_sha256_iface {
  ra8_err_t (*init)(void* ctx);
  ra8_err_t (*update)(void* ctx, const uint8_t* data, uint16_t len);
  ra8_err_t (*final)(void* ctx, uint8_t out[k_ra8_mdl_sha256_bytes]);
  void* ctx; 
} ra8_mdl_sha256_iface_t;

typedef bool (*ra8_mdl_cancel_requested_fn)(void* ctx);

typedef struct ra8_mdl_transfer_config {
  ra8_mdl_storage_iface_t     storage;          
  ra8_mdl_sha256_iface_t      sha256;           
  mdl_format_t                format;           
  ra8_mdl_http_policy_t       http;             
  ra8_mdl_cancel_requested_fn cancel_requested; 
  void*                       cancel_ctx;       
  uint16_t                    chunk_bytes;      
  uint32_t                    max_chunks;       
} ra8_mdl_transfer_config_t;

typedef struct ra8_mdl_transfer_result {
  uint64_t                bytes_stored;                   
  uint32_t                chunks_received;                
  mdl_format_t            format;                         
  uint8_t                 sha256[k_ra8_mdl_sha256_bytes]; 
  ra8_mdl_http_response_t response;                       
} ra8_mdl_transfer_result_t;
 
#ifdef __cplusplus
extern "C" {
#endif

[[nodiscard]] ra8_err_t ra8_c6link_mdl_transfer(ra8_c6link_t*                    link,
                                                const char*                      url,
                                                const char*                      destination,
                                                const ra8_mdl_transfer_config_t* config,
                                                ra8_mdl_transfer_result_t*       result);
 
#ifdef __cplusplus
}
#endif