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.

The tag name will be checked for validity. See git_tag_create() for rules about valid names.

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

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

Versions