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