native_app_config.h File Reference

Declares app-local runtime configuration helpers and the app-local configuration record. More...

Go to the source code of this file.

Data Structures
struct	AppLocalConfigNative
	App-local configuration values loaded from app-local config and manifest authority fields. More...

Functions
App-local configuration helpers
char *	resolve_conf_relative_path_native (const char *conf_path, const char *raw_value)
	Resolves a config value relative to the directory that owns a config file.
char *	app_local_conf_path_native (const char *app_root)
	Builds the path to an app-local runtime configuration file.
char *	app_local_conf_value_native (const char *app_root, const char *key)
	Looks up one key from the app-local runtime configuration.
int	load_app_local_config_native (const char *app_root, AppLocalConfigNative *config)
	Loads app-local configuration and manifest-derived path hints into a config record.
void	free_app_local_config_native (AppLocalConfigNative *config)
	Releases heap-owned fields in an app-local configuration record.
char *	normalize_base_path_native (const char *raw_value)
	Normalizes a configured app base path into Pharos runtime form.

Detailed Description

Declares app-local runtime configuration helpers and the app-local configuration record.

Definition in file native_app_config.h.

Function Documentation

app_local_conf_path_native()

char * app_local_conf_path_native

(

const char *

app_root

)

Builds the path to an app-local runtime configuration file.

Parameters

app_root

Root directory of the Pharos app.

Returns

Newly allocated config path, or NULL on allocation failure.

Definition at line 44 of file native_app_config.c.

References path_exists(), and path_join().

Referenced by dynamic_merged_config_value_runtime(), load_app_local_config_native(), native_dynamic_config_merged_value_dup(), and resolved_runtime_conf_path_from_config_native().

app_local_conf_value_native()

char * app_local_conf_value_native	(	const char *	app_root,
		const char *	key )

Looks up one key from the app-local runtime configuration.

Parameters

app_root	Root directory of the Pharos app.
key	Configuration key to read.

Returns

Newly allocated value string, or NULL when the key is not present or cannot be read.

Definition at line 85 of file native_app_config.c.

References duplicate_config_field_native(), free_app_local_config_native(), load_app_local_config_native(), and streq().

free_app_local_config_native()

void free_app_local_config_native

(

AppLocalConfigNative *

config

)

Releases heap-owned fields in an app-local configuration record.

Parameters

config

Configuration record to clear.

Definition at line 180 of file native_app_config.c.

References AppLocalConfigNative::base_path, AppLocalConfigNative::build_dir, AppLocalConfigNative::conf_path, AppLocalConfigNative::debug, AppLocalConfigNative::error_report_path, AppLocalConfigNative::log_path, AppLocalConfigNative::manifest_base_path, AppLocalConfigNative::manifest_build_artifact_dir, AppLocalConfigNative::manifest_state_path, AppLocalConfigNative::socket_path, AppLocalConfigNative::state_dir, and AppLocalConfigNative::state_path.

Referenced by app_base_path_local_native(), app_build_dir_local_native(), app_debug_local_native(), app_error_report_path_local_native(), app_local_conf_value_native(), app_log_path_local_native(), app_state_path_local_native(), effective_app_artifact_dir_native(), and load_app_runtime_for_single_app().

load_app_local_config_native()

int load_app_local_config_native	(	const char *	app_root,
		AppLocalConfigNative *	config )

Loads app-local configuration and manifest-derived path hints into a config record.

Parameters

app_root	Root directory of the Pharos app.
config	Destination record to populate.

Returns

0 on success, or a non-zero native status code on failure.

Definition at line 120 of file native_app_config.c.

References app_local_conf_path_native(), AppLocalConfigNative::base_path, AppLocalConfigNative::build_dir, conf_lookup_value_in_text(), AppLocalConfigNative::conf_path, AppLocalConfigNative::debug, AppLocalConfigNative::error_report_path, json_find_string_in_section(), AppLocalConfigNative::log_path, AppLocalConfigNative::manifest_base_path, AppLocalConfigNative::manifest_build_artifact_dir, AppLocalConfigNative::manifest_state_path, path_exists(), path_join(), read_file_text(), resolve_conf_value_key_native(), AppLocalConfigNative::socket_path, AppLocalConfigNative::state_dir, and AppLocalConfigNative::state_path.

Referenced by app_base_path_local_native(), app_build_dir_local_native(), app_debug_local_native(), app_error_report_path_local_native(), app_local_conf_value_native(), app_log_path_local_native(), app_state_path_local_native(), effective_app_artifact_dir_native(), and load_app_runtime_for_single_app().

normalize_base_path_native()

char * normalize_base_path_native

(

const char *

raw_value

)

Normalizes a configured app base path into Pharos runtime form.

Parameters

raw_value

Raw base path text from config or manifest data.

Returns

Newly allocated normalized base path, or NULL on failure.

Definition at line 199 of file native_app_config.c.

References len, pharos_app_config_strdup, and streq().

Referenced by app_base_path_local_native(), and effective_app_base_path_native().

resolve_conf_relative_path_native()

char * resolve_conf_relative_path_native	(	const char *	conf_path,
		const char *	raw_value )

Resolves a config value relative to the directory that owns a config file.

Parameters

conf_path	Path to the config file that supplied the value.
raw_value	Raw config value to resolve.

Returns

Newly allocated resolved path, or NULL when no path can be produced.

Definition at line 20 of file native_app_config.c.

References path_dirname(), path_join(), and pharos_app_config_strdup.

Referenced by native_dynamic_config_resolve_value_dup(), resolve_conf_value_key_native(), resolve_dynamic_config_value_runtime(), and runtime_apps_dir_native().