libgit2

git_config_add_file_ondisk

Version:

Add an on-disk config file instance to an existing config

The on-disk file pointed at by path will be opened and parsed; it's expected to be a native Git config file following the default Git config syntax (see man git-config).

If the file does not exist, the file will still be added and it will be created the first time we write to it.

Note that the configuration object will free the file automatically.

Further queries on this config object will access each of the config file instances in order (instances with a higher priority level will be accessed first).

Signature

GitHub
int git_config_add_file_ondisk(git_config *cfg, const char *path, git_config_level_t level, const git_repository *repo, int force);

Parameters

git_config *
In
cfg

the configuration to add the file to

const char *
In
path

path to the configuration file to add

git_config_level_t
In
level

the priority level of the backend

const git_repository *
In
repo

optional repository to allow parsing of conditional includes

int
In
force

replace config file at the given priority level

Returns

int

0 on success, GIT_EEXISTS when adding more than one file for a given priority level (and force_replace set to 0), GIT_ENOTFOUND when the file doesn't exist or error code

Versions