Blame


1 0126d91d 2022-09-07 op .\" Copyright (c) 2022 Omar Polo <op@omarpolo.com>
2 0126d91d 2022-09-07 op .\"
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.
6 0126d91d 2022-09-07 op .\"
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
15 0126d91d 2022-09-07 op .Dt GE 1
16 0126d91d 2022-09-07 op .Os
17 0126d91d 2022-09-07 op .Sh NAME
18 0126d91d 2022-09-07 op .Nm ge
19 0126d91d 2022-09-07 op .Nd export a directory over Gemini
20 0126d91d 2022-09-07 op .Sh SYNOPSIS
21 0126d91d 2022-09-07 op .Nm
22 0126d91d 2022-09-07 op .Bk -words
23 0126d91d 2022-09-07 op .Op Fl hV
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
28 0126d91d 2022-09-07 op .Ek
29 0126d91d 2022-09-07 op .Sh DESCRIPTION
30 0126d91d 2022-09-07 op .Nm
31 0126d91d 2022-09-07 op exports the given
32 0126d91d 2022-09-07 op .Ar directory
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
36 0126d91d 2022-09-07 op .Xr gmid 8 .
37 0126d91d 2022-09-07 op .Pp
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.
42 0126d91d 2022-09-07 op By default is
43 0126d91d 2022-09-07 op .Pa $XDG_DATA_HOME/gmid ,
44 0126d91d 2022-09-07 op i.e.\&
45 0126d91d 2022-09-07 op .Pa ~/.local/share/gmid .
46 0126d91d 2022-09-07 op .It Fl H Ar hostname
47 0126d91d 2022-09-07 op The
48 0126d91d 2022-09-07 op .Ar hostname
49 0126d91d 2022-09-07 op to use,
50 0126d91d 2022-09-07 op .Ar localhost
51 0126d91d 2022-09-07 op by default.
52 0126d91d 2022-09-07 op Certificates for the given
53 0126d91d 2022-09-07 op .Ar hostname
54 0126d91d 2022-09-07 op are searched inside the
55 0126d91d 2022-09-07 op .Ar certs-dir
56 0126d91d 2022-09-07 op specified with the
57 0126d91d 2022-09-07 op .Fl d
58 0126d91d 2022-09-07 op option.
59 0126d91d 2022-09-07 op The certificate files are named
60 0126d91d 2022-09-07 op .Ar hostname Ns .pem
61 0126d91d 2022-09-07 op and
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
72 0126d91d 2022-09-07 op specified.
73 0126d91d 2022-09-07 op .El
74 0126d91d 2022-09-07 op .Sh SEE ALSO
75 0126d91d 2022-09-07 op .Xr gmid 8
76 0126d91d 2022-09-07 op .Sh ACKNOWLEDGEMENTS
77 0126d91d 2022-09-07 op .Nm
78 0126d91d 2022-09-07 op uses the
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 .
82 0126d91d 2022-09-07 op .Sh AUTHORS
83 0126d91d 2022-09-07 op .An -nosplit
84 0126d91d 2022-09-07 op The
85 0126d91d 2022-09-07 op .Nm
86 0126d91d 2022-09-07 op program was written by
87 0126d91d 2022-09-07 op .An Omar Polo Aq Mt op@omarpolo.com .