Blame


1 742bb3a1 2022-10-24 stsp <!DOCTYPE html>
2 742bb3a1 2022-10-24 stsp <html>
3 742bb3a1 2022-10-24 stsp <head>
4 742bb3a1 2022-10-24 stsp <meta charset="utf-8"/>
5 742bb3a1 2022-10-24 stsp <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
6 742bb3a1 2022-10-24 stsp <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
7 742bb3a1 2022-10-24 stsp <title>GOTD(8)</title>
8 742bb3a1 2022-10-24 stsp </head>
9 742bb3a1 2022-10-24 stsp <!-- This is an automatically generated file. Do not edit.
10 742bb3a1 2022-10-24 stsp Copyright (c) 2022 Stefan Sperling
11 742bb3a1 2022-10-24 stsp
12 742bb3a1 2022-10-24 stsp Permission to use, copy, modify, and distribute this software for any
13 742bb3a1 2022-10-24 stsp purpose with or without fee is hereby granted, provided that the above
14 742bb3a1 2022-10-24 stsp copyright notice and this permission notice appear in all copies.
15 742bb3a1 2022-10-24 stsp
16 742bb3a1 2022-10-24 stsp THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
17 742bb3a1 2022-10-24 stsp WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
18 742bb3a1 2022-10-24 stsp MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
19 742bb3a1 2022-10-24 stsp ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
20 742bb3a1 2022-10-24 stsp WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
21 742bb3a1 2022-10-24 stsp ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
22 742bb3a1 2022-10-24 stsp OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
23 742bb3a1 2022-10-24 stsp -->
24 742bb3a1 2022-10-24 stsp <body>
25 742bb3a1 2022-10-24 stsp <div class="head" role="doc-pageheader" aria-label="Manual header
26 742bb3a1 2022-10-24 stsp line"><span class="head-ltitle">GOTD(8)</span> <span class="head-vol">System
27 742bb3a1 2022-10-24 stsp Manager's Manual</span> <span class="head-rtitle">GOTD(8)</span></div>
28 742bb3a1 2022-10-24 stsp <main class="manual-text">
29 742bb3a1 2022-10-24 stsp <section class="Sh">
30 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h2>
31 742bb3a1 2022-10-24 stsp <p class="Pp"><code class="Nm">gotd</code> &#x2014;
32 742bb3a1 2022-10-24 stsp <span class="Nd" role="doc-subtitle">Game of Trees Daemon</span></p>
33 742bb3a1 2022-10-24 stsp </section>
34 742bb3a1 2022-10-24 stsp <section class="Sh">
35 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h2>
36 742bb3a1 2022-10-24 stsp <table class="Nm">
37 742bb3a1 2022-10-24 stsp <tr>
38 742bb3a1 2022-10-24 stsp <td><code class="Nm">gotd</code></td>
39 8cea22f9 2023-01-18 stsp <td>[<code class="Fl">-dnv</code>] [<code class="Fl">-f</code>
40 742bb3a1 2022-10-24 stsp <var class="Ar">config-file</var>]</td>
41 742bb3a1 2022-10-24 stsp </tr>
42 742bb3a1 2022-10-24 stsp </table>
43 742bb3a1 2022-10-24 stsp </section>
44 742bb3a1 2022-10-24 stsp <section class="Sh">
45 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h2>
46 742bb3a1 2022-10-24 stsp <p class="Pp"><code class="Nm">gotd</code> is a Git repository server which
47 742bb3a1 2022-10-24 stsp listens on a <a class="Xr" aria-label="unix, section 4">unix(4)</a> socket
48 742bb3a1 2022-10-24 stsp and relies on its companion tool <a class="Xr" aria-label="gotsh, section
49 742bb3a1 2022-10-24 stsp 1">gotsh(1)</a> to handle Git-protocol communication over the network, via
50 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="ssh, section 1">ssh(1)</a>.</p>
51 742bb3a1 2022-10-24 stsp <p class="Pp">The Git repository format is described in
52 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="git-repository, section
53 742bb3a1 2022-10-24 stsp 5">git-repository(5)</a>.</p>
54 742bb3a1 2022-10-24 stsp <p class="Pp"><code class="Nm">gotd</code> requires a configuration file in
55 742bb3a1 2022-10-24 stsp order to run. The configuration file format is described in
56 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a>.</p>
57 47f19dd5 2023-01-17 stsp <p class="Pp">It is recommended to restrict <a class="Xr" aria-label="ssh,
58 47f19dd5 2023-01-17 stsp section 1">ssh(1)</a> features available to users of
59 47f19dd5 2023-01-17 stsp <code class="Nm">gotd</code>. See <a class="Xr" aria-label="gotsh, section
60 47f19dd5 2023-01-17 stsp 1">gotsh(1)</a> for details.</p>
61 742bb3a1 2022-10-24 stsp <p class="Pp">The options for <code class="Nm">gotd</code> are as follows:</p>
62 742bb3a1 2022-10-24 stsp <dl class="Bl-tag">
63 742bb3a1 2022-10-24 stsp <dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a></dt>
64 8cea22f9 2023-01-18 stsp <dd>Do not daemonize. Send log output to stderr.</dd>
65 742bb3a1 2022-10-24 stsp <dt id="f"><a class="permalink" href="#f"><code class="Fl">-f</code></a>
66 742bb3a1 2022-10-24 stsp <var class="Ar">config-file</var></dt>
67 742bb3a1 2022-10-24 stsp <dd>Set the path to the configuration file. If not specified, the file
68 742bb3a1 2022-10-24 stsp <span class="Pa">/etc/gotd.conf</span> will be used.</dd>
69 8cea22f9 2023-01-18 stsp <dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a></dt>
70 8cea22f9 2023-01-18 stsp <dd>Configtest mode. Only check the configuration file for validity.</dd>
71 742bb3a1 2022-10-24 stsp <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a></dt>
72 742bb3a1 2022-10-24 stsp <dd>Verbose mode. Verbosity increases if this option is used multiple
73 742bb3a1 2022-10-24 stsp times.</dd>
74 742bb3a1 2022-10-24 stsp </dl>
75 742bb3a1 2022-10-24 stsp </section>
76 742bb3a1 2022-10-24 stsp <section class="Sh">
77 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
78 742bb3a1 2022-10-24 stsp <dl class="Bl-tag Bl-compact">
79 742bb3a1 2022-10-24 stsp <dt><span class="Pa">/etc/gotd.conf</span></dt>
80 742bb3a1 2022-10-24 stsp <dd>Default location of the configuration file.</dd>
81 742bb3a1 2022-10-24 stsp <dt><span class="Pa">/var/run/gotd.sock</span></dt>
82 742bb3a1 2022-10-24 stsp <dd>Default location of the unix socket which <code class="Nm">gotd</code> is
83 742bb3a1 2022-10-24 stsp listening on. This path can be configured in
84 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a>.</dd>
85 742bb3a1 2022-10-24 stsp </dl>
86 742bb3a1 2022-10-24 stsp </section>
87 742bb3a1 2022-10-24 stsp <section class="Sh">
88 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
89 742bb3a1 2022-10-24 stsp ALSO</a></h2>
90 742bb3a1 2022-10-24 stsp <p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
91 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="gotsh, section 1">gotsh(1)</a>,
92 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="git-repository, section 5">git-repository(5)</a>,
93 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a></p>
94 742bb3a1 2022-10-24 stsp </section>
95 742bb3a1 2022-10-24 stsp <section class="Sh">
96 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
97 742bb3a1 2022-10-24 stsp <p class="Pp"><span class="An">Stefan Sperling</span>
98 742bb3a1 2022-10-24 stsp &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;</p>
99 742bb3a1 2022-10-24 stsp </section>
100 742bb3a1 2022-10-24 stsp </main>
101 742bb3a1 2022-10-24 stsp <div class="foot" role="doc-pagefooter" aria-label="Manual footer
102 f6a6fa94 2023-02-22 stsp line"><span class="foot-left"></span><span class="foot-date">February 22,
103 47f19dd5 2023-01-17 stsp 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
104 742bb3a1 2022-10-24 stsp </body>
105 742bb3a1 2022-10-24 stsp </html>