thodg/libgit2/src/refs.h

• Show log

  Commit

• Hash : d4a0b124
  Author :
  Date : 2011-10-30T21:58:33
  

  refs: Partial rewrite for read-only refs This new version of the references code is significantly faster and hopefully easier to read. External API stays the same. A new method `git_reference_reload()` has been added to force updating a memory reference from disk. In-memory references are no longer updated automagically -- this was killing us. If a reference is deleted externally and the user doesn't reload the memory object, nothing critical happens: any functions using that reference should fail gracefully (e.g. deletion, renaming, and so on). All generated references from the API are read only and must be free'd by the user. There is no reference counting and no traces of generated references are kept in the library. There is no longer an internal representation for references. There is only one reference struct `git_reference`, and symbolic/oid targets are stored inside an union. Packfile references are stored using an optimized struct with flex array for reference names. This should significantly reduce the memory cost of loading the packfile from disk.

Download

• src/refs.h

• /*
   * Copyright (C) 2009-2011 the libgit2 contributors
   *
   * 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_refs_h__
  #define INCLUDE_refs_h__
  
  #include "common.h"
  #include "git2/oid.h"
  #include "git2/refs.h"
  #include "hashtable.h"
  
  #define GIT_REFS_DIR "refs/"
  #define GIT_REFS_HEADS_DIR GIT_REFS_DIR "heads/"
  #define GIT_REFS_TAGS_DIR GIT_REFS_DIR "tags/"
  #define GIT_REFS_REMOTES_DIR GIT_REFS_DIR "remotes/"
  #define GIT_REFS_DIR_MODE 0777
  #define GIT_REFS_FILE_MODE 0666
  
  #define GIT_RENAMED_REF_FILE GIT_REFS_DIR "RENAMED-REF"
  
  #define GIT_SYMREF "ref: "
  #define GIT_PACKEDREFS_FILE "packed-refs"
  #define GIT_PACKEDREFS_HEADER "# pack-refs with: peeled "
  
  #define GIT_HEAD_FILE "HEAD"
  #define GIT_FETCH_HEAD_FILE "FETCH_HEAD"
  #define GIT_MERGE_HEAD_FILE "MERGE_HEAD"
  #define GIT_REFS_HEADS_MASTER_FILE GIT_REFS_HEADS_DIR "master"
  
  #define GIT_REFNAME_MAX 1024
  
  struct git_reference {
  	unsigned int flags;
  	git_repository *owner;
  	char *name;
  	time_t mtime;
  
  	union {
  		git_oid oid;
  		char *symbolic;
  	} target;
  };
  
  typedef struct {
  	git_hashtable *packfile;
  	time_t packfile_time;
  } git_refcache;
  
  void git_repository__refcache_free(git_refcache *refs);
  
  int git_reference__normalize_name(char *buffer_out, size_t out_size, const char *name);
  int git_reference__normalize_name_oid(char *buffer_out, size_t out_size, const char *name);
  
  #endif
  

Download