2022-01-13 11:13:32 +01:00
|
|
|
.\" Copyright (c) 2021, 2022 Omar Polo <op@omarpolo.com>
|
2021-12-29 19:01:08 +01:00
|
|
|
.\"
|
|
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
|
|
.\"
|
|
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
|
|
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
|
|
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
|
|
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
|
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
2022-01-30 14:31:29 +01:00
|
|
|
.Dd $Mdocdate: January 30 2022$
|
2021-12-29 19:01:08 +01:00
|
|
|
.Dt GG 1
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm gg
|
|
|
|
.Nd gemini client
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm
|
|
|
|
.Bk -words
|
|
|
|
.Op Fl 23Nnv
|
|
|
|
.Op Fl C Ar cert
|
|
|
|
.Op Fl d Ar mode
|
|
|
|
.Op Fl H Ar sni
|
|
|
|
.Op Fl K Ar key
|
2022-01-13 11:13:32 +01:00
|
|
|
.Op Fl P Ar host Ns Oo : Ns Ar port Oc
|
2021-12-29 19:01:08 +01:00
|
|
|
.Op Fl T Ar seconds
|
|
|
|
.Ar gemini://...
|
|
|
|
.Ek
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm
|
|
|
|
.Pq gemini get
|
|
|
|
fetches the given gemini page and prints it to standard output.
|
|
|
|
.Pp
|
|
|
|
The options are as follows:
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
.It Fl 2
|
|
|
|
Accept only TLSv1.2.
|
|
|
|
.It Fl 3
|
|
|
|
Accept only TLSv1.3.
|
|
|
|
.It Fl C Ar certificate
|
|
|
|
Use the given client
|
|
|
|
.Ar certificate .
|
|
|
|
.It Fl d Ar mode
|
|
|
|
Specify what
|
|
|
|
.Nm
|
|
|
|
should print.
|
|
|
|
.Ar mode
|
|
|
|
can be one of:
|
|
|
|
.Bl -tag -width header -compact
|
|
|
|
.It none
|
|
|
|
print only the body of the reply
|
|
|
|
.It code
|
|
|
|
print only the response code
|
|
|
|
.It header
|
|
|
|
print only the response header
|
|
|
|
.It meta
|
|
|
|
print only the response meta
|
2022-01-27 11:37:28 +01:00
|
|
|
.It all
|
2021-12-29 19:01:08 +01:00
|
|
|
print the whole response as-is.
|
|
|
|
.El
|
|
|
|
.It Fl H Ar sni
|
|
|
|
Use the given
|
|
|
|
.Ar sni
|
|
|
|
host name instead of the one deducted by the IRI or proxy.
|
|
|
|
.It Fl K Ar key
|
|
|
|
Specify the key for the certificate.
|
|
|
|
It's mandatory if
|
|
|
|
.Fl C
|
|
|
|
is used.
|
|
|
|
.It Fl N
|
|
|
|
Disables the server name verification.
|
|
|
|
.It Fl n
|
|
|
|
Check that the given IRI is valid, but don't make any requests.
|
2022-01-30 14:31:29 +01:00
|
|
|
.It Fl P Ar host Ns Oo : Ns Ar port Oc
|
2021-12-29 19:01:08 +01:00
|
|
|
Connect to the given
|
|
|
|
.Ar host
|
|
|
|
and
|
|
|
|
.Ar port
|
|
|
|
to do the request instead of the ones extracted by the IRI.
|
|
|
|
.Ar port
|
|
|
|
is by default 1965.
|
|
|
|
.It Fl T Ar seconds
|
|
|
|
Kill
|
|
|
|
.Nm
|
|
|
|
after
|
|
|
|
.Ar seconds .
|
|
|
|
.El
|
|
|
|
.Sh EXIT STATUS
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility exits with zero if the response code was in the 2x range.
|
|
|
|
.Sh ACKNOWLEDGEMENTS
|
|
|
|
.Nm
|
|
|
|
uses the
|
|
|
|
.Dq Flexible and Economical
|
|
|
|
UTF-8 decoder written by
|
|
|
|
.An Bjoern Hoehrmann .
|
|
|
|
.Sh AUTHORS
|
|
|
|
.An -nosplit
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility was written by
|
|
|
|
.An Omar Polo Aq Mt op@omarpolo.com .
|
|
|
|
.Sh CAVEATS
|
|
|
|
.Nm
|
|
|
|
doesn't do any TOFU
|
|
|
|
.Pq Trust On First Use
|
|
|
|
or any X.509 certificate validation beyond the name verification.
|
|
|
|
.Pp
|
|
|
|
.Nm
|
|
|
|
doesn't follow redirects.
|