1 0126d91d 2022-09-07 op .\" Copyright (c) 2022 Omar Polo <op@omarpolo.com>
3 0126d91d 2022-09-07 op .\" Permission to use, copy, modify, and distribute this software for any
4 0126d91d 2022-09-07 op .\" purpose with or without fee is hereby granted, provided that the above
5 0126d91d 2022-09-07 op .\" copyright notice and this permission notice appear in all copies.
7 0126d91d 2022-09-07 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 0126d91d 2022-09-07 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 0126d91d 2022-09-07 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 0126d91d 2022-09-07 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 0126d91d 2022-09-07 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 0126d91d 2022-09-07 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 0126d91d 2022-09-07 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 0126d91d 2022-09-07 op .Dd September 7, 2022
19 0126d91d 2022-09-07 op .Nd export a directory over Gemini
24 0126d91d 2022-09-07 op .Op Fl d Ar certs-dir
25 0126d91d 2022-09-07 op .Op Fl H Ar hostname
26 0126d91d 2022-09-07 op .Op Fl p Ar port
27 0126d91d 2022-09-07 op .Op Ar directory
29 0126d91d 2022-09-07 op .Sh DESCRIPTION
31 0126d91d 2022-09-07 op exports the given
33 0126d91d 2022-09-07 op over the Gemini protocol.
34 0126d91d 2022-09-07 op It's intended to be used interactively mostly for testing purposes,
35 0126d91d 2022-09-07 op for a full-fledged daemon look for
38 0126d91d 2022-09-07 op The arguments are as follows:
39 0126d91d 2022-09-07 op .Bl -tag -width Ds
40 0126d91d 2022-09-07 op .It Fl d Ar certs-path
41 0126d91d 2022-09-07 op Directory where certificates are stored.
43 0126d91d 2022-09-07 op .Pa $XDG_DATA_HOME/gmid ,
45 0126d91d 2022-09-07 op .Pa ~/.local/share/gmid .
46 0126d91d 2022-09-07 op .It Fl H Ar hostname
52 0126d91d 2022-09-07 op Certificates for the given
54 0126d91d 2022-09-07 op are searched inside the
56 0126d91d 2022-09-07 op specified with the
59 0126d91d 2022-09-07 op The certificate files are named
60 0126d91d 2022-09-07 op .Ar hostname Ns .pem
62 0126d91d 2022-09-07 op .Ar hostname Ns .key
63 0126d91d 2022-09-07 op and are implicitly generated if not found.
64 0126d91d 2022-09-07 op .It Fl h , Fl -help
65 0126d91d 2022-09-07 op Print the usage and exit.
66 0126d91d 2022-09-07 op .It Fl p Ar port
67 0126d91d 2022-09-07 op The port to bind to, 1965 by default.
68 0126d91d 2022-09-07 op .It Fl V , Fl -version
69 0126d91d 2022-09-07 op Print the version and exit.
70 0126d91d 2022-09-07 op .It Ar directory
71 0126d91d 2022-09-07 op The root directory to serve, or the current working directory if not
76 0126d91d 2022-09-07 op .Sh ACKNOWLEDGEMENTS
79 0126d91d 2022-09-07 op .Dq Flexible and Economical
80 0126d91d 2022-09-07 op UTF-8 decoder written by
81 0126d91d 2022-09-07 op .An Bjoern Hoehrmann .
86 0126d91d 2022-09-07 op program was written by
87 0126d91d 2022-09-07 op .An Omar Polo Aq Mt op@omarpolo.com .