1 a596b957 2022-07-14 tracey .\"
  2 a596b957 2022-07-14 tracey .\" Copyright (c) 2020 Stefan Sperling
  3 a596b957 2022-07-14 tracey .\"
  4 a596b957 2022-07-14 tracey .\" Permission to use, copy, modify, and distribute this software for any
  5 a596b957 2022-07-14 tracey .\" purpose with or without fee is hereby granted, provided that the above
  6 a596b957 2022-07-14 tracey .\" copyright notice and this permission notice appear in all copies.
  7 a596b957 2022-07-14 tracey .\"
  8 a596b957 2022-07-14 tracey .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  9 a596b957 2022-07-14 tracey .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 10 a596b957 2022-07-14 tracey .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 11 a596b957 2022-07-14 tracey .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 12 a596b957 2022-07-14 tracey .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 13 a596b957 2022-07-14 tracey .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 14 a596b957 2022-07-14 tracey .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 15 a596b957 2022-07-14 tracey .\"
 16 a596b957 2022-07-14 tracey .Dd $Mdocdate$
 17 59975c69 2022-08-29 stsp .Dt GOTWEBD 8
 18 a596b957 2022-07-14 tracey .Os
 19 a596b957 2022-07-14 tracey .Sh NAME
 20 59975c69 2022-08-29 stsp .Nm gotwebd
 21 59975c69 2022-08-29 stsp .Nd Game of Trees Git Fast-CGI repository server for web browsers
 22 a596b957 2022-07-14 tracey .Sh SYNOPSIS
 23 a596b957 2022-07-14 tracey .Nm
 24 a596b957 2022-07-14 tracey .Sh DESCRIPTION
 25 a596b957 2022-07-14 tracey .Nm
 26 59975c69 2022-08-29 stsp is a Fast-CGI server program which can display the contents of Git
 27 59975c69 2022-08-29 stsp repositories via a web browser.
 28 a596b957 2022-07-14 tracey The program has been designed to work out of the box with
 29 a596b957 2022-07-14 tracey the
 30 a596b957 2022-07-14 tracey .Xr httpd 8
 31 59975c69 2022-08-29 stsp web server.
 32 a596b957 2022-07-14 tracey .Pp
 33 a596b957 2022-07-14 tracey Enabling
 34 a596b957 2022-07-14 tracey .Nm
 35 a596b957 2022-07-14 tracey requires the following steps:
 36 a596b957 2022-07-14 tracey .Bl -enum
 37 a596b957 2022-07-14 tracey .It
 38 a596b957 2022-07-14 tracey The
 39 a596b957 2022-07-14 tracey .Xr httpd.conf 5
 40 a596b957 2022-07-14 tracey configuration file must be adjusted to run
 41 a596b957 2022-07-14 tracey .Nm
 42 59975c69 2022-08-29 stsp as a Fast-CGI helper program.
 43 a596b957 2022-07-14 tracey The
 44 a596b957 2022-07-14 tracey .Sx EXAMPLES
 45 a596b957 2022-07-14 tracey section below contains an appropriate configuration file sample.
 46 a596b957 2022-07-14 tracey .It
 47 59975c69 2022-08-29 stsp httpd(8) must be enabled and started:
 48 a596b957 2022-07-14 tracey .Bd -literal -offset indent
 49 59975c69 2022-08-29 stsp   # rcctl enable httpd
 50 59975c69 2022-08-29 stsp   # rcctl start httpd
 51 a596b957 2022-07-14 tracey .Ed
 52 a596b957 2022-07-14 tracey .It
 53 a596b957 2022-07-14 tracey Optionally, the run-time behaviour of
 54 a596b957 2022-07-14 tracey .Nm
 55 a596b957 2022-07-14 tracey can be configured via the
 56 59975c69 2022-08-29 stsp .Xr gotwebd.conf 5
 57 a596b957 2022-07-14 tracey configuration file.
 58 a596b957 2022-07-14 tracey .It
 59 a596b957 2022-07-14 tracey Git repositories must be created at a suitable location inside the
 60 a596b957 2022-07-14 tracey web server's
 61 a596b957 2022-07-14 tracey .Xr chroot 2
 62 a596b957 2022-07-14 tracey environment.
 63 a596b957 2022-07-14 tracey These repositories should
 64 a596b957 2022-07-14 tracey .Em not
 65 a596b957 2022-07-14 tracey be writable by the user ID of the
 66 a596b957 2022-07-14 tracey .Xr httpd 8
 67 a596b957 2022-07-14 tracey server.
 68 a596b957 2022-07-14 tracey The default location for repositories published by
 69 a596b957 2022-07-14 tracey .Nm
 70 a596b957 2022-07-14 tracey is
 71 a596b957 2022-07-14 tracey .Pa /var/www/got/public .
 72 a596b957 2022-07-14 tracey .It
 73 a596b957 2022-07-14 tracey Git repositories served by
 74 a596b957 2022-07-14 tracey .Nm
 75 a596b957 2022-07-14 tracey should be kept up-to-date with a mechanism such as
 76 a596b957 2022-07-14 tracey .Cm got fetch ,
 77 a596b957 2022-07-14 tracey .Xr git-fetch 1 ,
 78 a596b957 2022-07-14 tracey or
 79 a596b957 2022-07-14 tracey .Xr rsync 1 ,
 80 a596b957 2022-07-14 tracey scheduled by
 81 a596b957 2022-07-14 tracey .Xr cron 8 .
 82 a596b957 2022-07-14 tracey .El
 83 a596b957 2022-07-14 tracey .Sh FILES
 84 a596b957 2022-07-14 tracey .Bl -tag -width /var/www/got/public/ -compact
 85 a596b957 2022-07-14 tracey .It Pa /var/www/got/public/
 86 a596b957 2022-07-14 tracey Default location for Git repositories served by
 87 a596b957 2022-07-14 tracey .Nm .
 88 a596b957 2022-07-14 tracey This location can be adjusted in the
 89 59975c69 2022-08-29 stsp .Xr gotwebd.conf 5
 90 a596b957 2022-07-14 tracey configuration file.
 91 59975c69 2022-08-29 stsp .It Pa /var/www/bin/gotwebd/
 92 a596b957 2022-07-14 tracey Directory containing statically linked
 93 a596b957 2022-07-14 tracey .Xr got 1
 94 a596b957 2022-07-14 tracey helper programs which are run by
 95 a596b957 2022-07-14 tracey .Nm
 96 a596b957 2022-07-14 tracey to read Git repositories.
 97 59975c69 2022-08-29 stsp .It Pa /var/www/htdocs/gotwebd/
 98 a596b957 2022-07-14 tracey Directory containing HTML, CSS, and image files used by
 99 a596b957 2022-07-14 tracey .Nm .
100 59975c69 2022-08-29 stsp .It Pa /tmp/
101 a596b957 2022-07-14 tracey Directory for temporary files created by
102 a596b957 2022-07-14 tracey .Nm .
103 a596b957 2022-07-14 tracey .El
104 a596b957 2022-07-14 tracey .Sh EXAMPLES
105 a596b957 2022-07-14 tracey Example configuration for httpd.conf:
106 a596b957 2022-07-14 tracey .Bd -literal -offset indent
107 a596b957 2022-07-14 tracey 
108 a596b957 2022-07-14 tracey   types { include "/usr/share/misc/mime.types" }
109 a596b957 2022-07-14 tracey   server "gotweb.example.com" {
110 a596b957 2022-07-14 tracey   	listen on * port 80
111 59975c69 2022-08-29 stsp   	root "/htdocs"
112 59975c69 2022-08-29 stsp         location "/gotwebd-unix/*" {
113 59975c69 2022-08-29 stsp               fastcgi socket "/run/gotweb.sock"
114 59975c69 2022-08-29 stsp         }
115 59975c69 2022-08-29 stsp         location "/gotwebd-tcp/*" {
116 59975c69 2022-08-29 stsp               fastcgi socket tcp 127.0.0.1 9000
117 59975c69 2022-08-29 stsp         }
118 59975c69 2022-08-29 stsp         location "/*" {
119 59975c69 2022-08-29 stsp               directory index "index.html"
120 59975c69 2022-08-29 stsp         }
121 a596b957 2022-07-14 tracey   }
122 a596b957 2022-07-14 tracey .Ed
123 a596b957 2022-07-14 tracey .Sh SEE ALSO
124 a596b957 2022-07-14 tracey .Xr got 1 ,
125 a596b957 2022-07-14 tracey .Xr git-repository 5 ,
126 59975c69 2022-08-29 stsp .Xr gotwebd.conf 5 ,
127 59975c69 2022-08-29 stsp .Xr httpd 8
128 a596b957 2022-07-14 tracey .Sh AUTHORS
129 59975c69 2022-08-29 stsp .An Omar Polo Aq Mt op@openbsd.org
130 a596b957 2022-07-14 tracey .An Stefan Sperling Aq Mt stsp@openbsd.org
131 59975c69 2022-08-29 stsp .An Tracey Emery Aq Mt tracey@traceyemery.net