| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 1 | = gerrit ban-commit |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 2 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 3 | == NAME |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 4 | gerrit ban-commit - Bans a commit from a project's repository. |
| 5 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 6 | == SYNOPSIS |
| Michael Ochmann | e2d76a1 | 2016-06-23 17:07:37 +0200 | [diff] [blame] | 7 | [verse] |
| Yuxuan 'fishy' Wang | d85b687 | 2013-11-15 11:47:46 -0800 | [diff] [blame] | 8 | -- |
| Michael Ochmann | e2d76a1 | 2016-06-23 17:07:37 +0200 | [diff] [blame] | 9 | _ssh_ -p <port> <host> _gerrit ban-commit_ |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 10 | [--reason <REASON>] |
| 11 | <PROJECT> |
| 12 | <COMMIT> ... |
| Yuxuan 'fishy' Wang | d85b687 | 2013-11-15 11:47:46 -0800 | [diff] [blame] | 13 | -- |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 14 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 15 | == DESCRIPTION |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 16 | Marks a commit as banned for the specified repository. If a commit is |
| 17 | banned Gerrit rejects every push that includes this commit with |
| 18 | link:error-contains-banned-commit.html[contains banned commit ...]. |
| 19 | |
| 20 | [NOTE] |
| 21 | This command just marks the commit as banned, but it does not remove |
| 22 | the commit from the history of any central branch. This needs to be |
| 23 | done manually. |
| 24 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 25 | == ACCESS |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 26 | Caller must be owner of the project or be a member of the privileged |
| 27 | 'Administrators' group. |
| 28 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 29 | == SCRIPTING |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 30 | This command is intended to be used in scripts. |
| 31 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 32 | == OPTIONS |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 33 | <PROJECT>:: |
| 34 | Required; name of the project for which the commit should be |
| 35 | banned. |
| 36 | |
| 37 | <COMMIT>:: |
| 38 | Required; commit(s) that should be banned. |
| 39 | |
| 40 | --reason:: |
| 41 | Reason for banning the commit. |
| 42 | |
| Yuxuan 'fishy' Wang | 61698b1 | 2013-12-20 12:55:51 -0800 | [diff] [blame] | 43 | == EXAMPLES |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 44 | Ban commit `421919d015c062fd28901fe144a78a555d0b5984` from project |
| 45 | `myproject`: |
| 46 | |
| Michael Ochmann | b99feab | 2016-07-06 14:10:22 +0200 | [diff] [blame] | 47 | ---- |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 48 | $ ssh -p 29418 review.example.com gerrit ban-commit myproject \ |
| 49 | 421919d015c062fd28901fe144a78a555d0b5984 |
| Michael Ochmann | b99feab | 2016-07-06 14:10:22 +0200 | [diff] [blame] | 50 | ---- |
| Edwin Kempin | f485a0d | 2012-03-30 08:11:47 +0200 | [diff] [blame] | 51 | |
| 52 | GERRIT |
| 53 | ------ |
| 54 | Part of link:index.html[Gerrit Code Review] |
| Yuxuan 'fishy' Wang | 99cb68d | 2013-10-31 17:26:00 -0700 | [diff] [blame] | 55 | |
| 56 | SEARCHBOX |
| 57 | --------- |
