Blob


1 .\"
2 .\" Copyright (c) 2022 Omar Polo
3 .\"
4 .\" Permission to use, copy, modify, and distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
7 .\"
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 .Dd September 24, 2022
16 .Dt GALILEO 8
17 .Os
18 .Sh NAME
19 .Nm galileo
20 .Nd Gemini proxy for the World Wide Web
21 .Sh SYNOPSIS
22 .Nm
23 .Op Fl dnv
24 .Op Fl D Ar macro Ns = Ns Ar value
25 .Op Fl f Ar file
26 .Sh DESCRIPTION
27 .Nm
28 is a FastCGI server that proxies the content of a Gemini capsule.
29 It has been designed to work out of the box with the
30 .Xr httpd 8
31 web server.
32 .Pp
33 .Nm
34 rereads its configuration file when it receives SIGHUP.
35 .Pp
36 The options are as follows:
37 .Bl -tag -width tenletters
38 .It Fl d
39 Do not daemonize and log to standard error.
40 .It Fl D Ar macro Ns = Ns Ar value
41 Override the value of a macro used in the configuration file.
42 .It Fl f Ar file
43 Specify the configuration file.
44 The default is
45 .Pa /etc/galileo.conf .
46 .It Fl n
47 Parse the configuration file, report errors if any, and exit.
48 .It Fl v
49 Verbose mode.
50 .El
51 .Sh FILES
52 .Bl -tag -width /etc/galileo.conf -compact
53 .It Pa /etc/galileo.conf
54 Default location of the
55 .Xr galileo.conf 5
56 configuration file.
57 .It Pa /var/www/run/galileo.sock
58 Default
59 .Ux Ns -domain socket for communication with
60 .Xr httpd 8 .
61 .El
62 .Sh SEE ALSO
63 .Xr galileo.conf 5 ,
64 .Xr httpd 8
65 .Sh AUTHORS
66 The
67 .Nm
68 program was written by
69 .An Omar Polo Aq Mt op@omarpolo.com .