mdl_library.h

Go to the documentation of this file.

#pragma once
 
#include <stddef.h>
#include <stdint.h>
 
#include "mdl_state.h"
#include "mdl_storage.h"
#include "ra8_err.h"

typedef enum : uint32_t {
  k_mdl_library_entry_limit     = 100000U, 
  k_mdl_library_operation_limit = 500000U, 
  k_mdl_library_depth_limit     = 32U,     
} mdl_library_limit_t;

typedef struct {
  uint32_t max_entries;    
  uint32_t max_operations; 
  uint16_t max_depth;      
} mdl_library_policy_t;

typedef struct {
  char     paths[(size_t)k_mdl_library_depth_limit + 1U][k_fw_fs_path_cap];
  void*    directory_workspace;       
  uint32_t directory_workspace_bytes; 
  uint32_t entries;                   
  uint32_t required_entries;          
  uint32_t entry_limit;               
  uint32_t operations;                
  uint16_t depth;                     
} mdl_library_workspace_t;

[[nodiscard]] ra8_err_t mdl_library_workspace_init(mdl_library_workspace_t* workspace,
                                                   void*                    directory_workspace,
                                                   uint32_t directory_workspace_bytes);

[[nodiscard]] mdl_library_policy_t mdl_library_policy_default(void);

typedef ra8_err_t (*mdl_library_fn)(const char*        series_dir,
                                    const char*        state_path,
                                    const mdl_state_t* state,
                                    void*              ctx,
                                    bool*              out_continue);

[[nodiscard]] ra8_err_t mdl_library_for_each(mdl_storage_t*              storage,
                                             const char*                 out_dir,
                                             mdl_state_t*                state_scratch,
                                             mdl_library_workspace_t*    workspace,
                                             const mdl_library_policy_t* policy,
                                             mdl_library_fn              callback,
                                             void*                       callback_ctx);

[[nodiscard]] ra8_err_t mdl_library_remove_tree(mdl_storage_t*              storage,
                                                const char*                 dir,
                                                const mdl_library_policy_t* policy,
                                                mdl_library_workspace_t*    workspace);