Blame
Date:
Wed Sep 7 20:47:33 2022 UTC
Message:
add ge: gemini export!
01
2022-09-07
op
.\" Copyright (c) 2022 Omar Polo <op@omarpolo.com>
02
2022-09-07
op
.\"
03
2022-09-07
op
.\" Permission to use, copy, modify, and distribute this software for any
04
2022-09-07
op
.\" purpose with or without fee is hereby granted, provided that the above
05
2022-09-07
op
.\" copyright notice and this permission notice appear in all copies.
06
2022-09-07
op
.\"
07
2022-09-07
op
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
08
2022-09-07
op
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
09
2022-09-07
op
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10
2022-09-07
op
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11
2022-09-07
op
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12
2022-09-07
op
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13
2022-09-07
op
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14
2022-09-07
op
.Dd September 7, 2022
15
2022-09-07
op
.Dt GE 1
16
2022-09-07
op
.Os
17
2022-09-07
op
.Sh NAME
18
2022-09-07
op
.Nm ge
19
2022-09-07
op
.Nd export a directory over Gemini
20
2022-09-07
op
.Sh SYNOPSIS
21
2022-09-07
op
.Nm
22
2022-09-07
op
.Bk -words
23
2022-09-07
op
.Op Fl hV
24
2022-09-07
op
.Op Fl d Ar certs-dir
25
2022-09-07
op
.Op Fl H Ar hostname
26
2022-09-07
op
.Op Fl p Ar port
27
2022-09-07
op
.Op Ar directory
28
2022-09-07
op
.Ek
29
2022-09-07
op
.Sh DESCRIPTION
30
2022-09-07
op
.Nm
31
2022-09-07
op
exports the given
32
2022-09-07
op
.Ar directory
33
2022-09-07
op
over the Gemini protocol.
34
2022-09-07
op
It's intended to be used interactively mostly for testing purposes,
35
2022-09-07
op
for a full-fledged daemon look for
36
2022-09-07
op
.Xr gmid 8 .
37
2022-09-07
op
.Pp
38
2022-09-07
op
The arguments are as follows:
39
2022-09-07
op
.Bl -tag -width Ds
40
2022-09-07
op
.It Fl d Ar certs-path
41
2022-09-07
op
Directory where certificates are stored.
42
2022-09-07
op
By default is
43
2022-09-07
op
.Pa $XDG_DATA_HOME/gmid ,
44
2022-09-07
op
i.e.\&
45
2022-09-07
op
.Pa ~/.local/share/gmid .
46
2022-09-07
op
.It Fl H Ar hostname
47
2022-09-07
op
The
48
2022-09-07
op
.Ar hostname
49
2022-09-07
op
to use,
50
2022-09-07
op
.Ar localhost
51
2022-09-07
op
by default.
52
2022-09-07
op
Certificates for the given
53
2022-09-07
op
.Ar hostname
54
2022-09-07
op
are searched inside the
55
2022-09-07
op
.Ar certs-dir
56
2022-09-07
op
specified with the
57
2022-09-07
op
.Fl d
58
2022-09-07
op
option.
59
2022-09-07
op
The certificate files are named
60
2022-09-07
op
.Ar hostname Ns .pem
61
2022-09-07
op
and
62
2022-09-07
op
.Ar hostname Ns .key
63
2022-09-07
op
and are implicitly generated if not found.
64
2022-09-07
op
.It Fl h , Fl -help
65
2022-09-07
op
Print the usage and exit.
66
2022-09-07
op
.It Fl p Ar port
67
2022-09-07
op
The port to bind to, 1965 by default.
68
2022-09-07
op
.It Fl V , Fl -version
69
2022-09-07
op
Print the version and exit.
70
2022-09-07
op
.It Ar directory
71
2022-09-07
op
The root directory to serve, or the current working directory if not
72
2022-09-07
op
specified.
73
2022-09-07
op
.El
74
2022-09-07
op
.Sh SEE ALSO
75
2022-09-07
op
.Xr gmid 8
76
2022-09-07
op
.Sh ACKNOWLEDGEMENTS
77
2022-09-07
op
.Nm
78
2022-09-07
op
uses the
79
2022-09-07
op
.Dq Flexible and Economical
80
2022-09-07
op
UTF-8 decoder written by
81
2022-09-07
op
.An Bjoern Hoehrmann .
82
2022-09-07
op
.Sh AUTHORS
83
2022-09-07
op
.An -nosplit
84
2022-09-07
op
The
85
2022-09-07
op
.Nm
86
2022-09-07
op
program was written by
87
2022-09-07
op
.An Omar Polo Aq Mt op@omarpolo.com .
Omar Polo