Blame


1 497977d5 2021-01-23 op .\" Copyright (c) 2021 Omar Polo <op@omarpolo.com>
2 497977d5 2021-01-23 op .\"
3 497977d5 2021-01-23 op .\" Permission to use, copy, modify, and distribute this software for any
4 497977d5 2021-01-23 op .\" purpose with or without fee is hereby granted, provided that the above
5 497977d5 2021-01-23 op .\" copyright notice and this permission notice appear in all copies.
6 497977d5 2021-01-23 op .\"
7 497977d5 2021-01-23 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 497977d5 2021-01-23 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 497977d5 2021-01-23 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 497977d5 2021-01-23 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 497977d5 2021-01-23 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 497977d5 2021-01-23 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 497977d5 2021-01-23 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 497977d5 2021-01-23 op .Dd $Mdocdate: January 23 2021$
15 497977d5 2021-01-23 op .Dt GG 1
16 497977d5 2021-01-23 op .Os
17 497977d5 2021-01-23 op .Sh NAME
18 497977d5 2021-01-23 op .Nm gg
19 497977d5 2021-01-23 op .Nd simple Gemini client
20 497977d5 2021-01-23 op .Sh SYNOPSIS
21 497977d5 2021-01-23 op .Nm
22 497977d5 2021-01-23 op .Bk -words
23 58173ca2 2021-01-27 op .Op Fl 23bchNVv
24 58173ca2 2021-01-27 op .Op Fl H Ar hostname
25 497977d5 2021-01-23 op .Ar IRI
26 497977d5 2021-01-23 op .Ek
27 497977d5 2021-01-23 op .Sh DESCRIPTION
28 497977d5 2021-01-23 op .Nm
29 497977d5 2021-01-23 op is a simple Gemini client.
30 497977d5 2021-01-23 op It fetches the Gemini page given and prints the server response to
31 497977d5 2021-01-23 op standard output.
32 497977d5 2021-01-23 op The option are as follows:
33 497977d5 2021-01-23 op .Bl -tag -width 6m
34 497977d5 2021-01-23 op .It Fl 2
35 497977d5 2021-01-23 op Use only TLSv1.2.
36 497977d5 2021-01-23 op .It Fl 3
37 497977d5 2021-01-23 op Use only TLSv1.3.
38 497977d5 2021-01-23 op .It Fl b
39 497977d5 2021-01-23 op Print only the body of the response.
40 497977d5 2021-01-23 op .It Fl c
41 497977d5 2021-01-23 op Print only the response code.
42 58173ca2 2021-01-27 op .It Fl H Ar hostname
43 58173ca2 2021-01-27 op Use the given
44 58173ca2 2021-01-27 op .Ar hostname
45 58173ca2 2021-01-27 op for SNI, instead of the one extracted from the IRI.
46 58173ca2 2021-01-27 op The IRI hostname will still be used for the DNS resolution.
47 497977d5 2021-01-23 op .It Fl h
48 497977d5 2021-01-23 op Print only the response header.
49 497977d5 2021-01-23 op .It Fl N
50 497977d5 2021-01-23 op Don't check whether the peer certificate name matches the requested
51 497977d5 2021-01-23 op hostname.
52 497977d5 2021-01-23 op .It Fl V
53 497977d5 2021-01-23 op Only validate the IRI, don't do the Gemini transaction.
54 58173ca2 2021-01-27 op .It Fl v
55 58173ca2 2021-01-27 op Print also the request.
56 497977d5 2021-01-23 op .El
57 497977d5 2021-01-23 op .Pp
58 497977d5 2021-01-23 op Note that
59 497977d5 2021-01-23 op .Nm
60 497977d5 2021-01-23 op won't try to do TOFU (Trust On First Use) or any X.509 certificate
61 497977d5 2021-01-23 op validation: it will happily accept any certificate it is given.
62 497977d5 2021-01-23 op .Pp
63 497977d5 2021-01-23 op By default
64 497977d5 2021-01-23 op .Nm
65 497977d5 2021-01-23 op will accept both TLSv1.2 and TLSv1.3 and will always do SNI.