libgit2

git_reference_symbolic_set_target

Version:

Create a new reference with the same name as the given reference but a different symbolic target. The reference must be a symbolic reference, otherwise this will fail.

The new reference will be written to disk, overwriting the given reference.

The target name will be checked for validity. See git_reference_symbolic_create() for rules about valid names.

The signature and message for the reflog will be ignored if the reference does not belong in the standard set (HEAD, branches and remote-tracking branches) and and it does not have a reflog.

Signature

GitHub
int git_reference_symbolic_set_target(git_reference **out, git_reference *ref, const char *target, const git_signature *signature, const char *log_message);

Parameters

git_reference **
In
out

Pointer to the newly created reference

git_reference *
In
ref

The reference

const char *
In
target

The new target for the reference

const git_signature *
In
signature

The identity that will used to populate the reflog entry

const char *
In
log_message

The one line long message to be appended to the reflog

Returns

int

0 on success, GIT_EINVALIDSPEC or an error code

Versions