Blame
Date:
Sun Jan 30 13:31:29 2022 UTC
Message:
fix gg -P flag description: the `:' is in the optional part
001
2022-01-13
op
.\" Copyright (c) 2021, 2022 Omar Polo <op@omarpolo.com>
002
2021-12-29
op
.\"
003
2021-12-29
op
.\" Permission to use, copy, modify, and distribute this software for any
004
2021-12-29
op
.\" purpose with or without fee is hereby granted, provided that the above
005
2021-12-29
op
.\" copyright notice and this permission notice appear in all copies.
006
2021-12-29
op
.\"
007
2021-12-29
op
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
008
2021-12-29
op
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
009
2021-12-29
op
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
010
2021-12-29
op
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
011
2021-12-29
op
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
012
2021-12-29
op
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
013
2021-12-29
op
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
014
2022-01-30
op
.Dd $Mdocdate: January 30 2022$
015
2021-12-29
op
.Dt GG 1
016
2021-12-29
op
.Os
017
2021-12-29
op
.Sh NAME
018
2021-12-29
op
.Nm gg
019
2021-12-29
op
.Nd gemini client
020
2021-12-29
op
.Sh SYNOPSIS
021
2021-12-29
op
.Nm
022
2021-12-29
op
.Bk -words
023
2021-12-29
op
.Op Fl 23Nnv
024
2021-12-29
op
.Op Fl C Ar cert
025
2021-12-29
op
.Op Fl d Ar mode
026
2021-12-29
op
.Op Fl H Ar sni
027
2021-12-29
op
.Op Fl K Ar key
028
2022-01-13
op
.Op Fl P Ar host Ns Oo : Ns Ar port Oc
029
2021-12-29
op
.Op Fl T Ar seconds
030
2021-12-29
op
.Ar gemini://...
031
2021-12-29
op
.Ek
032
2021-12-29
op
.Sh DESCRIPTION
033
2021-12-29
op
.Nm
034
2021-12-29
op
.Pq gemini get
035
2021-12-29
op
fetches the given gemini page and prints it to standard output.
036
2021-12-29
op
.Pp
037
2021-12-29
op
The options are as follows:
038
2021-12-29
op
.Bl -tag -width Ds
039
2021-12-29
op
.It Fl 2
040
2021-12-29
op
Accept only TLSv1.2.
041
2021-12-29
op
.It Fl 3
042
2021-12-29
op
Accept only TLSv1.3.
043
2021-12-29
op
.It Fl C Ar certificate
044
2021-12-29
op
Use the given client
045
2021-12-29
op
.Ar certificate .
046
2021-12-29
op
.It Fl d Ar mode
047
2021-12-29
op
Specify what
048
2021-12-29
op
.Nm
049
2021-12-29
op
should print.
050
2021-12-29
op
.Ar mode
051
2021-12-29
op
can be one of:
052
2021-12-29
op
.Bl -tag -width header -compact
053
2021-12-29
op
.It none
054
2021-12-29
op
print only the body of the reply
055
2021-12-29
op
.It code
056
2021-12-29
op
print only the response code
057
2021-12-29
op
.It header
058
2021-12-29
op
print only the response header
059
2021-12-29
op
.It meta
060
2021-12-29
op
print only the response meta
061
2022-01-27
op
.It all
062
2021-12-29
op
print the whole response as-is.
063
2021-12-29
op
.El
064
2021-12-29
op
.It Fl H Ar sni
065
2021-12-29
op
Use the given
066
2021-12-29
op
.Ar sni
067
2021-12-29
op
host name instead of the one deducted by the IRI or proxy.
068
2021-12-29
op
.It Fl K Ar key
069
2021-12-29
op
Specify the key for the certificate.
070
2021-12-29
op
It's mandatory if
071
2021-12-29
op
.Fl C
072
2021-12-29
op
is used.
073
2021-12-29
op
.It Fl N
074
2021-12-29
op
Disables the server name verification.
075
2021-12-29
op
.It Fl n
076
2021-12-29
op
Check that the given IRI is valid, but don't make any requests.
077
2022-01-30
op
.It Fl P Ar host Ns Oo : Ns Ar port Oc
078
2021-12-29
op
Connect to the given
079
2021-12-29
op
.Ar host
080
2021-12-29
op
and
081
2021-12-29
op
.Ar port
082
2021-12-29
op
to do the request instead of the ones extracted by the IRI.
083
2021-12-29
op
.Ar port
084
2021-12-29
op
is by default 1965.
085
2021-12-29
op
.It Fl T Ar seconds
086
2021-12-29
op
Kill
087
2021-12-29
op
.Nm
088
2021-12-29
op
after
089
2021-12-29
op
.Ar seconds .
090
2021-12-29
op
.El
091
2021-12-29
op
.Sh EXIT STATUS
092
2021-12-29
op
The
093
2021-12-29
op
.Nm
094
2021-12-29
op
utility exits with zero if the response code was in the 2x range.
095
2021-12-29
op
.Sh ACKNOWLEDGEMENTS
096
2021-12-29
op
.Nm
097
2021-12-29
op
uses the
098
2021-12-29
op
.Dq Flexible and Economical
099
2021-12-29
op
UTF-8 decoder written by
100
2021-12-29
op
.An Bjoern Hoehrmann .
101
2021-12-29
op
.Sh AUTHORS
102
2021-12-29
op
.An -nosplit
103
2021-12-29
op
The
104
2021-12-29
op
.Nm
105
2021-12-29
op
utility was written by
106
2021-12-29
op
.An Omar Polo Aq Mt op@omarpolo.com .
107
2021-12-29
op
.Sh CAVEATS
108
2021-12-29
op
.Nm
109
2021-12-29
op
doesn't do any TOFU
110
2021-12-29
op
.Pq Trust On First Use
111
2021-12-29
op
or any X.509 certificate validation beyond the name verification.
112
2021-12-29
op
.Pp
113
2021-12-29
op
.Nm
114
2021-12-29
op
doesn't follow redirects.
Omar Polo