config.h 3.21 KB
Newer Older
Vicent Marti committed
1
/*
Edward Thomson committed
2
 * Copyright (C) the libgit2 contributors. All rights reserved.
Vicent Marti committed
3 4 5 6
 *
 * This file is part of libgit2, distributed under the GNU GPL v2 with
 * a Linking Exception. For full terms see the included COPYING file.
 */
7 8 9
#ifndef INCLUDE_config_h__
#define INCLUDE_config_h__

10 11
#include "common.h"

12
#include "git2.h"
13
#include "git2/config.h"
14
#include "vector.h"
15
#include "repository.h"
16

17
#define GIT_CONFIG_FILENAME_PROGRAMDATA "config"
18
#define GIT_CONFIG_FILENAME_SYSTEM "gitconfig"
19 20 21 22
#define GIT_CONFIG_FILENAME_GLOBAL ".gitconfig"
#define GIT_CONFIG_FILENAME_XDG    "config"

#define GIT_CONFIG_FILENAME_INREPO "config"
23
#define GIT_CONFIG_FILE_MODE 0666
24

25
struct git_config {
26
	git_refcount rc;
27
	git_vector backends;
28 29
};

30 31 32 33 34 35
extern int git_config__global_location(git_str *buf);

extern int git_config__find_global(git_str *path);
extern int git_config__find_xdg(git_str *path);
extern int git_config__find_system(git_str *path);
extern int git_config__find_programdata(git_str *path);
36

37 38 39 40 41
extern int git_config_rename_section(
	git_repository *repo,
	const char *old_section_name,	/* eg "branch.dummy" */
	const char *new_section_name);	/* NULL to drop the old section */

42 43
extern int git_config__normalize_name(const char *in, char **out);

44 45
/* internal only: does not normalize key and sets out to NULL if not found */
extern int git_config__lookup_entry(
46
	git_config_entry **out,
47 48 49 50
	const git_config *cfg,
	const char *key,
	bool no_errors);

51 52 53 54 55 56 57 58
/* internal only: update and/or delete entry string with constraints */
extern int git_config__update_entry(
	git_config *cfg,
	const char *key,
	const char *value,
	bool overwrite_existing,
	bool only_if_existing);

59 60 61 62 63 64 65 66
int git_config__get_path(
	git_str *out,
	const git_config *cfg,
	const char *name);

int git_config__get_string_buf(
	git_str *out, const git_config *cfg, const char *name);

67 68 69 70 71 72
/*
 * Lookup functions that cannot fail.  These functions look up a config
 * value and return a fallback value if the value is missing or if any
 * failures occur while trying to access the value.
 */

73
extern char *git_config__get_string_force(
74 75 76 77 78 79 80
	const git_config *cfg, const char *key, const char *fallback_value);

extern int git_config__get_bool_force(
	const git_config *cfg, const char *key, int fallback_value);

extern int git_config__get_int_force(
	const git_config *cfg, const char *key, int fallback_value);
81

82 83
/* API for repository configmap-style lookups from config - not cached, but
 * uses configmap value maps and fallbacks
84
 */
85 86
extern int git_config__configmap_lookup(
	int *out, git_config *config, git_configmap_item item);
87

88 89 90 91
/**
 * The opposite of git_config_lookup_map_value, we take an enum value
 * and map it to the string or bool value on the config.
 */
92 93 94
int git_config_lookup_map_enum(git_configmap_t *type_out,
	const char **str_out, const git_configmap *maps,
	size_t map_n, int enum_val);
95 96 97 98 99 100 101 102 103 104 105 106 107 108 109

/**
 * Unlock the backend with the highest priority
 *
 * Unlocking will allow other writers to updat the configuration
 * file. Optionally, any changes performed since the lock will be
 * applied to the configuration.
 *
 * @param cfg the configuration
 * @param commit boolean which indicates whether to commit any changes
 * done since locking
 * @return 0 or an error code
 */
GIT_EXTERN(int) git_config_unlock(git_config *cfg, int commit);

110
#endif