mirror of
https://git.proxmox.com/git/libgit2
synced 2025-05-07 09:05:58 +00:00
9a97f49e3a
This changes the get_entry() method to return a refcounted version of the config entry, which you have to free when you're done. This allows us to avoid freeing the memory in which the entry is stored on a refresh, which may happen at any time for a live config. For this reason, get_string() has been forbidden on live configs and a new function get_string_buf() has been added, which stores the string in a git_buf which the user then owns. The functions which parse the string value takea advantage of the borrowing to parse safely and then release the entry.
86 lines
2.5 KiB
C
86 lines
2.5 KiB
C
/*
|
|
* Copyright (C) the libgit2 contributors. All rights reserved.
|
|
*
|
|
* This file is part of libgit2, distributed under the GNU GPL v2 with
|
|
* a Linking Exception. For full terms see the included COPYING file.
|
|
*/
|
|
#ifndef INCLUDE_config_h__
|
|
#define INCLUDE_config_h__
|
|
|
|
#include "git2.h"
|
|
#include "git2/config.h"
|
|
#include "vector.h"
|
|
#include "repository.h"
|
|
|
|
#define GIT_CONFIG_FILENAME_SYSTEM "gitconfig"
|
|
#define GIT_CONFIG_FILENAME_GLOBAL ".gitconfig"
|
|
#define GIT_CONFIG_FILENAME_XDG "config"
|
|
|
|
#define GIT_CONFIG_FILENAME_INREPO "config"
|
|
#define GIT_CONFIG_FILE_MODE 0666
|
|
|
|
struct git_config {
|
|
git_refcount rc;
|
|
git_vector files;
|
|
};
|
|
|
|
extern int git_config__global_location(git_buf *buf);
|
|
|
|
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 */
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
extern int git_config_file__ondisk(git_config_backend **out, const char *path);
|
|
|
|
extern int git_config__normalize_name(const char *in, char **out);
|
|
|
|
/* internal only: does not normalize key and sets out to NULL if not found */
|
|
extern int git_config__lookup_entry(
|
|
git_config_entry **out,
|
|
const git_config *cfg,
|
|
const char *key,
|
|
bool no_errors);
|
|
|
|
/* 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);
|
|
|
|
/*
|
|
* 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 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);
|
|
|
|
/* 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);
|
|
|
|
#endif
|