1 7b19e0f1 2017-11-05 stsp /*
 2 7b19e0f1 2017-11-05 stsp  * Copyright (c) 2017 Stefan Sperling <stsp@openbsd.org>
 3 7b19e0f1 2017-11-05 stsp  *
 4 7b19e0f1 2017-11-05 stsp  * Permission to use, copy, modify, and distribute this software for any
 5 7b19e0f1 2017-11-05 stsp  * purpose with or without fee is hereby granted, provided that the above
 6 7b19e0f1 2017-11-05 stsp  * copyright notice and this permission notice appear in all copies.
 7 7b19e0f1 2017-11-05 stsp  *
 8 7b19e0f1 2017-11-05 stsp  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 9 7b19e0f1 2017-11-05 stsp  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 7b19e0f1 2017-11-05 stsp  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 7b19e0f1 2017-11-05 stsp  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 7b19e0f1 2017-11-05 stsp  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 7b19e0f1 2017-11-05 stsp  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 7b19e0f1 2017-11-05 stsp  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 7b19e0f1 2017-11-05 stsp  */
16 7b19e0f1 2017-11-05 stsp 
17 4027f31a 2017-11-04 stsp /* A symbolic reference. */
18 4027f31a 2017-11-04 stsp struct got_symref {
19 4027f31a 2017-11-04 stsp 	char *name;
20 4027f31a 2017-11-04 stsp 	char *ref;
21 4027f31a 2017-11-04 stsp };
22 4027f31a 2017-11-04 stsp 
23 4027f31a 2017-11-04 stsp /* A non-symbolic reference (there is no better designation). */
24 4027f31a 2017-11-04 stsp struct got_ref {
25 4027f31a 2017-11-04 stsp 	char *name;
26 4027f31a 2017-11-04 stsp 	u_int8_t sha1[SHA1_DIGEST_LENGTH];
27 4027f31a 2017-11-04 stsp };
28 4027f31a 2017-11-04 stsp 
29 4027f31a 2017-11-04 stsp /* A reference which points to an arbitrary object. */
30 4027f31a 2017-11-04 stsp struct got_reference {
31 4027f31a 2017-11-04 stsp 	unsigned int flags;
32 4027f31a 2017-11-04 stsp #define GOT_REF_IS_SYMBOLIC	0x01
33 4027f31a 2017-11-04 stsp 
34 4027f31a 2017-11-04 stsp 	union {
35 4027f31a 2017-11-04 stsp 		struct got_ref ref;
36 4027f31a 2017-11-04 stsp 		struct got_symref symref;
37 4027f31a 2017-11-04 stsp 	} ref;
38 4027f31a 2017-11-04 stsp };
39 4027f31a 2017-11-04 stsp 
40 4027f31a 2017-11-04 stsp /* Well-known reference names. */
41 4027f31a 2017-11-04 stsp #define GOT_REF_HEAD		"HEAD"
42 4027f31a 2017-11-04 stsp #define GOT_REF_ORIG_HEAD	"ORIG_HEAD"
43 4027f31a 2017-11-04 stsp #define GOT_REF_MERGE_HEAD	"MERGE_HEAD"
44 4df642d9 2017-11-05 stsp #define GOT_REF_FETCH_HEAD	"FETCH_HEAD"
45 4027f31a 2017-11-04 stsp 
46 11995603 2017-11-05 stsp struct got_repository;
47 11995603 2017-11-05 stsp struct got_object_id;
48 4027f31a 2017-11-04 stsp 
49 11995603 2017-11-05 stsp const struct got_error * got_ref_open(struct got_reference **,
50 11995603 2017-11-05 stsp     struct got_repository *, const char *);
51 4027f31a 2017-11-04 stsp void got_ref_close(struct got_reference *);
52 11995603 2017-11-05 stsp struct got_reference *got_ref_dup(struct got_reference *);
53 11995603 2017-11-05 stsp const struct got_error *got_ref_resolve(struct got_object_id **,
54 11995603 2017-11-05 stsp     struct got_repository *, struct got_reference *);