gmni

a gemini line mode client
git clone https://git.clttr.info/gmni.git
Log (Feed) | Files | Refs (Tags) | README | LICENSE

gmni.scd (1980B)


      1 gmni(1)
      2 
      3 # NAME
      4 
      5 gmni - Gemini client
      6 
      7 # SYNPOSIS
      8 
      9 *gmni* [-46lLiIN] [-j _mode_] [-E _path_] [-d _input_] [-D _path_] _gemini://..._
     10 
     11 # DESCRIPTION
     12 
     13 *gmni* executes a gemini request and, if successful, prints the response body
     14 to stdout.
     15 
     16 If an error is returned, information is printed to stderr and the process exits
     17 with a non-zero exit status equal to the response status. If a response is
     18 returned which is neither successful or an error, the response status and meta
     19 text are printed to stderr.
     20 
     21 If the server requests user input, a prompt is shown and a second request is
     22 performed with the user's input supplied to the server.
     23 
     24 # OPTIONS
     25 
     26 *-4*
     27 	Force the connection to use IPv4.
     28 
     29 *-6*
     30 	Force the connection to use IPv6.
     31 
     32 *-d* _input_
     33 	If the server requests user input, a second request is performed with
     34 	the given input string as the user input.
     35 
     36 *-D* _path_
     37 	If the server requests user input, _path_ is opened and read, and a
     38 	second request is performed with the contents of _path_ as the user
     39 	input.
     40 
     41 *-E* _path_:_key_
     42 	Sets the path to the client certificate and private key file to use,
     43 	both PEM encoded.
     44 
     45 *-l*
     46 	For *text/\** responses, *gmni* normally adds a line feed if stdout is a
     47 	TTY and the response body does not include one. This flag suppresses
     48 	this behavior.
     49 
     50 *-L*
     51 	Follow redirects.
     52 
     53 *-j* _mode_
     54 	Sets the TOFU (trust on first use) configuration, which controls if the
     55 	client shall trust new certificates. _mode_ can be one of *always*,
     56 	*once*, or *fail*.
     57 
     58 *-i*
     59 	Print the response status and meta text to stdout.
     60 
     61 *-I*
     62 	Print the response status and meta text to stdout, and suppress the
     63 	printing of the response body to stdout.
     64 
     65 *-N*
     66 	Suppress the input prompt if the server requests an input, and instead
     67 	print a diagnostic message and exit with a zero (successful) status
     68 	code.
     69 
     70 *-o* _path_
     71 	Write output to _path_. If _path_ ends with a '/', the basename of the URL
     72 	will be appended. If _path_ is the empty string, "./" will be presumed.