96 lines
2.1 KiB
Groff
96 lines
2.1 KiB
Groff
.Dd Jun 20, 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 h Ar proxy-host
|
|
.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 h Ar proxy-host
|
|
The host to connect through.
|
|
.Ar proxy-host
|
|
can also specify a port number.
|
|
.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 ENVIRONMENT
|
|
.Bl -tag -width Ds
|
|
.It Ev GEMINI_KEYFILE
|
|
Sets the TLS key file before
|
|
.Fl k .
|
|
.It Ev GEMINI_CERTFILE
|
|
Sets the TLS certificate file before
|
|
.Fl c .
|
|
.It Ev GEMINI_TOFUFILE
|
|
Sets the TOFU tile before
|
|
.Fl t .
|
|
.It Ev GEMINI_PROXY
|
|
Sets the proxy host before
|
|
.Fl h .
|
|
.It Ev GEMINI_MAX_REDIRECTS
|
|
Sets the maximum number of redirects before
|
|
.Fl r .
|
|
.It Ev GEMINI_PORT
|
|
Sets the default port number before
|
|
.Fl p .
|
|
.It Ev GEMINI_TOFU_WRITE
|
|
If set to a non-empty string, it is equivalent to
|
|
.Fl w .
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Ex -std
|
|
.Sh EXAMPLES
|
|
Fetch the
|
|
.Lk tilde.black
|
|
root index:
|
|
.Dl gemini-cat gemini://tilde.black/ | more
|
|
Fetch
|
|
.Lk tilde.black
|
|
from its onion address:
|
|
.Bd -literal -offset indent -compact
|
|
torsocks gemini-cat -h \\
|
|
black6kfjetfuzaeozz7fs53whh7xtd4e27telrf5fg5kgdt5ah5plad.onion \\
|
|
//tilde.black/
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr libgeminiclient 3 ,
|
|
.Xr tls_config_set_cert_file 3 ,
|
|
.Xr tls_config_set_key_file 3
|