native_dynamic_config.h

Go to the documentation of this file.

#ifndef PHAROS_NATIVE_DYNAMIC_CONFIG_H
#define PHAROS_NATIVE_DYNAMIC_CONFIG_H
 
/**
 * @file
 * @brief Declares Pharos-owned dynamic runtime config resolution helpers.
 */
 
/**
 * @brief Returns whether a dynamic config key resolves relative to its config file.
 *
 * @param key Config key name.
 * @return Non-zero when the key is path-bearing, otherwise 0.
 */
int native_dynamic_config_key_is_path(const char *key);
 
/**
 * @brief Resolves one raw dynamic config value against its owning config file.
 *
 * @param conf_path Path to the config file that supplied the value.
 * @param key Config key name.
 * @param raw_value Raw config value.
 * @return Newly allocated resolved value, or NULL when no value is available.
 */
char *native_dynamic_config_resolve_value_dup(
  const char *conf_path,
  const char *key,
  const char *raw_value
);
 
/**
 * @brief Loads one raw dynamic config value from a config file when it exists.
 *
 * @param conf_path Config file path.
 * @param key Config key name.
 * @return Newly allocated raw value, or NULL when the key or file is missing.
 */
char *native_dynamic_config_lookup_raw_dup(const char *conf_path, const char *key);
 
/**
 * @brief Loads one merged dynamic config value with runtime-conf precedence over app-local config.
 *
 * @param app_root App root directory.
 * @param runtime_conf_path Runtime config path from the environment.
 * @param key Config key name.
 * @return Newly allocated resolved value, or NULL when the key is absent.
 */
char *native_dynamic_config_merged_value_dup(
  const char *app_root,
  const char *runtime_conf_path,
  const char *key
);
 
#endif