diff options
| author | Junio C Hamano <junio@hera.kernel.org> | 2008-07-06 05:20:31 +0000 |
|---|---|---|
| committer | Junio C Hamano <junio@hera.kernel.org> | 2008-07-06 05:20:31 +0000 |
| commit | ba4b9286c25f18c7ebbb809ee5732a7810377ab6 (patch) | |
| tree | 390507328a7564b65dc803683c34235700b97409 /git-daemon.html | |
| parent | 05bf9c54a827e48b2b576488f5170a3490b5180e (diff) | |
| download | git-htmldocs-ba4b9286c25f18c7ebbb809ee5732a7810377ab6.tar.gz | |
Autogenerated HTML docs for v1.5.6.2-212-g08b5
Diffstat (limited to 'git-daemon.html')
| -rw-r--r-- | git-daemon.html | 180 |
1 files changed, 114 insertions, 66 deletions
diff --git a/git-daemon.html b/git-daemon.html index dd8450564..ab2813389 100644 --- a/git-daemon.html +++ b/git-daemon.html @@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 7.0.2" />
+<meta name="generator" content="AsciiDoc 8.2.5" />
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -16,8 +16,13 @@ body { margin: 1em 5% 1em 5%;
}
-a { color: blue; }
-a:visited { color: fuchsia; }
+a {
+ color: blue;
+ text-decoration: underline;
+}
+a:visited {
+ color: fuchsia;
+}
em {
font-style: italic;
@@ -39,13 +44,18 @@ h1, h2, h3, h4, h5, h6 { line-height: 1.3;
}
-h1 {
+h1, h2, h3 {
border-bottom: 2px solid silver;
}
h2 {
- border-bottom: 2px solid silver;
padding-top: 0.5em;
}
+h3 {
+ float: left;
+}
+h3 + * {
+ clear: left;
+}
div.sectionbody {
font-family: serif;
@@ -70,7 +80,7 @@ span#author { color: #527bbd;
font-family: sans-serif;
font-weight: bold;
- font-size: 1.2em;
+ font-size: 1.1em;
}
span#email {
}
@@ -139,6 +149,9 @@ div.sidebarblock > div.content { padding: 0.5em;
}
+div.listingblock {
+ margin-right: 0%;
+}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
@@ -148,9 +161,13 @@ div.listingblock > div.content { div.quoteblock > div.content {
padding-left: 2.0em;
}
-div.quoteblock .attribution {
+
+div.attribution {
text-align: right;
}
+div.verseblock + div.attribution {
+ text-align: left;
+}
div.admonitionblock .icon {
vertical-align: top;
@@ -194,13 +211,12 @@ dd > *:first-child { ul, ol {
list-style-position: outside;
}
-ol.olist2 {
+div.olist2 ol {
list-style-type: lower-alpha;
}
div.tableblock > table {
- border-color: #527bbd;
- border-width: 3px;
+ border: 3px solid #527bbd;
}
thead {
font-family: sans-serif;
@@ -214,6 +230,9 @@ div.hlist { margin-top: 0.8em;
margin-bottom: 0.8em;
}
+div.hlist td {
+ padding-bottom: 5px;
+}
td.hlist1 {
vertical-align: top;
font-style: italic;
@@ -226,7 +245,33 @@ td.hlist2 { @media print {
div#footer-badges { display: none; }
}
-include::./stylesheets/xhtml11-manpage.css[]
+
+div#toctitle {
+ color: #527bbd;
+ font-family: sans-serif;
+ font-size: 1.1em;
+ font-weight: bold;
+ margin-top: 1.0em;
+ margin-bottom: 0.1em;
+}
+
+div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+div.toclevel2 {
+ margin-left: 2em;
+ font-size: 0.9em;
+}
+div.toclevel3 {
+ margin-left: 4em;
+ font-size: 0.9em;
+}
+div.toclevel4 {
+ margin-left: 6em;
+ font-size: 0.9em;
+}
+include1::./stylesheets/xhtml11-manpage.css[]
/* Workarounds for IE6's broken and incomplete CSS2. */
div.sidebar-content {
@@ -255,6 +300,9 @@ div.exampleblock-content { border-left: 2px solid silver;
padding-left: 0.5em;
}
+
+/* IE6 sets dynamically generated links as visited. */
+div#toc a:visited { color: blue; }
</style>
<title>git-daemon(1)</title>
</head>
@@ -283,26 +331,26 @@ git-daemon(1) Manual Page [--inetd | [--listen=host_or_ipaddr] [--port=n] [--user=user [--group=group]]
[directory…]</div></div>
</div>
-<h2>DESCRIPTION</h2>
+<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
-<p>A really simple TCP git daemon that normally listens on port "DEFAULT_GIT_PORT"
+<div class="para"><p>A really simple TCP git daemon that normally listens on port "DEFAULT_GIT_PORT"
aka 9418. It waits for a connection asking for a service, and will serve
-that service if it is enabled.</p>
-<p>It verifies that the directory has the magic file "git-daemon-export-ok", and
+that service if it is enabled.</p></div>
+<div class="para"><p>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
for export this way (unless the <em>--export-all</em> parameter is specified). If you
-pass some directory paths as <tt>git-daemon</tt> arguments, you can further restrict
-the offers to a whitelist comprising of those.</p>
-<p>By default, only <tt>upload-pack</tt> service is enabled, which serves
-<tt>git-fetch-pack</tt> and <tt>git-ls-remote</tt> clients, which are invoked
-from <tt>git-fetch</tt>, <tt>git-pull</tt>, and <tt>git-clone</tt>.</p>
-<p>This is ideally suited for read-only updates, i.e., pulling from
-git repositories.</p>
-<p>An <tt>upload-archive</tt> also exists to serve <tt>git-archive</tt>.</p>
+pass some directory paths as <em>git-daemon</em> arguments, you can further restrict
+the offers to a whitelist comprising of those.</p></div>
+<div class="para"><p>By default, only <tt>upload-pack</tt> service is enabled, which serves
+<em>git-fetch-pack</em> and <em>git-ls-remote</em> clients, which are invoked
+from <em>git-fetch</em>, <em>git-pull</em>, and <em>git-clone</em>.</p></div>
+<div class="para"><p>This is ideally suited for read-only updates, i.e., pulling from
+git repositories.</p></div>
+<div class="para"><p>An <tt>upload-archive</tt> also exists to serve <em>git-archive</em>.</p></div>
</div>
-<h2>OPTIONS</h2>
+<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
-<dl>
+<div class="vlist"><dl>
<dt>
--strict-paths
</dt>
@@ -310,7 +358,7 @@ git repositories.</p> <p>
Match paths exactly (i.e. don't allow "/foo/repo" when the real path is
"/foo/repo.git" or "/foo/repo/.git") and don't do user-relative paths.
- <tt>git-daemon</tt> will refuse to start when this option is enabled and no
+ <em>git-daemon</em> will refuse to start when this option is enabled and no
whitelist is specified.
</p>
</dd>
@@ -320,9 +368,9 @@ git repositories.</p> <dd>
<p>
Remap all the path requests as relative to the given path.
- This is sort of "GIT root" - if you run <tt>git-daemon</tt> with
+ This is sort of "GIT root" - if you run <em>git-daemon</em> with
<em>--base-path=/srv/git</em> on example.com, then if you later try to pull
- <em>git://example.com/hello.git</em>, <tt>git-daemon</tt> will interpret the path
+ <em>git://example.com/hello.git</em>, <em>git-daemon</em> will interpret the path
as <em>/srv/git/hello.git</em>.
</p>
</dd>
@@ -332,7 +380,7 @@ git repositories.</p> <dd>
<p>
If --base-path is enabled and repo lookup fails, with this option
- <tt>git-daemon</tt> will attempt to lookup without prefixing the base path.
+ <em>git-daemon</em> will attempt to lookup without prefixing the base path.
This is useful for switching to --base-path usage, while still
allowing the old paths.
</p>
@@ -428,9 +476,9 @@ git repositories.</p> </dt>
<dd>
<p>
- Allow ~user notation to be used in requests. When
+ Allow <sub>user notation to be used in requests. When
specified with no parameter, requests to
- git://host/~alice/foo is taken as a request to access
+ git://host/</sub>alice/foo is taken as a request to access
<em>foo</em> repository in the home directory of user <tt>alice</tt>.
If <tt>--user-path=path</tt> is specified, the same request is
taken as a request to access <tt>path/foo</tt> repository in
@@ -486,9 +534,9 @@ git repositories.</p> the option are given to <tt>getpwnam(3)</tt> and <tt>getgrnam(3)</tt>
and numeric IDs are not supported.
</p>
-<p>Giving these options is an error when used with <tt>--inetd</tt>; use
+<div class="para"><p>Giving these options is an error when used with <tt>--inetd</tt>; use
the facility of inet daemon to achieve the same before spawning
-<tt>git-daemon</tt> if needed.</p>
+<em>git-daemon</em> if needed.</p></div>
</dd>
<dt>
--enable=service
@@ -528,23 +576,23 @@ the facility of inet daemon to achieve the same before spawning of each named directory.
</p>
</dd>
-</dl>
+</dl></div>
</div>
-<h2>SERVICES</h2>
+<h2 id="_services">SERVICES</h2>
<div class="sectionbody">
-<p>These services can be globally enabled/disabled using the
+<div class="para"><p>These services can be globally enabled/disabled using the
command line options of this command. If a finer-grained
-control is desired (e.g. to allow <tt>git-archive</tt> to be run
+control is desired (e.g. to allow <em>git-archive</em> to be run
against only in a few selected repositories the daemon serves),
the per-repository configuration file can be used to enable or
-disable them.</p>
-<dl>
+disable them.</p></div>
+<div class="vlist"><dl>
<dt>
upload-pack
</dt>
<dd>
<p>
- This serves <tt>git-fetch-pack</tt> and <tt>git-ls-remote</tt>
+ This serves <em>git-fetch-pack</em> and <em>git-ls-remote</em>
clients. It is enabled by default, but a repository can
disable it by setting <tt>daemon.uploadpack</tt> configuration
item to <tt>false</tt>.
@@ -555,7 +603,7 @@ upload-archive </dt>
<dd>
<p>
- This serves <tt>git-archive --remote</tt>. It is disabled by
+ This serves <em>git-archive --remote</em>. It is disabled by
default, but a repository can enable it by setting
<tt>daemon.uploadarch</tt> configuration item to <tt>true</tt>.
</p>
@@ -565,8 +613,8 @@ receive-pack </dt>
<dd>
<p>
- This serves <tt>git-send-pack</tt> clients, allowing anonymous
- push. It is disabled by default, as there is _no_
+ This serves <em>git-send-pack</em> clients, allowing anonymous
+ push. It is disabled by default, as there is <em>no</em>
authentication in the protocol (in other words, anybody
can push anything into the repository, including removal
of refs). This is solely meant for a closed LAN setting
@@ -575,11 +623,11 @@ receive-pack <tt>true</tt>.
</p>
</dd>
-</dl>
+</dl></div>
</div>
-<h2>EXAMPLES</h2>
+<h2 id="_examples">EXAMPLES</h2>
<div class="sectionbody">
-<dl>
+<div class="vlist"><dl>
<dt>
We assume the following in /etc/services
</dt>
@@ -591,11 +639,11 @@ git 9418/tcp # Git Version Control System</tt></pre> </div></div>
</dd>
<dt>
-<tt>git-daemon</tt> as inetd server
+<em>git-daemon</em> as inetd server
</dt>
<dd>
<p>
- To set up <tt>git-daemon</tt> as an inetd service that handles any
+ To set up <em>git-daemon</em> as an inetd service that handles any
repository under the whitelisted set of directories, /pub/foo
and /pub/bar, place an entry like the following into
/etc/inetd all on one line:
@@ -608,11 +656,11 @@ git 9418/tcp # Git Version Control System</tt></pre> </div></div>
</dd>
<dt>
-<tt>git-daemon</tt> as inetd server for virtual hosts
+<em>git-daemon</em> as inetd server for virtual hosts
</dt>
<dd>
<p>
- To set up <tt>git-daemon</tt> as an inetd service that handles
+ To set up <em>git-daemon</em> as an inetd service that handles
repositories for different virtual hosts, <tt>www.example.com</tt>
and <tt>www.example.org</tt>, place an entry like the following into
<tt>/etc/inetd</tt> all on one line:
@@ -626,19 +674,19 @@ git 9418/tcp # Git Version Control System</tt></pre> /pub/www.example.com/software
/software</tt></pre>
</div></div>
-<p>In this example, the root-level directory <tt>/pub</tt> will contain
+<div class="para"><p>In this example, the root-level directory <tt>/pub</tt> will contain
a subdirectory for each virtual host name supported.
Further, both hosts advertise repositories simply as
<tt>git://www.example.com/software/repo.git</tt>. For pre-1.4.0
clients, a symlink from <tt>/software</tt> into the appropriate
-default repository could be made as well.</p>
+default repository could be made as well.</p></div>
</dd>
<dt>
-<tt>git-daemon</tt> as regular daemon for virtual hosts
+<em>git-daemon</em> as regular daemon for virtual hosts
</dt>
<dd>
<p>
- To set up <tt>git-daemon</tt> as a regular, non-inetd service that
+ To set up <em>git-daemon</em> as a regular, non-inetd service that
handles repositories for multiple virtual hosts based on
their IP addresses, start the daemon like this:
</p>
@@ -649,17 +697,17 @@ default repository could be made as well.</p> /pub/192.168.1.200/software
/pub/10.10.220.23/software</tt></pre>
</div></div>
-<p>In this example, the root-level directory <tt>/pub</tt> will contain
+<div class="para"><p>In this example, the root-level directory <tt>/pub</tt> will contain
a subdirectory for each virtual host IP address supported.
Repositories can still be accessed by hostname though, assuming
-they correspond to these IP addresses.</p>
+they correspond to these IP addresses.</p></div>
</dd>
<dt>
selectively enable/disable services per repository
</dt>
<dd>
<p>
- To enable <tt>git-archive --remote</tt> and disable <tt>git-fetch</tt> against
+ To enable <em>git-archive --remote</em> and disable <em>git-fetch</em> against
a repository, have the following in the configuration file in the
repository (that is the file <em>config</em> next to <em>HEAD</em>, <em>refs</em> and
<em>objects</em>).
@@ -671,24 +719,24 @@ selectively enable/disable services per repository uploadarch = true</tt></pre>
</div></div>
</dd>
-</dl>
+</dl></div>
</div>
-<h2>Author</h2>
+<h2 id="_author">Author</h2>
<div class="sectionbody">
-<p>Written by Linus Torvalds <torvalds@osdl.org>, YOSHIFUJI Hideaki
-<yoshfuji@linux-ipv6.org> and the git-list <git@vger.kernel.org></p>
+<div class="para"><p>Written by Linus Torvalds <torvalds@osdl.org>, YOSHIFUJI Hideaki
+<yoshfuji@linux-ipv6.org> and the git-list <git@vger.kernel.org></p></div>
</div>
-<h2>Documentation</h2>
+<h2 id="_documentation">Documentation</h2>
<div class="sectionbody">
-<p>Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.</p>
+<div class="para"><p>Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.</p></div>
</div>
-<h2>GIT</h2>
+<h2 id="_git">GIT</h2>
<div class="sectionbody">
-<p>Part of the <a href="git.html">git(1)</a> suite</p>
+<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 02-Jul-2008 03:01:39 UTC
+Last updated 2008-07-06 05:16:42 UTC
</div>
</div>
</body>
|