refs.hon commit Elaborate on why ':' is a bad idea in a ref name. (87a56cd)
   1#ifndef REFS_H
   2#define REFS_H
   3
   4/*
   5 * Calls the specified function for each ref file until it returns nonzero,
   6 * and returns the value
   7 */
   8extern int head_ref(int (*fn)(const char *path, const unsigned char *sha1));
   9extern int for_each_ref(int (*fn)(const char *path, const unsigned char *sha1));
  10extern int for_each_tag_ref(int (*fn)(const char *path, const unsigned char *sha1));
  11extern int for_each_branch_ref(int (*fn)(const char *path, const unsigned char *sha1));
  12extern int for_each_remote_ref(int (*fn)(const char *path, const unsigned char *sha1));
  13
  14/** Reads the refs file specified into sha1 **/
  15extern int get_ref_sha1(const char *ref, unsigned char *sha1);
  16
  17/** Locks ref and returns the fd to give to write_ref_sha1() if the ref
  18 * has the given value currently; otherwise, returns -1.
  19 **/
  20extern int lock_ref_sha1(const char *ref, const unsigned char *old_sha1);
  21
  22/** Writes sha1 into the refs file specified, locked with the given fd. **/
  23extern int write_ref_sha1(const char *ref, int fd, const unsigned char *sha1);
  24
  25/** Writes sha1 into the refs file specified. **/
  26extern int write_ref_sha1_unlocked(const char *ref, const unsigned char *sha1);
  27
  28/** Returns 0 if target has the right format for a ref. **/
  29extern int check_ref_format(const char *target);
  30
  31#endif /* REFS_H */