thodg/libgit2/src/refs.h

• Show log

  Commit

• Hash : ab8d9242
  Author :
  Date : 2014-06-28T06:39:38
  

  Introduce reference transactions A transaction allows you to lock multiple references and set up changes for them before applying the changes all at once (or as close as the backend supports). This can be used for replication purposes, or for making sure some operations run when the reference is locked and thus cannot be changed.

Download

• src/refs.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_refs_h__
  #define INCLUDE_refs_h__
  
  #include "common.h"
  #include "git2/oid.h"
  #include "git2/refs.h"
  #include "git2/refdb.h"
  #include "strmap.h"
  #include "buffer.h"
  #include "oid.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_NOTES_DIR GIT_REFS_DIR "notes/"
  #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 fully-peeled "
  #define GIT_PACKEDREFS_FILE_MODE 0666
  
  #define GIT_HEAD_FILE "HEAD"
  #define GIT_ORIG_HEAD_FILE "ORIG_HEAD"
  #define GIT_FETCH_HEAD_FILE "FETCH_HEAD"
  #define GIT_MERGE_HEAD_FILE "MERGE_HEAD"
  #define GIT_REVERT_HEAD_FILE "REVERT_HEAD"
  #define GIT_CHERRYPICK_HEAD_FILE "CHERRY_PICK_HEAD"
  #define GIT_BISECT_LOG_FILE "BISECT_LOG"
  #define GIT_REBASE_MERGE_DIR "rebase-merge/"
  #define GIT_REBASE_MERGE_INTERACTIVE_FILE GIT_REBASE_MERGE_DIR "interactive"
  #define GIT_REBASE_APPLY_DIR "rebase-apply/"
  #define GIT_REBASE_APPLY_REBASING_FILE GIT_REBASE_APPLY_DIR "rebasing"
  #define GIT_REBASE_APPLY_APPLYING_FILE GIT_REBASE_APPLY_DIR "applying"
  #define GIT_REFS_HEADS_MASTER_FILE GIT_REFS_HEADS_DIR "master"
  
  #define GIT_STASH_FILE "stash"
  #define GIT_REFS_STASH_FILE GIT_REFS_DIR GIT_STASH_FILE
  
  #define GIT_REF_FORMAT__PRECOMPOSE_UNICODE	(1u << 16)
  
  #define GIT_REFNAME_MAX 1024
  
  typedef char git_refname_t[GIT_REFNAME_MAX];
  
  struct git_reference {
  	git_refdb *db;
  	git_ref_t type;
  
  	union {
  		git_oid oid;
  		char *symbolic;
  	} target;
  
  	git_oid peel;
  	char name[GIT_FLEX_ARRAY];
  };
  
  git_reference *git_reference__set_name(git_reference *ref, const char *name);
  
  int git_reference__normalize_name(git_buf *buf, const char *name, unsigned int flags);
  int git_reference__update_terminal(git_repository *repo, const char *ref_name, const git_oid *oid, const git_signature *signature, const char *log_message);
  int git_reference__is_valid_name(const char *refname, unsigned int flags);
  int git_reference__is_branch(const char *ref_name);
  int git_reference__is_remote(const char *ref_name);
  int git_reference__is_tag(const char *ref_name);
  
  /**
   * Lookup a reference by name and try to resolve to an OID.
   *
   * You can control how many dereferences this will attempt to resolve the
   * reference with the `max_deref` parameter, or pass -1 to use a sane
   * default.  If you pass 0 for `max_deref`, this will not attempt to resolve
   * the reference.  For any value of `max_deref` other than 0, not
   * successfully resolving the reference will be reported as an error.
  
   * The generated reference must be freed by the user.
   *
   * @param reference_out Pointer to the looked-up reference
   * @param repo The repository to look up the reference
   * @param name The long name for the reference (e.g. HEAD, ref/heads/master, refs/tags/v0.1.0, ...)
   * @param max_deref Maximum number of dereferences to make of symbolic refs, 0 means simple lookup, < 0 means use default reasonable value
   * @return 0 on success or < 0 on error; not being able to resolve the reference is an error unless 0 was passed for max_deref
   */
  int git_reference_lookup_resolved(
  	git_reference **reference_out,
  	git_repository *repo,
  	const char *name,
  	int max_deref);
  
  int git_reference__log_signature(git_signature **out, git_repository *repo);
  
  #endif
  

Download