2 * Copyright (C) 2009-2012 the libgit2 contributors
4 * This file is part of libgit2, distributed under the GNU GPL v2 with
5 * a Linking Exception. For full terms see the included COPYING file.
10 #include "repository.h"
16 #include <git2/object.h>
18 #include <git2/branch.h>
22 #define DEFAULT_NESTING_LEVEL 5
23 #define MAX_NESTING_LEVEL 10
26 GIT_PACKREF_HAS_PEEL
= 1,
27 GIT_PACKREF_WAS_LOOSE
= 2
34 char name
[GIT_FLEX_ARRAY
];
37 static int reference_read(
38 git_buf
*file_content
,
40 const char *repo_path
,
45 static int loose_parse_symbolic(git_reference
*ref
, git_buf
*file_content
);
46 static int loose_parse_oid(git_oid
*ref
, git_buf
*file_content
);
47 static int loose_lookup(git_reference
*ref
);
48 static int loose_lookup_to_packfile(struct packref
**ref_out
,
49 git_repository
*repo
, const char *name
);
50 static int loose_write(git_reference
*ref
);
53 static int packed_parse_peel(struct packref
*tag_ref
,
54 const char **buffer_out
, const char *buffer_end
);
55 static int packed_parse_oid(struct packref
**ref_out
,
56 const char **buffer_out
, const char *buffer_end
);
57 static int packed_load(git_repository
*repo
);
58 static int packed_loadloose(git_repository
*repository
);
59 static int packed_write_ref(struct packref
*ref
, git_filebuf
*file
);
60 static int packed_find_peel(git_repository
*repo
, struct packref
*ref
);
61 static int packed_remove_loose(git_repository
*repo
, git_vector
*packing_list
);
62 static int packed_sort(const void *a
, const void *b
);
63 static int packed_lookup(git_reference
*ref
);
64 static int packed_write(git_repository
*repo
);
66 /* internal helpers */
67 static int reference_path_available(git_repository
*repo
,
68 const char *ref
, const char *old_ref
);
69 static int reference_delete(git_reference
*ref
);
70 static int reference_lookup(git_reference
*ref
);
72 void git_reference_free(git_reference
*reference
)
74 if (reference
== NULL
)
77 git__free(reference
->name
);
78 reference
->name
= NULL
;
80 if (reference
->flags
& GIT_REF_SYMBOLIC
) {
81 git__free(reference
->target
.symbolic
);
82 reference
->target
.symbolic
= NULL
;
88 static int reference_alloc(
89 git_reference
**ref_out
,
93 git_reference
*reference
= NULL
;
95 assert(ref_out
&& repo
&& name
);
97 reference
= git__malloc(sizeof(git_reference
));
98 GITERR_CHECK_ALLOC(reference
);
100 memset(reference
, 0x0, sizeof(git_reference
));
101 reference
->owner
= repo
;
103 reference
->name
= git__strdup(name
);
104 GITERR_CHECK_ALLOC(reference
->name
);
106 *ref_out
= reference
;
110 static int reference_read(
111 git_buf
*file_content
,
113 const char *repo_path
,
114 const char *ref_name
,
117 git_buf path
= GIT_BUF_INIT
;
120 assert(file_content
&& repo_path
&& ref_name
);
122 /* Determine the full path of the file */
123 if (git_buf_joinpath(&path
, repo_path
, ref_name
) < 0)
126 result
= git_futils_readbuffer_updated(file_content
, path
.ptr
, mtime
, updated
);
132 static int loose_parse_symbolic(git_reference
*ref
, git_buf
*file_content
)
134 const unsigned int header_len
= (unsigned int)strlen(GIT_SYMREF
);
135 const char *refname_start
;
137 refname_start
= (const char *)file_content
->ptr
;
139 if (git_buf_len(file_content
) < header_len
+ 1) {
140 giterr_set(GITERR_REFERENCE
, "Corrupted loose reference file");
145 * Assume we have already checked for the header
146 * before calling this function
148 refname_start
+= header_len
;
150 ref
->target
.symbolic
= git__strdup(refname_start
);
151 GITERR_CHECK_ALLOC(ref
->target
.symbolic
);
156 static int loose_parse_oid(git_oid
*oid
, git_buf
*file_content
)
158 /* File format: 40 chars (OID) */
159 if (git_buf_len(file_content
) == GIT_OID_HEXSZ
&&
160 git_oid_fromstr(oid
, git_buf_cstr(file_content
)) == 0)
163 giterr_set(GITERR_REFERENCE
, "Corrupted loose reference file");
167 static git_ref_t
loose_guess_rtype(const git_buf
*full_path
)
169 git_buf ref_file
= GIT_BUF_INIT
;
172 type
= GIT_REF_INVALID
;
174 if (git_futils_readbuffer(&ref_file
, full_path
->ptr
) == 0) {
175 if (git__prefixcmp((const char *)(ref_file
.ptr
), GIT_SYMREF
) == 0)
176 type
= GIT_REF_SYMBOLIC
;
181 git_buf_free(&ref_file
);
185 static int loose_lookup(git_reference
*ref
)
188 git_buf ref_file
= GIT_BUF_INIT
;
190 result
= reference_read(&ref_file
, &ref
->mtime
,
191 ref
->owner
->path_repository
, ref
->name
, &updated
);
199 git_buf_rtrim(&ref_file
);
201 if (ref
->flags
& GIT_REF_SYMBOLIC
) {
202 git__free(ref
->target
.symbolic
);
203 ref
->target
.symbolic
= NULL
;
208 if (git__prefixcmp((const char *)(ref_file
.ptr
), GIT_SYMREF
) == 0) {
209 ref
->flags
|= GIT_REF_SYMBOLIC
;
210 result
= loose_parse_symbolic(ref
, &ref_file
);
212 ref
->flags
|= GIT_REF_OID
;
213 result
= loose_parse_oid(&ref
->target
.oid
, &ref_file
);
216 git_buf_free(&ref_file
);
220 static int loose_lookup_to_packfile(
221 struct packref
**ref_out
,
222 git_repository
*repo
,
225 git_buf ref_file
= GIT_BUF_INIT
;
226 struct packref
*ref
= NULL
;
231 if (reference_read(&ref_file
, NULL
, repo
->path_repository
, name
, NULL
) < 0)
234 git_buf_rtrim(&ref_file
);
236 name_len
= strlen(name
);
237 ref
= git__malloc(sizeof(struct packref
) + name_len
+ 1);
238 GITERR_CHECK_ALLOC(ref
);
240 memcpy(ref
->name
, name
, name_len
);
241 ref
->name
[name_len
] = 0;
243 if (loose_parse_oid(&ref
->oid
, &ref_file
) < 0) {
244 git_buf_free(&ref_file
);
249 ref
->flags
= GIT_PACKREF_WAS_LOOSE
;
252 git_buf_free(&ref_file
);
256 static int loose_write(git_reference
*ref
)
258 git_filebuf file
= GIT_FILEBUF_INIT
;
259 git_buf ref_path
= GIT_BUF_INIT
;
262 if (git_buf_joinpath(&ref_path
, ref
->owner
->path_repository
, ref
->name
) < 0)
265 /* Remove a possibly existing empty directory hierarchy
266 * which name would collide with the reference name
268 if (git_path_isdir(git_buf_cstr(&ref_path
)) &&
269 (git_futils_rmdir_r(git_buf_cstr(&ref_path
), GIT_DIRREMOVAL_ONLY_EMPTY_DIRS
) < 0)) {
270 git_buf_free(&ref_path
);
274 if (git_filebuf_open(&file
, ref_path
.ptr
, GIT_FILEBUF_FORCE
) < 0) {
275 git_buf_free(&ref_path
);
279 git_buf_free(&ref_path
);
281 if (ref
->flags
& GIT_REF_OID
) {
282 char oid
[GIT_OID_HEXSZ
+ 1];
284 git_oid_fmt(oid
, &ref
->target
.oid
);
285 oid
[GIT_OID_HEXSZ
] = '\0';
287 git_filebuf_printf(&file
, "%s\n", oid
);
289 } else if (ref
->flags
& GIT_REF_SYMBOLIC
) {
290 git_filebuf_printf(&file
, GIT_SYMREF
"%s\n", ref
->target
.symbolic
);
292 assert(0); /* don't let this happen */
295 if (p_stat(ref_path
.ptr
, &st
) == 0)
296 ref
->mtime
= st
.st_mtime
;
298 return git_filebuf_commit(&file
, GIT_REFS_FILE_MODE
);
301 static int packed_parse_peel(
302 struct packref
*tag_ref
,
303 const char **buffer_out
,
304 const char *buffer_end
)
306 const char *buffer
= *buffer_out
+ 1;
308 assert(buffer
[-1] == '^');
310 /* Ensure it's not the first entry of the file */
314 /* Ensure reference is a tag */
315 if (git__prefixcmp(tag_ref
->name
, GIT_REFS_TAGS_DIR
) != 0)
318 if (buffer
+ GIT_OID_HEXSZ
>= buffer_end
)
321 /* Is this a valid object id? */
322 if (git_oid_fromstr(&tag_ref
->peel
, buffer
) < 0)
325 buffer
= buffer
+ GIT_OID_HEXSZ
;
332 *buffer_out
= buffer
+ 1;
336 giterr_set(GITERR_REFERENCE
, "The packed references file is corrupted");
340 static int packed_parse_oid(
341 struct packref
**ref_out
,
342 const char **buffer_out
,
343 const char *buffer_end
)
345 struct packref
*ref
= NULL
;
347 const char *buffer
= *buffer_out
;
348 const char *refname_begin
, *refname_end
;
353 refname_begin
= (buffer
+ GIT_OID_HEXSZ
+ 1);
354 if (refname_begin
>= buffer_end
|| refname_begin
[-1] != ' ')
357 /* Is this a valid object id? */
358 if (git_oid_fromstr(&id
, buffer
) < 0)
361 refname_end
= memchr(refname_begin
, '\n', buffer_end
- refname_begin
);
362 if (refname_end
== NULL
)
365 if (refname_end
[-1] == '\r')
368 refname_len
= refname_end
- refname_begin
;
370 ref
= git__malloc(sizeof(struct packref
) + refname_len
+ 1);
371 GITERR_CHECK_ALLOC(ref
);
373 memcpy(ref
->name
, refname_begin
, refname_len
);
374 ref
->name
[refname_len
] = 0;
376 git_oid_cpy(&ref
->oid
, &id
);
381 *buffer_out
= refname_end
+ 1;
387 giterr_set(GITERR_REFERENCE
, "The packed references file is corrupted");
391 static int packed_load(git_repository
*repo
)
394 git_buf packfile
= GIT_BUF_INIT
;
395 const char *buffer_start
, *buffer_end
;
396 git_refcache
*ref_cache
= &repo
->references
;
398 /* First we make sure we have allocated the hash table */
399 if (ref_cache
->packfile
== NULL
) {
400 ref_cache
->packfile
= git_strmap_alloc();
401 GITERR_CHECK_ALLOC(ref_cache
->packfile
);
404 result
= reference_read(&packfile
, &ref_cache
->packfile_time
,
405 repo
->path_repository
, GIT_PACKEDREFS_FILE
, &updated
);
408 * If we couldn't find the file, we need to clear the table and
409 * return. On any other error, we return that error. If everything
410 * went fine and the file wasn't updated, then there's nothing new
411 * for us here, so just return. Anything else means we need to
412 * refresh the packed refs.
414 if (result
== GIT_ENOTFOUND
) {
415 git_strmap_clear(ref_cache
->packfile
);
426 * At this point, we want to refresh the packed refs. We already
427 * have the contents in our buffer.
429 git_strmap_clear(ref_cache
->packfile
);
431 buffer_start
= (const char *)packfile
.ptr
;
432 buffer_end
= (const char *)(buffer_start
) + packfile
.size
;
434 while (buffer_start
< buffer_end
&& buffer_start
[0] == '#') {
435 buffer_start
= strchr(buffer_start
, '\n');
436 if (buffer_start
== NULL
)
442 while (buffer_start
< buffer_end
) {
444 struct packref
*ref
= NULL
;
446 if (packed_parse_oid(&ref
, &buffer_start
, buffer_end
) < 0)
449 if (buffer_start
[0] == '^') {
450 if (packed_parse_peel(ref
, &buffer_start
, buffer_end
) < 0)
454 git_strmap_insert(ref_cache
->packfile
, ref
->name
, ref
, err
);
459 git_buf_free(&packfile
);
463 git_strmap_free(ref_cache
->packfile
);
464 ref_cache
->packfile
= NULL
;
465 git_buf_free(&packfile
);
470 struct dirent_list_data
{
471 git_repository
*repo
;
472 size_t repo_path_len
;
473 unsigned int list_flags
;
475 int (*callback
)(const char *, void *);
476 void *callback_payload
;
480 static int _dirent_loose_listall(void *_data
, git_buf
*full_path
)
482 struct dirent_list_data
*data
= (struct dirent_list_data
*)_data
;
483 const char *file_path
= full_path
->ptr
+ data
->repo_path_len
;
485 if (git_path_isdir(full_path
->ptr
) == true)
486 return git_path_direach(full_path
, _dirent_loose_listall
, _data
);
488 /* do not add twice a reference that exists already in the packfile */
489 if ((data
->list_flags
& GIT_REF_PACKED
) != 0 &&
490 git_strmap_exists(data
->repo
->references
.packfile
, file_path
))
493 if (data
->list_flags
!= GIT_REF_LISTALL
) {
494 if ((data
->list_flags
& loose_guess_rtype(full_path
)) == 0)
495 return 0; /* we are filtering out this reference */
498 /* Locked references aren't returned */
499 if (!git__suffixcmp(file_path
, GIT_FILELOCK_EXTENSION
))
502 if (data
->callback(file_path
, data
->callback_payload
))
503 data
->callback_error
= GIT_EUSER
;
505 return data
->callback_error
;
508 static int _dirent_loose_load(void *data
, git_buf
*full_path
)
510 git_repository
*repository
= (git_repository
*)data
;
511 void *old_ref
= NULL
;
513 const char *file_path
;
516 if (git_path_isdir(full_path
->ptr
) == true)
517 return git_path_direach(full_path
, _dirent_loose_load
, repository
);
519 file_path
= full_path
->ptr
+ strlen(repository
->path_repository
);
521 if (loose_lookup_to_packfile(&ref
, repository
, file_path
) < 0)
525 repository
->references
.packfile
, ref
->name
, ref
, old_ref
, err
);
536 * Load all the loose references from the repository
537 * into the in-memory Packfile, and build a vector with
538 * all the references so it can be written back to
541 static int packed_loadloose(git_repository
*repository
)
543 git_buf refs_path
= GIT_BUF_INIT
;
546 /* the packfile must have been previously loaded! */
547 assert(repository
->references
.packfile
);
549 if (git_buf_joinpath(&refs_path
, repository
->path_repository
, GIT_REFS_DIR
) < 0)
553 * Load all the loose files from disk into the Packfile table.
554 * This will overwrite any old packed entries with their
555 * updated loose versions
557 result
= git_path_direach(&refs_path
, _dirent_loose_load
, repository
);
558 git_buf_free(&refs_path
);
564 * Write a single reference into a packfile
566 static int packed_write_ref(struct packref
*ref
, git_filebuf
*file
)
568 char oid
[GIT_OID_HEXSZ
+ 1];
570 git_oid_fmt(oid
, &ref
->oid
);
571 oid
[GIT_OID_HEXSZ
] = 0;
574 * For references that peel to an object in the repo, we must
575 * write the resulting peel on a separate line, e.g.
577 * 6fa8a902cc1d18527e1355773c86721945475d37 refs/tags/libgit2-0.4
578 * ^2ec0cb7959b0bf965d54f95453f5b4b34e8d3100
580 * This obviously only applies to tags.
581 * The required peels have already been loaded into `ref->peel_target`.
583 if (ref
->flags
& GIT_PACKREF_HAS_PEEL
) {
584 char peel
[GIT_OID_HEXSZ
+ 1];
585 git_oid_fmt(peel
, &ref
->peel
);
586 peel
[GIT_OID_HEXSZ
] = 0;
588 if (git_filebuf_printf(file
, "%s %s\n^%s\n", oid
, ref
->name
, peel
) < 0)
591 if (git_filebuf_printf(file
, "%s %s\n", oid
, ref
->name
) < 0)
599 * Find out what object this reference resolves to.
601 * For references that point to a 'big' tag (e.g. an
602 * actual tag object on the repository), we need to
603 * cache on the packfile the OID of the object to
604 * which that 'big tag' is pointing to.
606 static int packed_find_peel(git_repository
*repo
, struct packref
*ref
)
610 if (ref
->flags
& GIT_PACKREF_HAS_PEEL
)
614 * Only applies to tags, i.e. references
615 * in the /refs/tags folder
617 if (git__prefixcmp(ref
->name
, GIT_REFS_TAGS_DIR
) != 0)
621 * Find the tagged object in the repository
623 if (git_object_lookup(&object
, repo
, &ref
->oid
, GIT_OBJ_ANY
) < 0)
627 * If the tagged object is a Tag object, we need to resolve it;
628 * if the ref is actually a 'weak' ref, we don't need to resolve
631 if (git_object_type(object
) == GIT_OBJ_TAG
) {
632 git_tag
*tag
= (git_tag
*)object
;
635 * Find the object pointed at by this tag
637 git_oid_cpy(&ref
->peel
, git_tag_target_oid(tag
));
638 ref
->flags
|= GIT_PACKREF_HAS_PEEL
;
641 * The reference has now cached the resolved OID, and is
642 * marked at such. When written to the packfile, it'll be
643 * accompanied by this resolved oid
647 git_object_free(object
);
652 * Remove all loose references
654 * Once we have successfully written a packfile,
655 * all the loose references that were packed must be
658 * This is a dangerous method; make sure the packfile
659 * is well-written, because we are destructing references
662 static int packed_remove_loose(git_repository
*repo
, git_vector
*packing_list
)
665 git_buf full_path
= GIT_BUF_INIT
;
668 for (i
= 0; i
< packing_list
->length
; ++i
) {
669 struct packref
*ref
= git_vector_get(packing_list
, i
);
671 if ((ref
->flags
& GIT_PACKREF_WAS_LOOSE
) == 0)
674 if (git_buf_joinpath(&full_path
, repo
->path_repository
, ref
->name
) < 0)
675 return -1; /* critical; do not try to recover on oom */
677 if (git_path_exists(full_path
.ptr
) == true && p_unlink(full_path
.ptr
) < 0) {
681 giterr_set(GITERR_REFERENCE
,
682 "Failed to remove loose reference '%s' after packing: %s",
683 full_path
.ptr
, strerror(errno
));
689 * if we fail to remove a single file, this is *not* good,
690 * but we should keep going and remove as many as possible.
691 * After we've removed as many files as possible, we return
692 * the error code anyway.
696 git_buf_free(&full_path
);
697 return failed
? -1 : 0;
700 static int packed_sort(const void *a
, const void *b
)
702 const struct packref
*ref_a
= (const struct packref
*)a
;
703 const struct packref
*ref_b
= (const struct packref
*)b
;
705 return strcmp(ref_a
->name
, ref_b
->name
);
709 * Write all the contents in the in-memory packfile to disk.
711 static int packed_write(git_repository
*repo
)
713 git_filebuf pack_file
= GIT_FILEBUF_INIT
;
715 git_buf pack_file_path
= GIT_BUF_INIT
;
716 git_vector packing_list
;
717 unsigned int total_refs
;
719 assert(repo
&& repo
->references
.packfile
);
722 (unsigned int)git_strmap_num_entries(repo
->references
.packfile
);
724 if (git_vector_init(&packing_list
, total_refs
, packed_sort
) < 0)
727 /* Load all the packfile into a vector */
729 struct packref
*reference
;
731 /* cannot fail: vector already has the right size */
732 git_strmap_foreach_value(repo
->references
.packfile
, reference
, {
733 git_vector_insert(&packing_list
, reference
);
737 /* sort the vector so the entries appear sorted on the packfile */
738 git_vector_sort(&packing_list
);
740 /* Now we can open the file! */
741 if (git_buf_joinpath(&pack_file_path
, repo
->path_repository
, GIT_PACKEDREFS_FILE
) < 0)
744 if (git_filebuf_open(&pack_file
, pack_file_path
.ptr
, 0) < 0)
745 goto cleanup_packfile
;
747 /* Packfiles have a header... apparently
748 * This is in fact not required, but we might as well print it
750 if (git_filebuf_printf(&pack_file
, "%s\n", GIT_PACKEDREFS_HEADER
) < 0)
751 goto cleanup_packfile
;
753 for (i
= 0; i
< packing_list
.length
; ++i
) {
754 struct packref
*ref
= (struct packref
*)git_vector_get(&packing_list
, i
);
756 if (packed_find_peel(repo
, ref
) < 0)
757 goto cleanup_packfile
;
759 if (packed_write_ref(ref
, &pack_file
) < 0)
760 goto cleanup_packfile
;
763 /* if we've written all the references properly, we can commit
764 * the packfile to make the changes effective */
765 if (git_filebuf_commit(&pack_file
, GIT_PACKEDREFS_FILE_MODE
) < 0)
768 /* when and only when the packfile has been properly written,
769 * we can go ahead and remove the loose refs */
770 if (packed_remove_loose(repo
, &packing_list
) < 0)
775 if (p_stat(pack_file_path
.ptr
, &st
) == 0)
776 repo
->references
.packfile_time
= st
.st_mtime
;
779 git_vector_free(&packing_list
);
780 git_buf_free(&pack_file_path
);
786 git_filebuf_cleanup(&pack_file
);
789 git_vector_free(&packing_list
);
790 git_buf_free(&pack_file_path
);
795 struct reference_available_t
{
801 static int _reference_available_cb(const char *ref
, void *data
)
803 struct reference_available_t
*d
;
806 d
= (struct reference_available_t
*)data
;
808 if (!d
->old_ref
|| strcmp(d
->old_ref
, ref
)) {
809 size_t reflen
= strlen(ref
);
810 size_t newlen
= strlen(d
->new_ref
);
811 size_t cmplen
= reflen
< newlen
? reflen
: newlen
;
812 const char *lead
= reflen
< newlen
? d
->new_ref
: ref
;
814 if (!strncmp(d
->new_ref
, ref
, cmplen
) && lead
[cmplen
] == '/') {
823 static int reference_path_available(
824 git_repository
*repo
,
829 struct reference_available_t data
;
832 data
.old_ref
= old_ref
;
835 error
= git_reference_foreach(
836 repo
, GIT_REF_LISTALL
, _reference_available_cb
, (void *)&data
);
840 if (!data
.available
) {
841 giterr_set(GITERR_REFERENCE
,
842 "The path to reference '%s' collides with an existing one", ref
);
849 static int reference_exists(int *exists
, git_repository
*repo
, const char *ref_name
)
851 git_buf ref_path
= GIT_BUF_INIT
;
853 if (packed_load(repo
) < 0)
856 if (git_buf_joinpath(&ref_path
, repo
->path_repository
, ref_name
) < 0)
859 if (git_path_isfile(ref_path
.ptr
) == true ||
860 git_strmap_exists(repo
->references
.packfile
, ref_path
.ptr
))
867 git_buf_free(&ref_path
);
872 * Check if a reference could be written to disk, based on:
874 * - Whether a reference with the same name already exists,
875 * and we are allowing or disallowing overwrites
877 * - Whether the name of the reference would collide with
880 static int reference_can_write(
881 git_repository
*repo
,
883 const char *previous_name
,
886 /* see if the reference shares a path with an existing reference;
887 * if a path is shared, we cannot create the reference, even when forcing */
888 if (reference_path_available(repo
, refname
, previous_name
) < 0)
891 /* check if the reference actually exists, but only if we are not forcing
892 * the rename. If we are forcing, it's OK to overwrite */
896 if (reference_exists(&exists
, repo
, refname
) < 0)
899 /* We cannot proceed if the reference already exists and we're not forcing
900 * the rename; the existing one would be overwritten */
902 giterr_set(GITERR_REFERENCE
,
903 "A reference with that name (%s) already exists", refname
);
908 /* FIXME: if the reference exists and we are forcing, do we really need to
909 * remove the reference first?
913 * - the reference already exists and is loose: not a problem, the file
914 * gets overwritten on disk
916 * - the reference already exists and is packed: we write a new one as
917 * loose, which by all means renders the packed one useless
924 static int packed_lookup(git_reference
*ref
)
926 struct packref
*pack_ref
= NULL
;
927 git_strmap
*packfile_refs
;
930 if (packed_load(ref
->owner
) < 0)
933 /* maybe the packfile hasn't changed at all, so we don't
934 * have to re-lookup the reference */
935 if ((ref
->flags
& GIT_REF_PACKED
) &&
936 ref
->mtime
== ref
->owner
->references
.packfile_time
)
939 if (ref
->flags
& GIT_REF_SYMBOLIC
) {
940 git__free(ref
->target
.symbolic
);
941 ref
->target
.symbolic
= NULL
;
944 /* Look up on the packfile */
945 packfile_refs
= ref
->owner
->references
.packfile
;
946 pos
= git_strmap_lookup_index(packfile_refs
, ref
->name
);
947 if (!git_strmap_valid_index(packfile_refs
, pos
)) {
948 giterr_set(GITERR_REFERENCE
, "Reference '%s' not found", ref
->name
);
949 return GIT_ENOTFOUND
;
952 pack_ref
= git_strmap_value_at(packfile_refs
, pos
);
954 ref
->flags
= GIT_REF_OID
| GIT_REF_PACKED
;
955 ref
->mtime
= ref
->owner
->references
.packfile_time
;
956 git_oid_cpy(&ref
->target
.oid
, &pack_ref
->oid
);
961 static int reference_lookup(git_reference
*ref
)
965 result
= loose_lookup(ref
);
969 /* only try to lookup this reference on the packfile if it
970 * wasn't found on the loose refs; not if there was a critical error */
971 if (result
== GIT_ENOTFOUND
) {
973 result
= packed_lookup(ref
);
978 /* unexpected error; free the reference */
979 git_reference_free(ref
);
984 * Delete a reference.
985 * This is an internal method; the reference is removed
986 * from disk or the packfile, but the pointer is not freed
988 static int reference_delete(git_reference
*ref
)
994 /* If the reference is packed, this is an expensive operation.
995 * We need to reload the packfile, remove the reference from the
996 * packing list, and repack */
997 if (ref
->flags
& GIT_REF_PACKED
) {
998 git_strmap
*packfile_refs
;
999 struct packref
*packref
;
1002 /* load the existing packfile */
1003 if (packed_load(ref
->owner
) < 0)
1006 packfile_refs
= ref
->owner
->references
.packfile
;
1007 pos
= git_strmap_lookup_index(packfile_refs
, ref
->name
);
1008 if (!git_strmap_valid_index(packfile_refs
, pos
)) {
1009 giterr_set(GITERR_REFERENCE
,
1010 "Reference %s stopped existing in the packfile", ref
->name
);
1014 packref
= git_strmap_value_at(packfile_refs
, pos
);
1015 git_strmap_delete_at(packfile_refs
, pos
);
1018 if (packed_write(ref
->owner
) < 0)
1021 /* If the reference is loose, we can just remove the reference
1022 * from the filesystem */
1024 git_reference
*ref_in_pack
;
1025 git_buf full_path
= GIT_BUF_INIT
;
1027 if (git_buf_joinpath(&full_path
, ref
->owner
->path_repository
, ref
->name
) < 0)
1030 result
= p_unlink(full_path
.ptr
);
1031 git_buf_free(&full_path
); /* done with path at this point */
1034 giterr_set(GITERR_OS
, "Failed to unlink '%s'", full_path
.ptr
);
1038 /* When deleting a loose reference, we have to ensure that an older
1039 * packed version of it doesn't exist */
1040 if (git_reference_lookup(&ref_in_pack
, ref
->owner
, ref
->name
) == 0) {
1041 assert((ref_in_pack
->flags
& GIT_REF_PACKED
) != 0);
1042 return git_reference_delete(ref_in_pack
);
1051 int git_reference_delete(git_reference
*ref
)
1053 int result
= reference_delete(ref
);
1054 git_reference_free(ref
);
1058 int git_reference_lookup(git_reference
**ref_out
,
1059 git_repository
*repo
, const char *name
)
1061 return git_reference_lookup_resolved(ref_out
, repo
, name
, 0);
1064 int git_reference_name_to_oid(
1065 git_oid
*out
, git_repository
*repo
, const char *name
)
1070 if ((error
= git_reference_lookup_resolved(&ref
, repo
, name
, -1)) < 0)
1073 git_oid_cpy(out
, git_reference_oid(ref
));
1074 git_reference_free(ref
);
1078 int git_reference_lookup_resolved(
1079 git_reference
**ref_out
,
1080 git_repository
*repo
,
1084 git_reference
*scan
;
1085 int result
, nesting
;
1087 assert(ref_out
&& repo
&& name
);
1091 if (max_nesting
> MAX_NESTING_LEVEL
)
1092 max_nesting
= MAX_NESTING_LEVEL
;
1093 else if (max_nesting
< 0)
1094 max_nesting
= DEFAULT_NESTING_LEVEL
;
1096 scan
= git__calloc(1, sizeof(git_reference
));
1097 GITERR_CHECK_ALLOC(scan
);
1099 scan
->name
= git__calloc(GIT_REFNAME_MAX
+ 1, sizeof(char));
1100 GITERR_CHECK_ALLOC(scan
->name
);
1102 if ((result
= git_reference__normalize_name_lax(
1106 git_reference_free(scan
);
1110 scan
->target
.symbolic
= git__strdup(scan
->name
);
1111 GITERR_CHECK_ALLOC(scan
->target
.symbolic
);
1114 scan
->flags
= GIT_REF_SYMBOLIC
;
1116 for (nesting
= max_nesting
;
1117 nesting
>= 0 && (scan
->flags
& GIT_REF_SYMBOLIC
) != 0;
1120 if (nesting
!= max_nesting
)
1121 strncpy(scan
->name
, scan
->target
.symbolic
, GIT_REFNAME_MAX
);
1125 if ((result
= reference_lookup(scan
)) < 0)
1126 return result
; /* lookup git_reference_free on scan already */
1129 if ((scan
->flags
& GIT_REF_OID
) == 0 && max_nesting
!= 0) {
1130 giterr_set(GITERR_REFERENCE
,
1131 "Cannot resolve reference (>%u levels deep)", max_nesting
);
1132 git_reference_free(scan
);
1143 git_ref_t
git_reference_type(git_reference
*ref
)
1147 if (ref
->flags
& GIT_REF_OID
)
1150 if (ref
->flags
& GIT_REF_SYMBOLIC
)
1151 return GIT_REF_SYMBOLIC
;
1153 return GIT_REF_INVALID
;
1156 int git_reference_is_packed(git_reference
*ref
)
1159 return !!(ref
->flags
& GIT_REF_PACKED
);
1162 const char *git_reference_name(git_reference
*ref
)
1168 git_repository
*git_reference_owner(git_reference
*ref
)
1174 const git_oid
*git_reference_oid(git_reference
*ref
)
1178 if ((ref
->flags
& GIT_REF_OID
) == 0)
1181 return &ref
->target
.oid
;
1184 const char *git_reference_target(git_reference
*ref
)
1188 if ((ref
->flags
& GIT_REF_SYMBOLIC
) == 0)
1191 return ref
->target
.symbolic
;
1194 int git_reference_create_symbolic(
1195 git_reference
**ref_out
,
1196 git_repository
*repo
,
1201 char normalized
[GIT_REFNAME_MAX
];
1202 git_reference
*ref
= NULL
;
1205 if (git_reference__normalize_name_lax(
1211 if ((error
= reference_can_write(repo
, normalized
, NULL
, force
)) < 0)
1214 if (reference_alloc(&ref
, repo
, normalized
) < 0)
1217 ref
->flags
|= GIT_REF_SYMBOLIC
;
1219 /* set the target; this will normalize the name automatically
1220 * and write the reference on disk */
1221 if (git_reference_set_target(ref
, target
) < 0) {
1222 git_reference_free(ref
);
1225 if (ref_out
== NULL
) {
1226 git_reference_free(ref
);
1234 int git_reference_create_oid(
1235 git_reference
**ref_out
,
1236 git_repository
*repo
,
1242 git_reference
*ref
= NULL
;
1243 char normalized
[GIT_REFNAME_MAX
];
1245 if (git_reference__normalize_name_lax(
1251 if ((error
= reference_can_write(repo
, normalized
, NULL
, force
)) < 0)
1254 if (reference_alloc(&ref
, repo
, name
) < 0)
1257 ref
->flags
|= GIT_REF_OID
;
1259 /* set the oid; this will write the reference on disk */
1260 if (git_reference_set_oid(ref
, id
) < 0) {
1261 git_reference_free(ref
);
1265 if (ref_out
== NULL
) {
1266 git_reference_free(ref
);
1274 * Change the OID target of a reference.
1276 * For both loose and packed references, just change
1277 * the oid in memory and (over)write the file in disk.
1279 * We do not repack packed references because of performance
1282 int git_reference_set_oid(git_reference
*ref
, const git_oid
*id
)
1284 git_odb
*odb
= NULL
;
1286 if ((ref
->flags
& GIT_REF_OID
) == 0) {
1287 giterr_set(GITERR_REFERENCE
, "Cannot set OID on symbolic reference");
1293 if (git_repository_odb__weakptr(&odb
, ref
->owner
) < 0)
1296 /* Don't let the user create references to OIDs that
1297 * don't exist in the ODB */
1298 if (!git_odb_exists(odb
, id
)) {
1299 giterr_set(GITERR_REFERENCE
,
1300 "Target OID for the reference doesn't exist on the repository");
1304 /* Update the OID value on `ref` */
1305 git_oid_cpy(&ref
->target
.oid
, id
);
1307 /* Write back to disk */
1308 return loose_write(ref
);
1312 * Change the target of a symbolic reference.
1314 * This is easy because symrefs cannot be inside
1315 * a pack. We just change the target in memory
1316 * and overwrite the file on disk.
1318 int git_reference_set_target(git_reference
*ref
, const char *target
)
1320 char normalized
[GIT_REFNAME_MAX
];
1322 if ((ref
->flags
& GIT_REF_SYMBOLIC
) == 0) {
1323 giterr_set(GITERR_REFERENCE
,
1324 "Cannot set symbolic target on a direct reference");
1328 if (git_reference__normalize_name_lax(
1334 git__free(ref
->target
.symbolic
);
1335 ref
->target
.symbolic
= git__strdup(normalized
);
1336 GITERR_CHECK_ALLOC(ref
->target
.symbolic
);
1338 return loose_write(ref
);
1341 int git_reference_rename(git_reference
*ref
, const char *new_name
, int force
)
1344 unsigned int normalization_flags
;
1345 git_buf aux_path
= GIT_BUF_INIT
;
1346 char normalized
[GIT_REFNAME_MAX
];
1347 bool should_head_be_updated
= false;
1349 normalization_flags
= ref
->flags
& GIT_REF_SYMBOLIC
?
1350 GIT_REF_FORMAT_ALLOW_ONELEVEL
1351 : GIT_REF_FORMAT_NORMAL
;
1353 if (git_reference_normalize_name(
1357 normalization_flags
) < 0)
1360 if (reference_can_write(ref
->owner
, normalized
, ref
->name
, force
) < 0)
1363 /* Initialize path now so we won't get an allocation failure once
1364 * we actually start removing things. */
1365 if (git_buf_joinpath(&aux_path
, ref
->owner
->path_repository
, new_name
) < 0)
1369 * Check if we have to update HEAD.
1371 if ((should_head_be_updated
= git_branch_is_head(ref
)) < 0)
1375 * Now delete the old ref and remove an possibly existing directory
1376 * named `new_name`. Note that using the internal `reference_delete`
1377 * method deletes the ref from disk but doesn't free the pointer, so
1378 * we can still access the ref's attributes for creating the new one
1380 if (reference_delete(ref
) < 0)
1384 * Finally we can create the new reference.
1386 if (ref
->flags
& GIT_REF_SYMBOLIC
) {
1387 result
= git_reference_create_symbolic(
1388 NULL
, ref
->owner
, new_name
, ref
->target
.symbolic
, force
);
1390 result
= git_reference_create_oid(
1391 NULL
, ref
->owner
, new_name
, &ref
->target
.oid
, force
);
1398 * Update HEAD it was poiting to the reference being renamed.
1400 if (should_head_be_updated
&&
1401 git_repository_set_head(ref
->owner
, new_name
) < 0) {
1402 giterr_set(GITERR_REFERENCE
,
1403 "Failed to update HEAD after renaming reference");
1408 * Rename the reflog file, if it exists.
1410 if ((git_reference_has_log(ref
)) && (git_reflog_rename(ref
, new_name
) < 0))
1414 * Change the name of the reference given by the user.
1416 git__free(ref
->name
);
1417 ref
->name
= git__strdup(new_name
);
1419 /* The reference is no longer packed */
1420 ref
->flags
&= ~GIT_REF_PACKED
;
1422 git_buf_free(&aux_path
);
1426 git_buf_free(&aux_path
);
1431 * Try to create the old reference again, ignore failures
1433 if (ref
->flags
& GIT_REF_SYMBOLIC
)
1434 git_reference_create_symbolic(
1435 NULL
, ref
->owner
, ref
->name
, ref
->target
.symbolic
, 0);
1437 git_reference_create_oid(
1438 NULL
, ref
->owner
, ref
->name
, &ref
->target
.oid
, 0);
1440 /* The reference is no longer packed */
1441 ref
->flags
&= ~GIT_REF_PACKED
;
1443 git_buf_free(&aux_path
);
1447 int git_reference_resolve(git_reference
**ref_out
, git_reference
*ref
)
1449 if (ref
->flags
& GIT_REF_OID
)
1450 return git_reference_lookup(ref_out
, ref
->owner
, ref
->name
);
1452 return git_reference_lookup_resolved(ref_out
, ref
->owner
, ref
->target
.symbolic
, -1);
1455 int git_reference_packall(git_repository
*repo
)
1457 if (packed_load(repo
) < 0 || /* load the existing packfile */
1458 packed_loadloose(repo
) < 0 || /* add all the loose refs */
1459 packed_write(repo
) < 0) /* write back to disk */
1465 int git_reference_foreach(
1466 git_repository
*repo
,
1467 unsigned int list_flags
,
1468 int (*callback
)(const char *, void *),
1472 struct dirent_list_data data
;
1473 git_buf refs_path
= GIT_BUF_INIT
;
1475 /* list all the packed references first */
1476 if (list_flags
& GIT_REF_PACKED
) {
1477 const char *ref_name
;
1481 if (packed_load(repo
) < 0)
1484 git_strmap_foreach(repo
->references
.packfile
, ref_name
, ref
, {
1485 if (callback(ref_name
, payload
))
1490 /* now list the loose references, trying not to
1491 * duplicate the ref names already in the packed-refs file */
1493 data
.repo_path_len
= strlen(repo
->path_repository
);
1494 data
.list_flags
= list_flags
;
1496 data
.callback
= callback
;
1497 data
.callback_payload
= payload
;
1498 data
.callback_error
= 0;
1500 if (git_buf_joinpath(&refs_path
, repo
->path_repository
, GIT_REFS_DIR
) < 0)
1503 result
= git_path_direach(&refs_path
, _dirent_loose_listall
, &data
);
1505 git_buf_free(&refs_path
);
1507 return data
.callback_error
? GIT_EUSER
: result
;
1510 static int cb__reflist_add(const char *ref
, void *data
)
1512 return git_vector_insert((git_vector
*)data
, git__strdup(ref
));
1515 int git_reference_list(
1516 git_strarray
*array
,
1517 git_repository
*repo
,
1518 unsigned int list_flags
)
1520 git_vector ref_list
;
1522 assert(array
&& repo
);
1524 array
->strings
= NULL
;
1527 if (git_vector_init(&ref_list
, 8, NULL
) < 0)
1530 if (git_reference_foreach(
1531 repo
, list_flags
, &cb__reflist_add
, (void *)&ref_list
) < 0) {
1532 git_vector_free(&ref_list
);
1536 array
->strings
= (char **)ref_list
.contents
;
1537 array
->count
= ref_list
.length
;
1541 int git_reference_reload(git_reference
*ref
)
1543 return reference_lookup(ref
);
1546 void git_repository__refcache_free(git_refcache
*refs
)
1550 if (refs
->packfile
) {
1551 struct packref
*reference
;
1553 git_strmap_foreach_value(refs
->packfile
, reference
, {
1554 git__free(reference
);
1557 git_strmap_free(refs
->packfile
);
1561 static int is_valid_ref_char(char ch
)
1563 if ((unsigned) ch
<= ' ')
1580 static int ensure_segment_validity(const char *name
)
1582 const char *current
= name
;
1585 if (*current
== '.')
1586 return -1; /* Refname starts with "." */
1588 for (current
= name
; ; current
++) {
1589 if (*current
== '\0' || *current
== '/')
1592 if (!is_valid_ref_char(*current
))
1593 return -1; /* Illegal character in refname */
1595 if (prev
== '.' && *current
== '.')
1596 return -1; /* Refname contains ".." */
1598 if (prev
== '@' && *current
== '{')
1599 return -1; /* Refname contains "@{" */
1604 return (int)(current
- name
);
1607 static bool is_all_caps_and_underscore(const char *name
, size_t len
)
1612 assert(name
&& len
> 0);
1614 for (i
= 0; i
< len
; i
++)
1617 if ((c
< 'A' || c
> 'Z') && c
!= '_')
1621 if (*name
== '_' || name
[len
- 1] == '_')
1627 int git_reference__normalize_name(
1632 // Inspired from https://github.com/git/git/blob/f06d47e7e0d9db709ee204ed13a8a7486149f494/refs.c#L36-100
1635 int segment_len
, segments_count
= 0, error
= -1;
1636 unsigned int process_flags
;
1637 bool normalize
= (buf
!= NULL
);
1640 process_flags
= flags
;
1641 current
= (char *)name
;
1647 segment_len
= ensure_segment_validity(current
);
1648 if (segment_len
< 0) {
1649 if ((process_flags
& GIT_REF_FORMAT_REFSPEC_PATTERN
) &&
1650 current
[0] == '*' &&
1651 (current
[1] == '\0' || current
[1] == '/')) {
1652 /* Accept one wildcard as a full refname component. */
1653 process_flags
&= ~GIT_REF_FORMAT_REFSPEC_PATTERN
;
1659 if (segment_len
> 0) {
1661 size_t cur_len
= git_buf_len(buf
);
1663 git_buf_joinpath(buf
, git_buf_cstr(buf
), current
);
1664 git_buf_truncate(buf
,
1665 cur_len
+ segment_len
+ (segments_count
? 1 : 0));
1667 if (git_buf_oom(buf
))
1674 if (current
[segment_len
] == '\0')
1677 current
+= segment_len
+ 1;
1680 /* A refname can not be empty */
1681 if (segment_len
== 0 && segments_count
== 0)
1684 /* A refname can not end with "." */
1685 if (current
[segment_len
- 1] == '.')
1688 /* A refname can not end with "/" */
1689 if (current
[segment_len
- 1] == '/')
1692 /* A refname can not end with ".lock" */
1693 if (!git__suffixcmp(name
, GIT_FILELOCK_EXTENSION
))
1696 if ((segments_count
== 1 ) && !(flags
& GIT_REF_FORMAT_ALLOW_ONELEVEL
))
1699 if ((segments_count
== 1 ) &&
1700 !(is_all_caps_and_underscore(name
, (size_t)segment_len
) ||
1701 ((flags
& GIT_REF_FORMAT_REFSPEC_PATTERN
) && !strcmp("*", name
))))
1704 if ((segments_count
> 1)
1705 && (is_all_caps_and_underscore(name
, strchr(name
, '/') - name
)))
1714 "The given reference name '%s' is not valid", name
);
1719 int git_reference_normalize_name(
1725 git_buf buf
= GIT_BUF_INIT
;
1728 if ((error
= git_reference__normalize_name(&buf
, name
, flags
)) < 0)
1731 if (git_buf_len(&buf
) > buffer_size
- 1) {
1734 "The provided buffer is too short to hold the normalization of '%s'", name
);
1739 git_buf_copy_cstr(buffer_out
, buffer_size
, &buf
);
1748 int git_reference__normalize_name_lax(
1753 return git_reference_normalize_name(
1757 GIT_REF_FORMAT_ALLOW_ONELEVEL
);
1759 #define GIT_REF_TYPEMASK (GIT_REF_OID | GIT_REF_SYMBOLIC)
1761 int git_reference_cmp(git_reference
*ref1
, git_reference
*ref2
)
1763 assert(ref1
&& ref2
);
1765 /* let's put symbolic refs before OIDs */
1766 if ((ref1
->flags
& GIT_REF_TYPEMASK
) != (ref2
->flags
& GIT_REF_TYPEMASK
))
1767 return (ref1
->flags
& GIT_REF_SYMBOLIC
) ? -1 : 1;
1769 if (ref1
->flags
& GIT_REF_SYMBOLIC
)
1770 return strcmp(ref1
->target
.symbolic
, ref2
->target
.symbolic
);
1772 return git_oid_cmp(&ref1
->target
.oid
, &ref2
->target
.oid
);
1775 /* Update the reference named `ref_name` so it points to `oid` */
1776 int git_reference__update(git_repository
*repo
, const git_oid
*oid
, const char *ref_name
)
1781 res
= git_reference_lookup(&ref
, repo
, ref_name
);
1783 /* If we haven't found the reference at all, we assume we need to create
1784 * a new reference and that's it */
1785 if (res
== GIT_ENOTFOUND
) {
1787 return git_reference_create_oid(NULL
, repo
, ref_name
, oid
, 1);
1793 /* If we have found a reference, but it's symbolic, we need to update
1794 * the direct reference it points to */
1795 if (git_reference_type(ref
) == GIT_REF_SYMBOLIC
) {
1797 const char *sym_target
;
1799 /* The target pointed at by this reference */
1800 sym_target
= git_reference_target(ref
);
1802 /* resolve the reference to the target it points to */
1803 res
= git_reference_resolve(&aux
, ref
);
1806 * if the symbolic reference pointed to an inexisting ref,
1807 * this is means we're creating a new branch, for example.
1808 * We need to create a new direct reference with that name
1810 if (res
== GIT_ENOTFOUND
) {
1812 res
= git_reference_create_oid(NULL
, repo
, sym_target
, oid
, 1);
1813 git_reference_free(ref
);
1817 /* free the original symbolic reference now; not before because
1818 * we're using the `sym_target` pointer */
1819 git_reference_free(ref
);
1824 /* store the newly found direct reference in its place */
1828 /* ref is made to point to `oid`: ref is either the original reference,
1829 * or the target of the symbolic reference we've looked up */
1830 res
= git_reference_set_oid(ref
, oid
);
1831 git_reference_free(ref
);
1835 struct glob_cb_data
{
1837 int (*callback
)(const char *, void *);
1841 static int fromglob_cb(const char *reference_name
, void *payload
)
1843 struct glob_cb_data
*data
= (struct glob_cb_data
*)payload
;
1845 if (!p_fnmatch(data
->glob
, reference_name
, 0))
1846 return data
->callback(reference_name
, data
->payload
);
1851 int git_reference_foreach_glob(
1852 git_repository
*repo
,
1854 unsigned int list_flags
,
1856 const char *reference_name
,
1860 struct glob_cb_data data
;
1862 assert(repo
&& glob
&& callback
);
1865 data
.callback
= callback
;
1866 data
.payload
= payload
;
1868 return git_reference_foreach(
1869 repo
, list_flags
, fromglob_cb
, &data
);
1872 int git_reference_has_log(
1875 git_buf path
= GIT_BUF_INIT
;
1880 if (git_buf_join_n(&path
, '/', 3, ref
->owner
->path_repository
, GIT_REFLOG_DIR
, ref
->name
) < 0)
1883 result
= git_path_isfile(git_buf_cstr(&path
));
1884 git_buf_free(&path
);
1889 int git_reference_is_branch(git_reference
*ref
)
1892 return git__prefixcmp(ref
->name
, GIT_REFS_HEADS_DIR
) == 0;
1895 int git_reference_is_remote(git_reference
*ref
)
1898 return git__prefixcmp(ref
->name
, GIT_REFS_REMOTES_DIR
) == 0;
1901 static int peel_error(int error
, git_reference
*ref
, const char* msg
)
1905 "The reference '%s' cannot be peeled - %s", git_reference_name(ref
), msg
);
1909 static int reference_target(git_object
**object
, git_reference
*ref
)
1913 oid
= git_reference_oid(ref
);
1915 return git_object_lookup(object
, git_reference_owner(ref
), oid
, GIT_OBJ_ANY
);
1918 int git_reference_peel(
1919 git_object
**peeled
,
1921 git_otype target_type
)
1923 git_reference
*resolved
= NULL
;
1924 git_object
*target
= NULL
;
1929 if ((error
= git_reference_resolve(&resolved
, ref
)) < 0)
1930 return peel_error(error
, ref
, "Cannot resolve reference");
1932 if ((error
= reference_target(&target
, resolved
)) < 0) {
1933 peel_error(error
, ref
, "Cannot retrieve reference target");
1937 if (target_type
== GIT_OBJ_ANY
&& git_object_type(target
) != GIT_OBJ_TAG
)
1938 error
= git_object__dup(peeled
, target
);
1940 error
= git_object_peel(peeled
, target
, target_type
);
1943 git_object_free(target
);
1944 git_reference_free(resolved
);
1948 int git_reference__is_valid_name(
1949 const char *refname
,
1953 return git_reference__normalize_name(NULL
, refname
, flags
) == 0;
1956 int git_reference_is_valid_name(
1957 const char *refname
)
1959 return git_reference__is_valid_name(
1961 GIT_REF_FORMAT_ALLOW_ONELEVEL
);