]>
Commit | Line | Data |
---|---|---|
7fc9d69f JH |
1 | git-daemon(1) |
2 | ============= | |
3 | ||
4 | NAME | |
5 | ---- | |
72e9340c | 6 | git-daemon - A really simple server for git repositories. |
7fc9d69f JH |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
2707da9c | 10 | 'git-daemon' [--verbose] [--syslog] [--inetd | --port=n] [--export-all] |
ce335fe0 | 11 | [--timeout=n] [--init-timeout=n] [--strict-paths] [directory...] |
7fc9d69f JH |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
62cd033d LAS |
15 | A really simple TCP git daemon that normally listens on port "DEFAULT_GIT_PORT" |
16 | aka 9418. It waits for a connection, and will just execute "git-upload-pack" | |
17 | when it gets one. | |
18 | ||
19 | It's careful in that there's a magic request-line that gives the command and | |
20 | what directory to upload, and it verifies that the directory is ok. | |
7fc9d69f | 21 | |
62cd033d LAS |
22 | It verifies that the directory has the magic file "git-daemon-export-ok", and |
23 | it will refuse to export any git directory that hasn't explicitly been marked | |
2707da9c PB |
24 | for export this way (unless the '--export-all' parameter is specified). If you |
25 | pass some directory paths as 'git-daemon' arguments, you can further restrict | |
26 | the offers to a whitelist comprising of those. | |
62cd033d LAS |
27 | |
28 | This is ideally suited for read-only updates, ie pulling from git repositories. | |
7fc9d69f JH |
29 | |
30 | OPTIONS | |
31 | ------- | |
ce335fe0 | 32 | --strict-paths:: |
4dbd1352 AE |
33 | Match paths exactly (i.e. don't allow "/foo/repo" when the real path is |
34 | "/foo/repo.git" or "/foo/repo/.git") and don't do user-relative paths. | |
35 | git-daemon will refuse to start when this option is enabled and no | |
36 | whitelist is specified. | |
37 | ||
2707da9c PB |
38 | --export-all:: |
39 | Allow pulling from all directories that look like GIT repositories | |
4dbd1352 | 40 | (have the 'objects' and 'refs' subdirectories), even if they |
2707da9c PB |
41 | do not have the 'git-daemon-export-ok' file. |
42 | ||
62cd033d | 43 | --inetd:: |
bce8230d | 44 | Have the server run as an inetd service. Implies --syslog. |
7fc9d69f | 45 | |
62cd033d LAS |
46 | --port:: |
47 | Listen on an alternative port. | |
7fc9d69f | 48 | |
2707da9c PB |
49 | --init-timeout:: |
50 | Timeout between the moment the connection is established and the | |
51 | client request is received (typically a rather low value, since | |
52 | that should be basically immediate). | |
53 | ||
54 | --timeout:: | |
55 | Timeout for specific client sub-requests. This includes the time | |
56 | it takes for the server to process the sub-request and time spent | |
57 | waiting for next client's request. | |
58 | ||
9048fe1c PB |
59 | --syslog:: |
60 | Log to syslog instead of stderr. Note that this option does not imply | |
61 | --verbose, thus by default only error conditions will be logged. | |
62 | ||
b5cf3c8b PB |
63 | --verbose:: |
64 | Log details about the incoming connections and requested files. | |
65 | ||
4dbd1352 AE |
66 | <directory>:: |
67 | A directory to add to the whitelist of allowed directories. Unless | |
68 | --strict-paths is specified this will also include subdirectories | |
69 | of each named directory. | |
70 | ||
7fc9d69f JH |
71 | Author |
72 | ------ | |
4dbd1352 AE |
73 | Written by Linus Torvalds <torvalds@osdl.org>, YOSHIFUJI Hideaki |
74 | <yoshfuji@linux-ipv6.org> and the git-list <git@vger.kernel.org> | |
7fc9d69f JH |
75 | |
76 | Documentation | |
77 | -------------- | |
78 | Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>. | |
79 | ||
80 | GIT | |
81 | --- | |
a7154e91 | 82 | Part of the gitlink:git[7] suite |
7fc9d69f | 83 |