1 3efd8e31 2022-10-23 thomas .\"
 2 3efd8e31 2022-10-23 thomas .\" Copyright (c) 2022 Stefan Sperling
 3 3efd8e31 2022-10-23 thomas .\"
 4 3efd8e31 2022-10-23 thomas .\" Permission to use, copy, modify, and distribute this software for any
 5 3efd8e31 2022-10-23 thomas .\" purpose with or without fee is hereby granted, provided that the above
 6 3efd8e31 2022-10-23 thomas .\" copyright notice and this permission notice appear in all copies.
 7 3efd8e31 2022-10-23 thomas .\"
 8 3efd8e31 2022-10-23 thomas .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 9 3efd8e31 2022-10-23 thomas .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 3efd8e31 2022-10-23 thomas .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 3efd8e31 2022-10-23 thomas .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 3efd8e31 2022-10-23 thomas .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 3efd8e31 2022-10-23 thomas .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 3efd8e31 2022-10-23 thomas .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 3efd8e31 2022-10-23 thomas .\"
16 3efd8e31 2022-10-23 thomas .Dd $Mdocdate$
17 3efd8e31 2022-10-23 thomas .Dt GOTD 8
18 3efd8e31 2022-10-23 thomas .Os
19 3efd8e31 2022-10-23 thomas .Sh NAME
20 3efd8e31 2022-10-23 thomas .Nm gotd
21 3efd8e31 2022-10-23 thomas .Nd Game of Trees Daemon
22 3efd8e31 2022-10-23 thomas .Sh SYNOPSIS
23 3efd8e31 2022-10-23 thomas .Nm
24 c855c9f0 2023-01-19 thomas .Op Fl dnv
25 3efd8e31 2022-10-23 thomas .Op Fl f Ar config-file
26 3efd8e31 2022-10-23 thomas .Sh DESCRIPTION
27 3efd8e31 2022-10-23 thomas .Nm
28 3efd8e31 2022-10-23 thomas is a Git repository server which listens on a
29 3efd8e31 2022-10-23 thomas .Xr unix 4
30 3efd8e31 2022-10-23 thomas socket and relies on its companion tool
31 3efd8e31 2022-10-23 thomas .Xr gotsh 1
32 3efd8e31 2022-10-23 thomas to handle Git-protocol communication over the network, via
33 3efd8e31 2022-10-23 thomas .Xr ssh 1 .
34 3efd8e31 2022-10-23 thomas .Pp
35 3efd8e31 2022-10-23 thomas The Git repository format is described in
36 3efd8e31 2022-10-23 thomas .Xr git-repository 5 .
37 3efd8e31 2022-10-23 thomas .Pp
38 3efd8e31 2022-10-23 thomas .Nm
39 3efd8e31 2022-10-23 thomas requires a configuration file in order to run.
40 3efd8e31 2022-10-23 thomas The configuration file format is described in
41 3efd8e31 2022-10-23 thomas .Xr gotd.conf 5 .
42 3efd8e31 2022-10-23 thomas .Pp
43 615f21af 2023-01-06 thomas It is recommended to restrict
44 615f21af 2023-01-06 thomas .Xr ssh 1
45 615f21af 2023-01-06 thomas features available to users of
46 615f21af 2023-01-06 thomas .Nm .
47 615f21af 2023-01-06 thomas See
48 615f21af 2023-01-06 thomas .Xr gotsh 1
49 615f21af 2023-01-06 thomas for details.
50 615f21af 2023-01-06 thomas .Pp
51 3efd8e31 2022-10-23 thomas The options for
52 3efd8e31 2022-10-23 thomas .Nm
53 3efd8e31 2022-10-23 thomas are as follows:
54 3efd8e31 2022-10-23 thomas .Bl -tag -width Ds
55 3efd8e31 2022-10-23 thomas .It Fl d
56 30f1b1d2 2023-01-19 thomas Do not daemonize.
57 30f1b1d2 2023-01-19 thomas Send log output to stderr.
58 3efd8e31 2022-10-23 thomas .It Fl f Ar config-file
59 3efd8e31 2022-10-23 thomas Set the path to the configuration file.
60 3efd8e31 2022-10-23 thomas If not specified, the file
61 3efd8e31 2022-10-23 thomas .Pa /etc/gotd.conf
62 3efd8e31 2022-10-23 thomas will be used.
63 c855c9f0 2023-01-19 thomas .It Fl n
64 c855c9f0 2023-01-19 thomas Configtest mode.
65 c855c9f0 2023-01-19 thomas Only check the configuration file for validity.
66 3efd8e31 2022-10-23 thomas .It Fl v
67 3efd8e31 2022-10-23 thomas Verbose mode.
68 3efd8e31 2022-10-23 thomas Verbosity increases if this option is used multiple times.
69 2bb0ff1b 2022-11-17 thomas .El
70 3efd8e31 2022-10-23 thomas .Sh FILES
71 3efd8e31 2022-10-23 thomas .Bl -tag -width Ds -compact
72 3efd8e31 2022-10-23 thomas .It Pa /etc/gotd.conf
73 3efd8e31 2022-10-23 thomas Default location of the configuration file.
74 3efd8e31 2022-10-23 thomas .It Pa /var/run/gotd.sock
75 3efd8e31 2022-10-23 thomas Default location of the unix socket which
76 3efd8e31 2022-10-23 thomas .Nm
77 3efd8e31 2022-10-23 thomas is listening on.
78 3efd8e31 2022-10-23 thomas This path can be configured in
79 3efd8e31 2022-10-23 thomas .Xr gotd.conf 5 .
80 3efd8e31 2022-10-23 thomas .El
81 3efd8e31 2022-10-23 thomas .Sh SEE ALSO
82 3efd8e31 2022-10-23 thomas .Xr got 1 ,
83 3efd8e31 2022-10-23 thomas .Xr gotsh 1 ,
84 3efd8e31 2022-10-23 thomas .Xr git-repository 5 ,
85 3efd8e31 2022-10-23 thomas .Xr gotd.conf 5
86 3efd8e31 2022-10-23 thomas .Sh AUTHORS
87 3efd8e31 2022-10-23 thomas .An Stefan Sperling Aq Mt stsp@openbsd.org