thodg/libgit2/src/config.h

• Show log

  Commit

• Hash : 5540d947
  Author :
  Date : 2013-03-15T16:39:00
  

  Implement global/system file search paths
  
  The goal of this work is to expose the search logic for "global",
  "system", and "xdg" files through the git_libgit2_opts() interface.
  
  Behind the scenes, I changed the logic for finding files to have a
  notion of a git_strarray that represents a search path and to store
  a separate search path for each of the three tiers of config file.
  For each tier, I implemented a function to initialize it to default
  values (generally based on environment variables), and then general
  interfaces to get it, set it, reset it, and prepend new directories
  to it.
  
  Next, I exposed these interfaces through the git_libgit2_opts
  interface, reusing the GIT_CONFIG_LEVEL_SYSTEM, etc., constants
  for the user to control which search path they were modifying.
  There are alternative designs for the opts interface / argument
  ordering, so I'm putting this phase out for discussion.
  
  Additionally, I ended up doing a little bit of clean up regarding
  attr.h and attr_file.h, adding a new attrcache.h so the other two
  files wouldn't have to be included in so many places.
  

Download

• src/config.h

• /*
   * 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_find_global_r(git_buf *global_config_path);
  extern int git_config_find_xdg_r(git_buf *system_config_path);
  extern int git_config_find_system_r(git_buf *system_config_path);
  
  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(struct git_config_backend **out, const char *path);
  
  #endif
  

Download