opendev/gerrit
Code Issues Proposed changes

Added explanation for "One or more refs/for/ ..." error

Browse Source 
Added a documentation page that explains the
"One or more refs/for/ names blocks change upload"
error and what can be done to solve the problem.

Change-Id: I11dc3c72afcd600b1f5d4fdbed44a0d5278b0da3
Signed-off-by: Edwin Kempin <edwin.kempin@gmail.com>
This commit is contained in:
Edwin Kempin 2011-01-27 08:03:25 +01:00
parent 84739ac801
commit 41f4ae738a
2 changed files with 42 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
Documentation/error-change-upload-blocked.txt Normal file
View File

@ -0,0 +1,41 @@
One or more refs/for/ names blocks change upload
================================================
With this error message Gerrit rejects to push a commit for code
review if the remote git repository has a branch under the
'refs/for/' namespace.
Gerrit uses the 'refs/for/' namespace for magical refs that represent
the review queues for branches in the git repository hosted by
Gerrit. If, for a project, a real branch is created under the
'refs/for' namespace this conflicts with the namespace reserved for
the Gerrit review queues and Gerrit can't accept further pushes for
code review.
To solve this problem all real branches that exist under the
'refs/for/' namespace have to be deleted or renamed in the remote git
repository.
To see which branches exist under the 'refs/for/' namespace a Gerrit
administrator can run the following command:
----
$ git for-each-ref refs/for
----
If all these branches should be deleted it can be done with the
following command:
----
$ for n in $(git for-each-ref --format='%(refname)' refs/for);
do git update-ref -d $n; done
----
Branches under the 'refs/for/' namespace can be created by users that
bypass Gerrit and push directly to the git repository itself (not
using the Gerrit server's SSH port).
GERRIT
------
Part of link:error-messages.html[Gerrit Error Messages]

1
Documentation/error-messages.txt
View File

@ -17,6 +17,7 @@ Error Messages
* link:error-no-new-changes.html[no new changes]
* link:error-not-a-gerrit-project.html[not a Gerrit project]
* link:error-not-valid-ref.html[not valid ref]
* link:error-change-upload-blocked.html[One or more refs/for/ names blocks change upload]
* link:error-permission-denied.html[Permission denied (publickey)]
* link:error-prohibited-by-gerrit.html[prohibited by Gerrit]
* link:error-squash-commits-first.html[squash commits first]