libgit2

git_reset

Version:

Sets the current head to the specified commit oid and optionally resets the index and working tree to match.

SOFT reset means the Head will be moved to the commit.

MIXED reset will trigger a SOFT reset, plus the index will be replaced with the content of the commit tree.

HARD reset will trigger a MIXED reset and the working directory will be replaced with the content of the index. (Untracked and ignored files will be left alone, however.)

TODO: Implement remaining kinds of resets.

Signature

GitHub
int git_reset(git_repository *repo, git_object *target, git_reset_t reset_type, git_checkout_options *checkout_opts, const git_signature *signature, const char *log_message);

Parameters

git_repository *
In
repo

Repository where to perform the reset operation.

git_object *
In
target

Committish to which the Head should be moved to. This object must belong to the given repo and can either be a git_commit or a git_tag. When a git_tag is being passed, it should be dereferencable to a git_commit which oid will be used as the target of the branch.

git_reset_t
In
reset_type

Kind of reset operation to perform.

git_checkout_options *
In
checkout_opts

Checkout options to be used for a HARD reset. The checkout_strategy field will be overridden (based on reset_type). This parameter can be used to propagate notify and progress callbacks.

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. The reflog is only updated if the affected direct reference is actually changing. If NULL, the default is "reset: moving"; if you want something more useful, provide a message.

Returns

int

0 on success or an error code

Versions