Blame


1 febfcde8 2022-01-13 op .\" Copyright (c) 2021, 2022 Omar Polo <op@omarpolo.com>
2 5c7abf01 2021-12-29 op .\"
3 5c7abf01 2021-12-29 op .\" Permission to use, copy, modify, and distribute this software for any
4 5c7abf01 2021-12-29 op .\" purpose with or without fee is hereby granted, provided that the above
5 5c7abf01 2021-12-29 op .\" copyright notice and this permission notice appear in all copies.
6 5c7abf01 2021-12-29 op .\"
7 5c7abf01 2021-12-29 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 5c7abf01 2021-12-29 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 5c7abf01 2021-12-29 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 5c7abf01 2021-12-29 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 5c7abf01 2021-12-29 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 5c7abf01 2021-12-29 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 5c7abf01 2021-12-29 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 d78dbe8d 2022-01-30 op .Dd $Mdocdate: January 30 2022$
15 5c7abf01 2021-12-29 op .Dt GG 1
16 5c7abf01 2021-12-29 op .Os
17 5c7abf01 2021-12-29 op .Sh NAME
18 5c7abf01 2021-12-29 op .Nm gg
19 5c7abf01 2021-12-29 op .Nd gemini client
20 5c7abf01 2021-12-29 op .Sh SYNOPSIS
21 5c7abf01 2021-12-29 op .Nm
22 5c7abf01 2021-12-29 op .Bk -words
23 21cf735f 2022-10-30 op .Op Fl 23Nn
24 5c7abf01 2021-12-29 op .Op Fl C Ar cert
25 5c7abf01 2021-12-29 op .Op Fl d Ar mode
26 5c7abf01 2021-12-29 op .Op Fl H Ar sni
27 5c7abf01 2021-12-29 op .Op Fl K Ar key
28 febfcde8 2022-01-13 op .Op Fl P Ar host Ns Oo : Ns Ar port Oc
29 5c7abf01 2021-12-29 op .Op Fl T Ar seconds
30 5c7abf01 2021-12-29 op .Ar gemini://...
31 5c7abf01 2021-12-29 op .Ek
32 5c7abf01 2021-12-29 op .Sh DESCRIPTION
33 5c7abf01 2021-12-29 op .Nm
34 5c7abf01 2021-12-29 op .Pq gemini get
35 5c7abf01 2021-12-29 op fetches the given gemini page and prints it to standard output.
36 5c7abf01 2021-12-29 op .Pp
37 5c7abf01 2021-12-29 op The options are as follows:
38 5c7abf01 2021-12-29 op .Bl -tag -width Ds
39 5c7abf01 2021-12-29 op .It Fl 2
40 5c7abf01 2021-12-29 op Accept only TLSv1.2.
41 5c7abf01 2021-12-29 op .It Fl 3
42 5c7abf01 2021-12-29 op Accept only TLSv1.3.
43 5c7abf01 2021-12-29 op .It Fl C Ar certificate
44 5c7abf01 2021-12-29 op Use the given client
45 5c7abf01 2021-12-29 op .Ar certificate .
46 5c7abf01 2021-12-29 op .It Fl d Ar mode
47 5c7abf01 2021-12-29 op Specify what
48 5c7abf01 2021-12-29 op .Nm
49 5c7abf01 2021-12-29 op should print.
50 5c7abf01 2021-12-29 op .Ar mode
51 5c7abf01 2021-12-29 op can be one of:
52 5c7abf01 2021-12-29 op .Bl -tag -width header -compact
53 5c7abf01 2021-12-29 op .It none
54 5c7abf01 2021-12-29 op print only the body of the reply
55 5c7abf01 2021-12-29 op .It code
56 5c7abf01 2021-12-29 op print only the response code
57 5c7abf01 2021-12-29 op .It header
58 5c7abf01 2021-12-29 op print only the response header
59 5c7abf01 2021-12-29 op .It meta
60 5c7abf01 2021-12-29 op print only the response meta
61 e89f4739 2022-01-27 op .It all
62 5c7abf01 2021-12-29 op print the whole response as-is.
63 5c7abf01 2021-12-29 op .El
64 5c7abf01 2021-12-29 op .It Fl H Ar sni
65 5c7abf01 2021-12-29 op Use the given
66 5c7abf01 2021-12-29 op .Ar sni
67 5c7abf01 2021-12-29 op host name instead of the one deducted by the IRI or proxy.
68 5c7abf01 2021-12-29 op .It Fl K Ar key
69 5c7abf01 2021-12-29 op Specify the key for the certificate.
70 5c7abf01 2021-12-29 op It's mandatory if
71 5c7abf01 2021-12-29 op .Fl C
72 5c7abf01 2021-12-29 op is used.
73 5c7abf01 2021-12-29 op .It Fl N
74 5c7abf01 2021-12-29 op Disables the server name verification.
75 5c7abf01 2021-12-29 op .It Fl n
76 5c7abf01 2021-12-29 op Check that the given IRI is valid, but don't make any requests.
77 d78dbe8d 2022-01-30 op .It Fl P Ar host Ns Oo : Ns Ar port Oc
78 5c7abf01 2021-12-29 op Connect to the given
79 5c7abf01 2021-12-29 op .Ar host
80 5c7abf01 2021-12-29 op and
81 5c7abf01 2021-12-29 op .Ar port
82 5c7abf01 2021-12-29 op to do the request instead of the ones extracted by the IRI.
83 5c7abf01 2021-12-29 op .Ar port
84 5c7abf01 2021-12-29 op is by default 1965.
85 5c7abf01 2021-12-29 op .It Fl T Ar seconds
86 5c7abf01 2021-12-29 op Kill
87 5c7abf01 2021-12-29 op .Nm
88 5c7abf01 2021-12-29 op after
89 5c7abf01 2021-12-29 op .Ar seconds .
90 5c7abf01 2021-12-29 op .El
91 5c7abf01 2021-12-29 op .Sh EXIT STATUS
92 5c7abf01 2021-12-29 op The
93 5c7abf01 2021-12-29 op .Nm
94 5c7abf01 2021-12-29 op utility exits with zero if the response code was in the 2x range.
95 5c7abf01 2021-12-29 op .Sh ACKNOWLEDGEMENTS
96 5c7abf01 2021-12-29 op .Nm
97 5c7abf01 2021-12-29 op uses the
98 5c7abf01 2021-12-29 op .Dq Flexible and Economical
99 5c7abf01 2021-12-29 op UTF-8 decoder written by
100 5c7abf01 2021-12-29 op .An Bjoern Hoehrmann .
101 5c7abf01 2021-12-29 op .Sh AUTHORS
102 5c7abf01 2021-12-29 op .An -nosplit
103 5c7abf01 2021-12-29 op The
104 5c7abf01 2021-12-29 op .Nm
105 5c7abf01 2021-12-29 op utility was written by
106 5c7abf01 2021-12-29 op .An Omar Polo Aq Mt op@omarpolo.com .
107 5c7abf01 2021-12-29 op .Sh CAVEATS
108 5c7abf01 2021-12-29 op .Nm
109 5c7abf01 2021-12-29 op doesn't do any TOFU
110 5c7abf01 2021-12-29 op .Pq Trust On First Use
111 5c7abf01 2021-12-29 op or any X.509 certificate validation beyond the name verification.
112 5c7abf01 2021-12-29 op .Pp
113 5c7abf01 2021-12-29 op .Nm
114 5c7abf01 2021-12-29 op doesn't follow redirects.