1#ifndef REFS_H 2#define REFS_H 3 4struct ref_lock { 5char*ref_name; 6char*orig_ref_name; 7struct lock_file *lk; 8unsigned char old_sha1[20]; 9int lock_fd; 10int force_write; 11}; 12 13#define REF_ISSYMREF 01 14#define REF_ISPACKED 02 15 16/* 17 * Calls the specified function for each ref file until it returns nonzero, 18 * and returns the value 19 */ 20typedefinteach_ref_fn(const char*refname,const unsigned char*sha1,int flags,void*cb_data); 21externinthead_ref(each_ref_fn,void*); 22externintfor_each_ref(each_ref_fn,void*); 23externintfor_each_tag_ref(each_ref_fn,void*); 24externintfor_each_branch_ref(each_ref_fn,void*); 25externintfor_each_remote_ref(each_ref_fn,void*); 26 27/* can be used to learn about broken ref and symref */ 28externintfor_each_rawref(each_ref_fn,void*); 29 30externvoidwarn_dangling_symref(const char*msg_fmt,const char*refname); 31 32/* 33 * Extra refs will be listed by for_each_ref() before any actual refs 34 * for the duration of this process or until clear_extra_refs() is 35 * called. Only extra refs added before for_each_ref() is called will 36 * be listed on a given call of for_each_ref(). 37 */ 38externvoidadd_extra_ref(const char*refname,const unsigned char*sha1,int flags); 39externvoidclear_extra_refs(void); 40 41externintpeel_ref(const char*,unsigned char*); 42 43/** Locks a "refs/" ref returning the lock on success and NULL on failure. **/ 44externstruct ref_lock *lock_ref_sha1(const char*ref,const unsigned char*old_sha1); 45 46/** Locks any ref (for 'HEAD' type refs). */ 47#define REF_NODEREF 0x01 48externstruct ref_lock *lock_any_ref_for_update(const char*ref,const unsigned char*old_sha1,int flags); 49 50/** Close the file descriptor owned by a lock and return the status */ 51externintclose_ref(struct ref_lock *lock); 52 53/** Close and commit the ref locked by the lock */ 54externintcommit_ref(struct ref_lock *lock); 55 56/** Release any lock taken but not written. **/ 57externvoidunlock_ref(struct ref_lock *lock); 58 59/** Writes sha1 into the ref specified by the lock. **/ 60externintwrite_ref_sha1(struct ref_lock *lock,const unsigned char*sha1,const char*msg); 61 62/** Reads log for the value of ref during at_time. **/ 63externintread_ref_at(const char*ref,unsigned long at_time,int cnt,unsigned char*sha1,char**msg,unsigned long*cutoff_time,int*cutoff_tz,int*cutoff_cnt); 64 65/* iterate over reflog entries */ 66typedefinteach_reflog_ent_fn(unsigned char*osha1,unsigned char*nsha1,const char*,unsigned long,int,const char*,void*); 67intfor_each_reflog_ent(const char*ref, each_reflog_ent_fn fn,void*cb_data); 68intfor_each_recent_reflog_ent(const char*ref, each_reflog_ent_fn fn,long,void*cb_data); 69 70/* 71 * Calls the specified function for each reflog file until it returns nonzero, 72 * and returns the value 73 */ 74externintfor_each_reflog(each_ref_fn,void*); 75 76#define CHECK_REF_FORMAT_OK 0 77#define CHECK_REF_FORMAT_ERROR (-1) 78#define CHECK_REF_FORMAT_ONELEVEL (-2) 79#define CHECK_REF_FORMAT_WILDCARD (-3) 80externintcheck_ref_format(const char*target); 81 82externconst char*prettify_ref(const struct ref *ref); 83 84/** rename ref, return 0 on success **/ 85externintrename_ref(const char*oldref,const char*newref,const char*logmsg); 86 87/** resolve ref in nested "gitlink" repository */ 88externintresolve_gitlink_ref(const char*name,const char*refname,unsigned char*result); 89 90/** lock a ref and then write its file */ 91enum action_on_err { MSG_ON_ERR, DIE_ON_ERR, QUIET_ON_ERR }; 92intupdate_ref(const char*action,const char*refname, 93const unsigned char*sha1,const unsigned char*oldval, 94int flags,enum action_on_err onerr); 95 96#endif/* REFS_H */