1 userv-git-daemon is a replacement for the standard git daemon,
2 which provides anonymous remote access to git repositories.
4 It uses userv to invoke the service requested by the client, and users
5 can configure it to map git:// URLs to repositories and enable and
6 disable services as they see fit, without intervention from the system
13 Adjust the paths in ../settings.make as necessary.
14 userv-git-daemon uses $(libuserv), $(etcuserv), and $(services).
18 Create a "userv-git" user that will run the outer part of the git-daemon.
19 Ensure your /etc/services contains a line like "git 9418/tcp".
21 Insert the inetd.conf fragment into your /etc/inetd.conf
22 and tell inetd to reload.
24 As a test user, create a 'public-git' directory, and copy a bare git
25 repository into it, e.g.
26 git clone --bare git://dotat.at/unifdef.git public-git/unifdef.git
28 This repository should now be visible:
29 git ls-remote git://localhost/~test/unifdef.git
35 The userv-git-daemon is invoked by inetd which also tells it where to
36 find its global git-urlmap config.
38 The git-daemon parses the request from the network and uses the global
39 git-urlmap config to determine which user will run the requested
40 service. It invokes userv for the request to be performed. The most
41 common service is git-upload-pack, which is confusingly named: it
42 uploads from the repository to the network; other services supported
43 by git are git-upload-archive and git-receive-pack.
45 The git-daemon will pass any service beginning git- to userv. The
46 userv configuration determines which services may be requested. This
47 package includes example git-upload-pack service configurations.
49 The service configuration uses the git-service script to run the
50 service. It passes the global and per-user git-urlmap configs to the
51 git-service script to determine where in the filesyetem the requested
52 repository is. Later urlmap entries override the choices made by
55 If a repository is located, the git-service script runs the requested
56 service, which is simply the git program with the same name.
62 See "git-urlmap" for syntax description and an example.
65 ----------------------------------------------
66 This was written by Tony Finch <dot@dotat.at> and subsequently
67 heavily modified by Ian Jackson <ijackson@chiark.greenend.org.uk>
68 http://creativecommons.org/publicdomain/zero/1.0/