config.h 2.47 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
#include "git2.h"
11
#include "git2/config.h"
12
#include "vector.h"
13
#include "repository.h"
14

15
#define GIT_CONFIG_FILENAME_SYSTEM "gitconfig"
16 17 18 19
#define GIT_CONFIG_FILENAME_GLOBAL ".gitconfig"
#define GIT_CONFIG_FILENAME_XDG    "config"

#define GIT_CONFIG_FILENAME_INREPO "config"
20
#define GIT_CONFIG_FILE_MODE 0666
21

22
struct git_config {
23
	git_refcount rc;
24
	git_vector files;
25 26
};

27 28
extern int git_config__global_location(git_buf *buf);

29 30 31 32 33
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 */

34 35 36 37 38 39 40 41 42 43 44
/**
 * Create a configuration file backend for ondisk files
 *
 * These are the normal `.gitconfig` files that Core Git
 * processes. Note that you first have to add this file to a
 * configuration object before you can query it for configuration
 * variables.
 *
 * @param out the new backend
 * @param path where the config file is located
 */
45
extern int git_config_file__ondisk(git_config_backend **out, const char *path);
46

47 48
extern int git_config__normalize_name(const char *in, char **out);

49 50 51 52 53 54 55
/* internal only: does not normalize key and sets out to NULL if not found */
extern int git_config__lookup_entry(
	const git_config_entry **out,
	const git_config *cfg,
	const char *key,
	bool no_errors);

56 57 58 59 60 61 62 63
/* 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);

64 65 66 67 68 69 70 71 72 73 74 75 76 77
/*
 * 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.
 */

extern const char *git_config__get_string_force(
	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);
78

79 80 81 82 83 84
/* API for repository cvar-style lookups from config - not cached, but
 * uses cvar value maps and fallbacks
 */
extern int git_config__cvar(
	int *out, git_config *config, git_cvar_cached cvar);

85
#endif