gerrit/Documentation/error-prohibited-by-gerrit.txt
Edwin Kempin e6ac11fa00 Explain 'prohibited by Gerrit' error for pushing of lightweight tags
Pushing a lightweight tag to Gerrit fails with 'prohibited by Gerrit'
if the user does not have '+2 Create Branch' for 'refs/tags/*' in the
'Push Branch' category. This change adds an explanation for this case
to the 'prohibited by Gerrit' error description.

Change-Id: I5dd252a0844ef7d23ceaae0241878da4658789c8
Signed-off-by: Edwin Kempin <edwin.kempin@sap.com>
2011-03-09 07:15:17 +01:00

32 lines
1.4 KiB
Plaintext

prohibited by Gerrit
====================
This is a general error message that is returned by Gerrit if a push
is not allowed, e.g. because the pushing user has no sufficient
privileges.
In particular this error occurs:
1. if you push a commit for code review to a branch for which you
don't have upload permissions (access right '+2 Upload permission'
in the link:access-control.html#category_READ['Read Access'] category)
2. if you bypass code review without sufficient privileges in the
link:access-control.html#category_pHD['Push Branch'] category
3. if you push a signed or annotated tag without sufficient
privileges in the link:access-control.html#category_pTAG['Push Tag'] category
4. if you push a lightweight tag without the access right '+2 Create
Branch' for the reference name 'refs/tags/*' in the link:access-control.html#category_pHD['Push Branch']
category
For new users it happens often that they accidentally try to bypass
code review. The push then fails with the error message 'prohibited
by Gerrit' because the project didn't allow to bypass code review.
Bypassing the code review is done by pushing directly to refs/heads/*
(e.g. refs/heads/master) instead of pushing to refs/for/* (e.g.
refs/for/master). Details about how to push commits for code review
are explained link:user-upload.html#push_create[here].
GERRIT
------
Part of link:error-messages.html[Gerrit Error Messages]