Paul Martin
2016-04-30 a502d96a860456ec5e8c96761db70f7cabb74751
src/site/faq.mkd
@@ -1,5 +1,13 @@
## Troubleshooting
### push failed for branch (n/a (unpacker error))
This is a bug in JGit (issue-408).  TLDR: Newer git clients are optimized to send less data on the wire.  JGit expects complete data to be sent, but there are scenarios where native git can optimize-out sending objects.  By default, JGit requires everything sent be complete and referenceable.
If you experience this, the workaround is to temporarily disable the reachable check for the receive pack, push, and then re-enable the setting.
    git.checkReferencedObjectsAreReachable = false
### Eclipse/Egit/JGit complains that it "can't open upload pack"?
There are a few ways this can occur:
@@ -111,7 +119,7 @@
Care must be taken to preserve the relationship between user roles and repository names.<br/>Please see the *User Roles* section of the [setup](/setup.html) page for details.
### Can I restrict access to branches or paths within a repository?
No, not out-of-the-box.  Access restrictions apply to the repository as a whole.
No, not yet.  Access restrictions apply to the repository as a whole.
Gitblit's simple authentication and authorization mechanism can be used to facilitate one or more of the [workflows outlined here](http://progit.org/book/ch5-1.html).
@@ -121,10 +129,6 @@
### Can I authenticate users against XYZ?
Yes.  The user service is pluggable.  You may write your own complete user service by implementing the *com.gitblit.IUserService* interface.  Or you may subclass *com.gitblit.GitblitUserService* and override just the authentication. Set the fully qualified classname as the *realm.userService* property.
### Why doesn't Gitblit support SSH?
It will.  This feature is in development and should land in the 1.5.0 release.
### What types of Search does Gitblit support?