|  | = 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 | 
|  | --------- |