]>
git.proxmox.com Git - libgit2.git/blob - include/git2/sys/refdb_backend.h
2 * Copyright (C) the libgit2 contributors. All rights reserved.
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.
7 #ifndef INCLUDE_sys_git_refdb_backend_h__
8 #define INCLUDE_sys_git_refdb_backend_h__
10 #include "git2/common.h"
11 #include "git2/types.h"
15 * @file git2/refdb_backend.h
16 * @brief Git custom refs backend functions
17 * @defgroup git_refdb_backend Git custom refs backend API
25 * Every backend's iterator must have a pointer to itself as the first
26 * element, so the API can talk to it. You'd define your iterator as
28 * struct my_iterator {
29 * git_reference_iterator parent;
33 * and assign `iter->parent.backend` to your `git_refdb_backend`.
35 struct git_reference_iterator
{
39 * Return the current reference and advance the iterator.
43 git_reference_iterator
*iter
);
46 * Return the name of the current reference and advance the iterator
49 const char **ref_name
,
50 git_reference_iterator
*iter
);
56 git_reference_iterator
*iter
);
59 /** An instance for a custom backend */
60 struct git_refdb_backend
{
64 * Queries the refdb backend to determine if the given ref_name
65 * exists. A refdb implementation must provide this function.
69 git_refdb_backend
*backend
,
70 const char *ref_name
);
73 * Queries the refdb backend for a given reference. A refdb
74 * implementation must provide this function.
78 git_refdb_backend
*backend
,
79 const char *ref_name
);
82 * Allocate an iterator object for the backend.
84 * A refdb implementation must provide this function.
87 git_reference_iterator
**iter
,
88 struct git_refdb_backend
*backend
,
92 * Writes the given reference to the refdb. A refdb implementation
93 * must provide this function.
95 int (*write
)(git_refdb_backend
*backend
, const git_reference
*ref
);
98 * Deletes the given reference from the refdb. A refdb implementation
99 * must provide this function.
101 int (*delete)(git_refdb_backend
*backend
, const git_reference
*ref
);
104 * Suggests that the given refdb compress or optimize its references.
105 * This mechanism is implementation specific. (For on-disk reference
106 * databases, this may pack all loose references.) A refdb
107 * implementation may provide this function; if it is not provided,
108 * nothing will be done.
110 int (*compress
)(git_refdb_backend
*backend
);
113 * Frees any resources held by the refdb. A refdb implementation may
114 * provide this function; if it is not provided, nothing will be done.
116 void (*free
)(git_refdb_backend
*backend
);
119 #define GIT_ODB_BACKEND_VERSION 1
120 #define GIT_ODB_BACKEND_INIT {GIT_ODB_BACKEND_VERSION}
123 * Constructors for default filesystem-based refdb backend
125 * Under normal usage, this is called for you when the repository is
126 * opened / created, but you can use this to explicitly construct a
127 * filesystem refdb backend for a repository.
129 * @param backend_out Output pointer to the git_refdb_backend object
130 * @param repo Git repository to access
131 * @return 0 on success, <0 error code on failure
133 GIT_EXTERN(int) git_refdb_backend_fs(
134 git_refdb_backend
**backend_out
,
135 git_repository
*repo
);
138 * Sets the custom backend to an existing reference DB
140 * The `git_refdb` will take ownership of the `git_refdb_backend` so you
141 * should NOT free it after calling this function.
143 * @param refdb database to add the backend to
144 * @param backend pointer to a git_refdb_backend instance
145 * @return 0 on success; error code otherwise
147 GIT_EXTERN(int) git_refdb_set_backend(
149 git_refdb_backend
*backend
);