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