libgit2

git_tag_create_lightweight

Version:

Create a new lightweight tag pointing at a target object

A new direct reference will be created pointing to this target object. If force is true and a reference already exists with the given name, it'll be replaced.

Signature

GitHub
int git_tag_create_lightweight(git_oid *oid, git_repository *repo, const char *tag_name, const git_object *target, int force);

Parameters

git_oid *
In
oid

Pointer where to store the OID of the provided target object. If the tag already exists, this parameter will be filled with the oid of the existing pointed object and the function will return a GIT_EEXISTS error code.

git_repository *
In
repo

Repository where to store the lightweight tag

const char *
In
tag_name

Name for the tag; this name is validated for consistency. It should also not conflict with an already existing tag name

const git_object *
In
target

Object to which this tag points. This object must belong to the given repo.

int
In
force

Overwrite existing references

Returns

int

GIT_SUCCESS or an error code A proper reference is written in the /refs/tags folder, pointing to the provided target object

Versions