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 56f3f26e 2024-06-03 stsp <h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
89 56f3f26e 2024-06-03 stsp <p class="Pp">Create an empty repository to be served by
90 56f3f26e 2024-06-03 stsp <code class="Nm">gotd</code>, ensuring that it can only be accessed by the
91 56f3f26e 2024-06-03 stsp _gotd user:</p>
92 56f3f26e 2024-06-03 stsp <p class="Pp"></p>
93 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li"># mkdir -p
94 56f3f26e 2024-06-03 stsp /git/myrepo.git</code></div>
95 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li"># chmod 700
96 56f3f26e 2024-06-03 stsp /git/myrepo.git</code></div>
97 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li"># chown _gotd
98 56f3f26e 2024-06-03 stsp /git/myrepo.git</code></div>
99 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li"># su -m _gotd -c 'gotadmin init
100 56f3f26e 2024-06-03 stsp /git/myrepo.git'</code></div>
101 56f3f26e 2024-06-03 stsp <p class="Pp">Add the new repository to <a class="Xr" aria-label="gotd.conf,
102 56f3f26e 2024-06-03 stsp section 5">gotd.conf(5)</a> granting read-write access to the flan_hacker
103 56f3f26e 2024-06-03 stsp user account, and restart <code class="Nm">gotd</code>:</p>
104 56f3f26e 2024-06-03 stsp <p class="Pp"></p>
105 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li"># cat &gt;&gt; /etc/gotd.conf
106 56f3f26e 2024-06-03 stsp &lt;&lt;EOF</code></div>
107 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li">repository 'myrepo' {</code></div>
108 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li">path '/git/myrepo.git'</code></div>
109 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li">permit rw flan_hacker</code></div>
110 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li">}</code></div>
111 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li">EOF</code></div>
112 56f3f26e 2024-06-03 stsp <div class="Bd Bd-indent"><code class="Li"># rcctl restart gotd</code></div>
113 56f3f26e 2024-06-03 stsp <p class="Pp">The flan_hacker user can now populate the empty repository with
114 56f3f26e 2024-06-03 stsp <code class="Cm">got send</code>.</p>
115 56f3f26e 2024-06-03 stsp </section>
116 56f3f26e 2024-06-03 stsp <section class="Sh">
117 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
118 742bb3a1 2022-10-24 stsp ALSO</a></h2>
119 742bb3a1 2022-10-24 stsp <p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
120 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="gotsh, section 1">gotsh(1)</a>,
121 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="git-repository, section 5">git-repository(5)</a>,
122 742bb3a1 2022-10-24 stsp <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a></p>
123 742bb3a1 2022-10-24 stsp </section>
124 742bb3a1 2022-10-24 stsp <section class="Sh">
125 742bb3a1 2022-10-24 stsp <h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
126 742bb3a1 2022-10-24 stsp <p class="Pp"><span class="An">Stefan Sperling</span>
127 742bb3a1 2022-10-24 stsp &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;</p>
128 742bb3a1 2022-10-24 stsp </section>
129 742bb3a1 2022-10-24 stsp </main>
130 742bb3a1 2022-10-24 stsp <div class="foot" role="doc-pagefooter" aria-label="Manual footer
131 16fecf30 2024-07-11 op line"><span class="foot-left"></span><span class="foot-date">July 11,
132 2b1d45b9 2024-03-11 stsp 2024</span> <span class="foot-os">OpenBSD 7.5</span></div>
133 742bb3a1 2022-10-24 stsp </body>
134 742bb3a1 2022-10-24 stsp </html>