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 797c527a 2023-10-19 op .Dd $Mdocdate: October 19 2023$
 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 0eeee6f3 2023-08-03 op Use TLSv1.2.
 41 5c7abf01 2021-12-29 op .It Fl 3
 42 0eeee6f3 2023-08-03 op Use 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 0eeee6f3 2023-08-03 op .It Ic none
 54 3a877237 2023-06-24 op print only the body of the reply, the default.
 55 0eeee6f3 2023-08-03 op .It Ic code
 56 3a877237 2023-06-24 op print only the response code.
 57 0eeee6f3 2023-08-03 op .It Ic header
 58 3a877237 2023-06-24 op print only the response header.
 59 0eeee6f3 2023-08-03 op .It Ic meta
 60 3a877237 2023-06-24 op print only the response meta.
 61 0eeee6f3 2023-08-03 op .It Ic 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 797c527a 2023-10-19 op Check the given IRI for validity, but don't issue 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 c7bcd4a8 2023-10-15 op If a failure occurs, it exits with status code 1.
 96 c7bcd4a8 2023-10-15 op Otherwise, the error code reflects the Gemini response code.
 97 5c7abf01 2021-12-29 op .Sh ACKNOWLEDGEMENTS
 98 5c7abf01 2021-12-29 op .Nm
 99 5c7abf01 2021-12-29 op uses the
100 5c7abf01 2021-12-29 op .Dq Flexible and Economical
101 5c7abf01 2021-12-29 op UTF-8 decoder written by
102 5c7abf01 2021-12-29 op .An Bjoern Hoehrmann .
103 4645a68a 2023-10-18 op .Sh SEE ALSO
104 4645a68a 2023-10-18 op .Xr ftp 1 ,
105 4645a68a 2023-10-18 op .Xr titan 1
106 5c7abf01 2021-12-29 op .Sh AUTHORS
107 5c7abf01 2021-12-29 op .An -nosplit
108 5c7abf01 2021-12-29 op The
109 5c7abf01 2021-12-29 op .Nm
110 5c7abf01 2021-12-29 op utility was written by
111 5c7abf01 2021-12-29 op .An Omar Polo Aq Mt op@omarpolo.com .
112 5c7abf01 2021-12-29 op .Sh CAVEATS
113 5c7abf01 2021-12-29 op .Nm
114 797c527a 2023-10-19 op doesn't perform TOFU
115 5c7abf01 2021-12-29 op .Pq Trust On First Use
116 5c7abf01 2021-12-29 op or any X.509 certificate validation beyond the name verification.
117 5c7abf01 2021-12-29 op .Pp
118 5c7abf01 2021-12-29 op .Nm
119 5c7abf01 2021-12-29 op doesn't follow redirects.