Autogenerated HTML docs for v1.4.2-g7bbf
authorJunio C Hamano <junio@hera.kernel.org>
Thu, 7 Sep 2006 11:44:08 +0000 (11:44 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Thu, 7 Sep 2006 11:44:08 +0000 (11:44 +0000)
git-daemon.html
git-daemon.txt

index 1fd9609..57ed3cc 100644 (file)
@@ -276,22 +276,26 @@ git-daemon(1) Manual Page
 <div class="content"><em>git-daemon</em> [--verbose] [--syslog] [--inetd | --port=n] [--export-all]\r
              [--timeout=n] [--init-timeout=n] [--strict-paths]\r
              [--base-path=path] [--user-path | --user-path=path]\r
+             [--enable=service] [--disable=service]\r
+             [--allow-override=service] [--forbid-override=service]\r
              [--reuseaddr] [--detach] [--pid-file=file]\r
              [--user=user [--group=group]] [directory&#8230;]</div></div>\r
 </div>\r
 <h2>DESCRIPTION</h2>\r
 <div class="sectionbody">\r
 <p>A really simple TCP git daemon that normally listens on port "DEFAULT_GIT_PORT"\r
-aka 9418. It waits for a connection, and will just execute "git-upload-pack"\r
-when it gets one.</p>\r
-<p>It's careful in that there's a magic request-line that gives the command and\r
-what directory to upload, and it verifies that the directory is OK.</p>\r
+aka 9418.  It waits for a connection asking for a service, and will serve\r
+that service if it is enabled.</p>\r
 <p>It verifies that the directory has the magic file "git-daemon-export-ok", and\r
 it will refuse to export any git directory that hasn't explicitly been marked\r
 for export this way (unless the <em>--export-all</em> parameter is specified). If you\r
 pass some directory paths as <em>git-daemon</em> arguments, you can further restrict\r
 the offers to a whitelist comprising of those.</p>\r
-<p>This is ideally suited for read-only updates, i.e., pulling from git repositories.</p>\r
+<p>By default, only <tt>upload-pack</tt> service is enabled, which serves\r
+<tt>git-fetch-pack</tt> and <tt>git-peek-remote</tt> clients that are invoked\r
+from <tt>git-fetch</tt>, <tt>git-ls-remote</tt>, and <tt>git-clone</tt>.</p>\r
+<p>This is ideally suited for read-only updates, i.e., pulling from\r
+git repositories.</p>\r
 </div>\r
 <h2>OPTIONS</h2>\r
 <div class="sectionbody">\r
@@ -438,6 +442,28 @@ the facility of inet daemon to achieve the same before spawning
 <tt>git-daemon</tt> if needed.</p>\r
 </dd>\r
 <dt>\r
+--enable-service, --disable-service\r
+</dt>\r
+<dd>\r
+<p>\r
+        Enable/disable the service site-wide per default.  Note\r
+        that a service disabled site-wide can still be enabled\r
+        per repository if it is marked overridable and the\r
+        repository enables the service with an configuration\r
+        item.\r
+</p>\r
+</dd>\r
+<dt>\r
+--allow-override, --forbid-override\r
+</dt>\r
+<dd>\r
+<p>\r
+        Allow/forbid overriding the site-wide default with per\r
+        repository configuration.  By default, all the services\r
+        are overridable.\r
+</p>\r
+</dd>\r
+<dt>\r
 &lt;directory&gt;\r
 </dt>\r
 <dd>\r
@@ -449,6 +475,22 @@ the facility of inet daemon to achieve the same before spawning
 </dd>\r
 </dl>\r
 </div>\r
+<h2>SERVICES</h2>\r
+<div class="sectionbody">\r
+<dl>\r
+<dt>\r
+upload-pack\r
+</dt>\r
+<dd>\r
+<p>\r
+        This serves <tt>git-fetch-pack</tt> and <tt>git-peek-remote</tt>\r
+        clients.  It is enabled by default, but a repository can\r
+        disable it by setting <tt>daemon.uploadpack</tt> configuration\r
+        item to <tt>false</tt>.\r
+</p>\r
+</dd>\r
+</dl>\r
+</div>\r
 <h2>Author</h2>\r
 <div class="sectionbody">\r
 <p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;, YOSHIFUJI Hideaki\r
@@ -464,7 +506,7 @@ the facility of inet daemon to achieve the same before spawning
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 28-Aug-2006 07:18:33 UTC\r
+Last updated 07-Sep-2006 11:44:00 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 17619a3..741f2c6 100644 (file)
@@ -11,17 +11,16 @@ SYNOPSIS
 'git-daemon' [--verbose] [--syslog] [--inetd | --port=n] [--export-all]
              [--timeout=n] [--init-timeout=n] [--strict-paths]
              [--base-path=path] [--user-path | --user-path=path]
-            [--reuseaddr] [--detach] [--pid-file=file]
-            [--user=user [--group=group]] [directory...]
+             [--enable=service] [--disable=service]
+            [--allow-override=service] [--forbid-override=service]
+             [--reuseaddr] [--detach] [--pid-file=file]
+             [--user=user [--group=group]] [directory...]
 
 DESCRIPTION
 -----------
 A really simple TCP git daemon that normally listens on port "DEFAULT_GIT_PORT"
-aka 9418. It waits for a connection, and will just execute "git-upload-pack"
-when it gets one.
-
-It's careful in that there's a magic request-line that gives the command and
-what directory to upload, and it verifies that the directory is OK.
+aka 9418.  It waits for a connection asking for a service, and will serve
+that service if it is enabled.
 
 It verifies that the directory has the magic file "git-daemon-export-ok", and
 it will refuse to export any git directory that hasn't explicitly been marked
@@ -29,7 +28,12 @@ for export this way (unless the '--export-all' parameter is specified). If you
 pass some directory paths as 'git-daemon' arguments, you can further restrict
 the offers to a whitelist comprising of those.
 
-This is ideally suited for read-only updates, i.e., pulling from git repositories.
+By default, only `upload-pack` service is enabled, which serves
+`git-fetch-pack` and `git-peek-remote` clients that are invoked
+from `git-fetch`, `git-ls-remote`, and `git-clone`.
+
+This is ideally suited for read-only updates, i.e., pulling from
+git repositories.
 
 OPTIONS
 -------
@@ -105,11 +109,32 @@ Giving these options is an error when used with `--inetd`; use
 the facility of inet daemon to achieve the same before spawning
 `git-daemon` if needed.
 
+--enable-service, --disable-service::
+       Enable/disable the service site-wide per default.  Note
+       that a service disabled site-wide can still be enabled
+       per repository if it is marked overridable and the
+       repository enables the service with an configuration
+       item.
+
+--allow-override, --forbid-override::
+       Allow/forbid overriding the site-wide default with per
+       repository configuration.  By default, all the services
+       are overridable.
+
 <directory>::
        A directory to add to the whitelist of allowed directories. Unless
        --strict-paths is specified this will also include subdirectories
        of each named directory.
 
+SERVICES
+--------
+
+upload-pack::
+       This serves `git-fetch-pack` and `git-peek-remote`
+       clients.  It is enabled by default, but a repository can
+       disable it by setting `daemon.uploadpack` configuration
+       item to `false`.
+
 Author
 ------
 Written by Linus Torvalds <torvalds@osdl.org>, YOSHIFUJI Hideaki