libgeminiclient/gemini-cat.1

56 lines
1.2 KiB
Groff

.Dd Apr 29, 2020
.Dt GEMINI-CAT 1
.Os
.Sh NAME
.Nm gemini-cat
.Nd concatnate responses from a Gemini URLs
.Sh SYNOPSIS
.Nm
.Op Fl RSisw
.Op Fl c Ar cert-file
.Op Fl k Ar key-file
.Op Fl p Ar port
.Op Fl r Ar max-redirects
.Op Fl t Ar tofu-file
.Ar URL ...
.Sh DESCRIPTION
Concatnate the responses from tha
.Ar URL
arguments obtained by using the Gemini portocol.
The options are as follows:
.Bl -tag -width Ds
.It Fl R
Output the raw file, the default for non-TTY outputs.
.It Fl S
Strip out non-space control-characters before writing, the default for
TTY outputs.
.It Fl c Ar cert-file
The certificate file to use for TLS.
.It Fl i
Interactive mode (allow prompts).
.It Fl k Ar key-file
The key file to use for TLS.
.It Fl p Ar port
Use
.Ar port
instead of the default
.Pq 1965 .
.It Fl r Ar max-redirects
Set the maximum number of redirects (5 by default).
.It Fl s
Secure interactive mode (allow prompts, but do not echo).
.It Fl t Ar tofu-file
The file to read host certificate hashes from.
.It Fl w
Write any new hashes to the
.Ar tofu-file .
.El
.Sh EXAMPLES
Fetch the
.Lk tilde.black
root index:
.Dl gemini-cat gemini://tilde.black/ | more
.Sh SEE ALSO
.Xr tls_config_set_cert_file 3
.Xr tls_config_set_key_file 3