From 66e99d09d4351bb6e6c5fd442f14ec7cf1363a81 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Thu, 18 May 2023 08:48:19 +0200 Subject: update man pages --- man/taler-merchant-httpd.1 | 48 +++++++++++++++++++++++----------------------- 1 file changed, 24 insertions(+), 24 deletions(-) (limited to 'man/taler-merchant-httpd.1') diff --git a/man/taler-merchant-httpd.1 b/man/taler-merchant-httpd.1 index d4b42393..c98090a6 100644 --- a/man/taler-merchant-httpd.1 +++ b/man/taler-merchant-httpd.1 @@ -1,8 +1,5 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-MERCHANT-HTTPD" "1" "Apr 16, 2023" "0.9" "GNU Taler" -.SH NAME -taler-merchant-httpd \- run Taler merchant backend (with RESTful API) . .nr rst2man-indent-level 0 . @@ -30,17 +27,20 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. +.TH "TALER-MERCHANT-HTTPD" "1" "May 18, 2023" "0.9" "GNU Taler" +.SH NAME +taler-merchant-httpd \- run Taler merchant backend (with RESTful API) .SH SYNOPSIS .sp \fBtaler\-merchant\-httpd\fP -[\fB\-a**_|_\fP\-\-auth**] -[\fB\-C\fP\ |\ \fB\-\-connection\-close\fP] -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP‌\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP‌\fIFILENAME\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-a**_|_\fP–auth**] +[\fB\-C\fP\ |\ \fB–connection\-close\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP‌\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP‌\fIFILENAME\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-httpd\fP is a command\-line tool to run the Taler merchant @@ -49,44 +49,44 @@ before running this command. .SH OPTIONS .INDENT 0.0 .TP -\fB\-a\fP \fITOKEN\fP | \fB\-\-auth=\fP\fITOKEN\fP -Use TOKEN for initial access control to the merchant backend. TOKEN must start with the "secret\-token:" prefix, as per RFC 8959. The value +\fB\-a\fP \fITOKEN\fP | \fB–auth=\fP\fITOKEN\fP +Use TOKEN for initial access control to the merchant backend. TOKEN must start with the “secret\-token:” prefix, as per RFC 8959. The value given in TOKEN must appear in backoffice requests to the default instance -of the merchant, i.e. "Authorization: Bearer TOKEN" to obtain +of the merchant, i.e. “Authorization: Bearer TOKEN” to obtain access to the merchant backend. Note that setting a passphrase for the default instance by any means will block future access via TOKEN. This is basically a way to reset the passphrase protecting access. TOKEN -should be a "pchar" as per RFC 8959, but this is NOT checked. Note that -TOKEN will only grant access to the \(aqdefault\(aq instance, not other instances. +should be a “pchar” as per RFC 8959, but this is NOT checked. Note that +TOKEN will only grant access to the ‘default’ instance, not other instances. Instead of using the command\-line, which exposes TOKEN to users on the system, you may want to consider setting the TALER_MERCHANT_TOKEN environment variable instead. .TP -\fB\-C\fP | \fB\-\-connection\-close\fP +\fB\-C\fP | \fB–connection\-close\fP Force each HTTP connection to be closed after each request (useful in combination with \-f to avoid having to wait for nc to time out). .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the merchant to operate from FILENAME. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP‌\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP‌\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP‌\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP‌\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-T\fP \fIUSEC\fP | \fB\-\-timetravel=\fP\fIUSEC\fP +\fB\-T\fP \fIUSEC\fP | \fB–timetravel=\fP\fIUSEC\fP Modify the system time by \fIUSEC\fP microseconds. \fIUSEC\fP may be prefixed with \fB+\fP or \fB\-\fP (e.g. \fB\-T +300\fP). This option is intended for debugging/testing only. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SIGNALS @@ -100,7 +100,7 @@ cleanly. .INDENT 0.0 .TP .B TALER_MERCHANT_TOKEN -Like the "\-a" option, resets the access token for the default +Like the “\-a” option, resets the access token for the default instance to the given value. .UNINDENT .SH SEE ALSO -- cgit v1.2.3