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).

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, unsigned int level, int force);

Parameters

git_config *
In
cfg

the configuration to add the file to

const char *
In
path

path to the configuration file (backend) to add

unsigned int
In
level

the priority level of the backend

int
In
force

if a config file already exists for the given priority level, replace it

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