blob: 80f41f041cb251e05a1c62dda62344d524075782 [file] [log] [blame]
= gerrit ban-commit
== NAME
gerrit ban-commit - Bans a commit from a project's repository.
== SYNOPSIS
[verse]
--
_ssh_ -p <port> <host> _gerrit ban-commit_
[--reason <REASON>]
<PROJECT>
<COMMIT> ...
--
== DESCRIPTION
Marks a commit as banned for the specified repository. If a commit is
banned Gerrit rejects every push that includes this commit with
link:error-contains-banned-commit.html[contains banned commit ...].
[NOTE]
This command just marks the commit as banned, but it does not remove
the commit from the history of any central branch. This needs to be
done manually.
== ACCESS
Caller must be owner of the project or be a member of the privileged
'Administrators' group.
== SCRIPTING
This command is intended to be used in scripts.
== OPTIONS
<PROJECT>::
Required; name of the project for which the commit should be
banned.
<COMMIT>::
Required; commit(s) that should be banned.
--reason::
Reason for banning the commit.
== EXAMPLES
Ban commit `421919d015c062fd28901fe144a78a555d0b5984` from project
`myproject`:
----
$ ssh -p 29418 review.example.com gerrit ban-commit myproject \
421919d015c062fd28901fe144a78a555d0b5984
----
GERRIT
------
Part of link:index.html[Gerrit Code Review]
SEARCHBOX
---------