diff options
67 files changed, 1197 insertions, 1182 deletions
diff --git a/man/challenger-admin.1 b/man/challenger-admin.1 index 423d8c68..22a465af 100644 --- a/man/challenger-admin.1 +++ b/man/challenger-admin.1 @@ -27,20 +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 "CHALLENGER-ADMIN" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "CHALLENGER-ADMIN" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME challenger-admin \- manipulate list of authorized Challenger clients .SH SYNOPSIS .sp \fBchallenger\-admin\fP -[\fB\-a\fP \fICLIENT_SECRET\fP\ |\ \fB\-\-add=\fP\fICLIENT_SECRET\fP] -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-d\fP\ |\ \fB\-\-delete\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-log=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-q\fP\ |\ \fB\-\-quiet\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-a\fP \fICLIENT_SECRET\fP\ |\ \fB–add=\fP\fICLIENT_SECRET\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-d\fP\ |\ \fB–delete\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–log=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-q\fP\ |\ \fB–quiet\fP] +[\fB\-v\fP\ |\ \fB–version\fP] CLIENT_URL .SH DESCRIPTION .sp @@ -49,23 +49,23 @@ CLIENT_URL Its options are as follows: .INDENT 0.0 .TP -\fB\-a\fP \fISECRET\fP | \fB\-\-add=\fP\fISECRET\fP +\fB\-a\fP \fISECRET\fP | \fB–add=\fP\fISECRET\fP Add the client with the given \fICLIENT_URL setting the client secret to *SECRET\fP\&. Prints the CLIENT_ID of the added client. .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 Challenger commands to operate from \fIFILENAME\fP\&. .TP -\fB\-d\fP | \fB\-\-delete\fP +\fB\-d\fP | \fB–delete\fP Delete the client with the given \fICLIENT_URL\fP\&. .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\-\-log=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log=\fP\fILOGLEVEL\fP Configure logging to use \fILOGLEVEL\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Configure logging to write logs to \fIFILENAME\fP\&. .TP \fB\-q\fP | \fB–\-quiet\fP @@ -84,6 +84,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/challenger-config.1 b/man/challenger-config.1 index 35bfb3a0..50275c66 100644 --- a/man/challenger-config.1 +++ b/man/challenger-config.1 @@ -27,75 +27,75 @@ 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 "CHALLENGER-CONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "CHALLENGER-CONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME challenger-config \- manipulate Challenger configuration files .SH SYNOPSIS .sp \fBchallenger\-config\fP -[\fB\-b\fP\ \fIbackend\fP\ |\ \fB\-\-supported\-backend=\fP\fIbackend\fP] -[\fB\-c\fP\ \fIfilename\fP\ |\ \fB\-\-config=\fP\fIfilename\fP] -[\fB\-f\fP\ |\ \fB\-\-filename\fP] -[\fB\-F\fP\ |\ \fB\-\-full\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\-o\fP\ \fIoption\fP\ |\ \fB\-\-option=\fP\fIoption\fP] -[\fB\-r\fP\ |\ \fB\-\-rewrite\fP] -[\fB\-S\fP\ |\ \fB\-\-list\-sections\fP] -[\fB\-s\fP\ \fIsection\fP\ |\ \fB\-\-section=\fP\fIsection\fP] -[\fB\-V\fP\ \fIvalue\fP\ |\ \fB\-\-value=\fP\fIvalue\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-b\fP\ \fIbackend\fP\ |\ \fB–supported\-backend=\fP\fIbackend\fP] +[\fB\-c\fP\ \fIfilename\fP\ |\ \fB–config=\fP\fIfilename\fP] +[\fB\-f\fP\ |\ \fB–filename\fP] +[\fB\-F\fP\ |\ \fB–full\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\-o\fP\ \fIoption\fP\ |\ \fB–option=\fP\fIoption\fP] +[\fB\-r\fP\ |\ \fB–rewrite\fP] +[\fB\-S\fP\ |\ \fB–list\-sections\fP] +[\fB\-s\fP\ \fIsection\fP\ |\ \fB–section=\fP\fIsection\fP] +[\fB\-V\fP\ \fIvalue\fP\ |\ \fB–value=\fP\fIvalue\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBchallenger\-config\fP can be used to read or modify Challenger configuration files. .INDENT 0.0 .TP -\fB\-b\fP \fIBACKEND\fP | \fB\-\-supported\-backend=\fP\fIBACKEND\fP +\fB\-b\fP \fIBACKEND\fP | \fB–supported\-backend=\fP\fIBACKEND\fP Tests whether the specified \fIBACKEND\fP is supported by the current installation. -The backend must match the name of a plugin, i.e. \(dqnamestore_postgres\(dq for -the PostgreSQL database backend of the \(dqNAMESTORE\(dq service. If \fIBACKEND\fP is +The backend must match the name of a plugin, i.e. “namestore_postgres” for +the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is supported, challenger\-config will return a status code of 0 (success), otherwise 77 (unsupported). When this option is specified, no other options may be specified. Specifying this option together with other options will cause challenger\-config to return a status code of 1 (error). .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration file \fIFILENAME\fP\&. .TP -\fB\-f\fP | \fB\-\-filename\fP +\fB\-f\fP | \fB–filename\fP Try to perform expansions as if the option values represent filenames (will also be applied even if the option is not really a filename). .TP -\fB\-F\fP | \fB\-\-full\fP +\fB\-F\fP | \fB–full\fP Write the full configuration file, not just the differences to the defaults. .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 Use \fILOGLEVEL\fP for logging. Valid values are \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, and \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\-o\fP \fIOPTION\fP | \fB\-\-option=\fP\fIOPTION\fP +\fB\-o\fP \fIOPTION\fP | \fB–option=\fP\fIOPTION\fP Which configuration option should be accessed or edited. Required to set a value. If not given, all values of a given section will be printed in the -format \(dqOPTION = VALUE\(dq. +format “OPTION = VALUE”. .TP -\fB\-r\fP | \fB\-\-rewrite\fP +\fB\-r\fP | \fB–rewrite\fP Write the configuration file even if nothing changed. Will remove all comments! .TP -\fB\-S\fP | \fB\-\-list\-sections\fP +\fB\-S\fP | \fB–list\-sections\fP List available configuration sections for use with \fB\-\-section\fP\&. .TP -\fB\-s\fP \fISECTION\fP | \fB\-\-section=\fP\fISECTION\fP +\fB\-s\fP \fISECTION\fP | \fB–section=\fP\fISECTION\fP Which configuration section should be accessed or edited. Required option. .TP -\fB\-V\fP \fIVALUE\fP | \fB\-\-value=\fP\fIVALUE\fP +\fB\-V\fP \fIVALUE\fP | \fB–value=\fP\fIVALUE\fP Configuration value to store in the given section under the given option. Must only be given together with \fB\-s\fP and \fB\-o\fP options. .INDENT 7.0 @@ -105,7 +105,7 @@ Changing the configuration file with \fB\-V\fP will remove comments and may reorder sections and remove \fB@INLINE@\fP directives. .UNINDENT .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print GNU Taler version number. .UNINDENT .SH SEE ALSO @@ -118,6 +118,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/challenger-dbconfig.1 b/man/challenger-dbconfig.1 index 042580b1..67b97611 100644 --- a/man/challenger-dbconfig.1 +++ b/man/challenger-dbconfig.1 @@ -27,7 +27,7 @@ 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 "CHALLENGER-DBCONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "CHALLENGER-DBCONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME challenger-dbconfig \- configure challenger database .SH SYNOPSIS @@ -78,6 +78,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/challenger-dbinit.1 b/man/challenger-dbinit.1 index 41475318..c87b35cd 100644 --- a/man/challenger-dbinit.1 +++ b/man/challenger-dbinit.1 @@ -27,19 +27,19 @@ 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 "CHALLENGER-DBINIT" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "CHALLENGER-DBINIT" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME challenger-dbinit \- initialize the Challenger database .SH SYNOPSIS .sp \fBchallenger\-dbinit\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-g\fP\ |\ \fB\-\-garbagecollect\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-log=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-r\fP\ |\ \fB\-\-reset\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-g\fP\ |\ \fB–garbagecollect\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–log=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-r\fP\ |\ \fB–reset\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBchallenger\-dbinit\fP is a command\-line tool to initialize the Challenger database. @@ -47,23 +47,23 @@ challenger-dbinit \- initialize the Challenger database Its options are as follows: .INDENT 0.0 .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 Challenger commands to operate from \fIFILENAME\fP\&. .TP -\fB\-g\fP | \fB\-\-garbagecollect\fP +\fB\-g\fP | \fB–garbagecollect\fP Remove state data from database. .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\-\-log=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log=\fP\fILOGLEVEL\fP Configure logging to use \fILOGLEVEL\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Configure logging to write logs to \fIFILENAME\fP\&. .TP -\fB\-r\fP | \fB\-\-reset\fP +\fB\-r\fP | \fB–reset\fP Reset database. (\fBDANGEROUS\fP: All existing data is lost!) .TP \fB\-v\fP | \fB–version\fP @@ -79,6 +79,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/challenger-httpd.1 b/man/challenger-httpd.1 index d9a0b556..2cc1f345 100644 --- a/man/challenger-httpd.1 +++ b/man/challenger-httpd.1 @@ -27,18 +27,18 @@ 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 "CHALLENGER-HTTPD" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "CHALLENGER-HTTPD" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME challenger-httpd \- provide the Challenger HTTP interface .SH SYNOPSIS .sp \fBchallenger\-httpd\fP -[\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\-\-log=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\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–log=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBchallenger\-httpd\fP is a command\-line tool to provide the Challenger HTTP interface. @@ -46,20 +46,20 @@ challenger-httpd \- provide the Challenger HTTP interface Its options are as follows: .INDENT 0.0 .TP -\fB\-C\fP | \fB\-\-connection\-close\fP +\fB\-C\fP | \fB–connection\-close\fP Force HTTP connections to be closed after each request. .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 Challenger commands to operate from \fIFILENAME\fP\&. .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\-\-log=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log=\fP\fILOGLEVEL\fP Configure logging to use \fILOGLEVEL\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Configure logging to write logs to \fIFILENAME\fP\&. .TP \fB\-v\fP | \fB–version\fP @@ -75,6 +75,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/challenger.conf.5 b/man/challenger.conf.5 index 92b5d256..f895feb1 100644 --- a/man/challenger.conf.5 +++ b/man/challenger.conf.5 @@ -27,7 +27,7 @@ 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 "CHALLENGER.CONF" "5" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "CHALLENGER.CONF" "5" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME challenger.conf \- Challenger configuration file .SH DESCRIPTION @@ -162,7 +162,7 @@ Which command should we execute to transmit the challenge code to the address. T Type of the address that is being collected, returned as part of the \fBaddress_type\fP in the \fB/info\fP endpoint. Examples include \fBemail\fP or \fBphone\fP\&. .TP .B ADDRESS_RESTRICTIONS -JSON object with a map of keys (names of the fields of the address to be entered by the user) to objects with a \(dqregex\(dq (string) containing an extended Posix regular expression for allowed address field values, and a \(dqhint\(dq/\(dqhint_i18n\(dq giving a human\-readable explanation to display if the value entered by the user does not match the regex. Keys that are not mapped to such an object have no restriction on the value provided by the user. Examples would be \(aq{\(dqemail\(dq:{\(dqhint\(dq:\(dqvalid e\-mail address required\(dq,\(dqregex\(dq:\(dq^[a\-zA\-Z0\-9_.+\-]+@[a\-zA\-Z0\-9\-]+.[a\-zA\-Z0\-9\-.]+$\(dq}\(aq or \(aq{\(dqzip\(dq:{\(dqhint\(dq:\(dqnumeric zip code required\(dq,\(dqregex\(dq:\(dq^[0\-9]+$\(dq}\(aq. +JSON object with a map of keys (names of the fields of the address to be entered by the user) to objects with a “regex” (string) containing an extended Posix regular expression for allowed address field values, and a “hint”/”hint_i18n” giving a human\-readable explanation to display if the value entered by the user does not match the regex. Keys that are not mapped to such an object have no restriction on the value provided by the user. Examples would be ‘{“email”:{“hint”:”valid e\-mail address required”,”regex”:”^[a\-zA\-Z0\-9_.+\-]+@[a\-zA\-Z0\-9\-]+.[a\-zA\-Z0\-9\-.]+$”}’ or ‘{“zip”:{“hint”:”numeric zip code required”,”regex”:”^[0\-9]+$”}’. .UNINDENT .SH SEE ALSO .sp @@ -174,6 +174,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/libeufin-nexus.1 b/man/libeufin-nexus.1 index a4f0d2ac..93aab863 100644 --- a/man/libeufin-nexus.1 +++ b/man/libeufin-nexus.1 @@ -27,15 +27,15 @@ 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 "LIBEUFIN-NEXUS" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "LIBEUFIN-NEXUS" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME libeufin-nexus \- service to interface to various bank access APIs .SH SYNOPSIS .sp \fBlibeufin\-nexus\fP -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-\-version\fP] -COMMAND [ARGS...] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB–version\fP] +COMMAND [ARGS…] .sp Subcommands: \fBdbinit\fP, \fBebics\-setup\fP, \fBebics\-submit\fP, \fBebics\-fetch\fP, \fBconfig\fP .SH DESCRIPTION @@ -46,7 +46,7 @@ various bank access APIs Its options are as follows: .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP \fB–version\fP @@ -60,28 +60,28 @@ In order to operate any EBICS communication with \fBlibeufin\-nexus\fP, it is ne The following sections describe each command in detail. .SS ebics\-setup .sp -This command creates the client keys, if they aren\(aqt found already on the disk, and sends them to the bank if they were not sent yet. In case of sending, it ejects the PDF document that contains the keys fingerprints, so that the user can send it to the bank to confirm their keys. The process continues by checking if the bank keys exist already on disk, and proceeds with downloading them in case they are not. It checks then if the bank keys were accepted by the user; if yes, the setup terminates, otherwise it interactively asks the user to mark the keys as accepted. By accepting the bank keys, the setup terminates successfully. +This command creates the client keys, if they aren’t found already on the disk, and sends them to the bank if they were not sent yet. In case of sending, it ejects the PDF document that contains the keys fingerprints, so that the user can send it to the bank to confirm their keys. The process continues by checking if the bank keys exist already on disk, and proceeds with downloading them in case they are not. It checks then if the bank keys were accepted by the user; if yes, the setup terminates, otherwise it interactively asks the user to mark the keys as accepted. By accepting the bank keys, the setup terminates successfully. .sp Its options are as follows: .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. .TP -\fB\-\-force\-keys\-resubmission\fP +\fB–force\-keys\-resubmission\fP Resubmits the client keys. If no keys were found, it creates and submits them. .TP -\fB\-\-auto\-accept\-keys\fP +\fB–auto\-accept\-keys\fP Accepts the bank keys without interactively asking the user. .TP -\fB\-\-generate\-registration\-pdf\fP -Generates the PDF with the client keys fingerprints, if the keys have the submitted state. That\(aqs useful in case the PDF went lost after the first submission and the user needs a new PDF. +\fB–generate\-registration\-pdf\fP +Generates the PDF with the client keys fingerprints, if the keys have the submitted state. That’s useful in case the PDF went lost after the first submission and the user needs a new PDF. .UNINDENT .SS dbinit .sp @@ -90,16 +90,16 @@ This subcommand defines the database schema for Nexus. It is mandatory to run t Its options are as follows: .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. .TP -\fB\-r\fP | \fB\-\-reset\fP +\fB\-r\fP | \fB–reset\fP If present, deletes any database table (WARNING: potential data loss) .UNINDENT .SS ebics\-submit @@ -109,17 +109,17 @@ This subcommand submits any initiated payment that was not already sent to the b Its options are as follows: .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. Uploaded documents will be stored \fIbefore\fP being submitted to the bank. This directory would contain several directories, each named after the \fBYYYY\-MM\-DD/submit\fP format. The pain.001 file would then be named in the following schema: \fB$microseconds_pain.001.xml\fP\&. .TP -\fB\-\-transient\fP +\fB–transient\fP This flag, enabled by default, causes the command to check the database and submit only once, and then return. .UNINDENT .SS ebics\-fetch @@ -137,48 +137,48 @@ The files type can be given as an argument to select what will be fetched. If no .UNINDENT .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. .TP -\fB\-\-debug\-ebics\fP \fISAVEDIR\fP +\fB–debug\-ebics\fP \fISAVEDIR\fP Log EBICS content at SAVEDIR. Downloaded documents will be stored \fIbefore\fP being ingested in the database. This directory would contain several directories, each named after the \fBYYYY\-MM\-DD/fetch\fP format. The stored files would then be named after the following schema: \fB$microseconds_$filename\fP\&. Exception to this naming scheme are the HAC responses, since they do not get any filename assigned by the ZIP archive (they are sent unzipped). Their naming scheme is: \fB$microseconds_HAC_response.pain.002.xml\fP\&. .TP -\fB\-\-transient\fP +\fB–transient\fP This flag, enabled by default, causes the command to perform one download and return. .TP -\fB\-\-pinned\-start\fP -Only supported in \-\-transient mode, this option lets specify the earliest timestamp of the downloaded documents. The latest timestamp is always the current time. +\fB–pinned\-start\fP +Only supported in –transient mode, this option lets specify the earliest timestamp of the downloaded documents. The latest timestamp is always the current time. .UNINDENT .SS initiate\-payment .sp This subcommand initiates an outgoing payment. The pending payment is stored in the database and will be performed the next time \fBebics\-submit\fP run. .sp -It takes one argument, the creditor IBAN payto URI, which must contain a \(aqreceiver\-name\(aq and may contain an \(aqamount\(aq and a \(aqmessage\(aq if they have not been defined using CLI options. +It takes one argument, the creditor IBAN payto URI, which must contain a ‘receiver\-name’ and may contain an ‘amount’ and a ‘message’ if they have not been defined using CLI options. .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. .TP -\fB\-\-amount\fP \fIAMOUNT\fP -The amount to transfer, payto \(aqamount\(aq parameter takes the precedence +\fB–amount\fP \fIAMOUNT\fP +The amount to transfer, payto ‘amount’ parameter takes the precedence .TP -\fB\-\-subject\fP \fITEXT\fP -The payment subject, payto \(aqmessage\(aq parameter takes the precedence +\fB–subject\fP \fITEXT\fP +The payment subject, payto ‘message’ parameter takes the precedence .TP -\fB\-\-request\-uid\fP \fITEXT\fP +\fB–request\-uid\fP \fITEXT\fP The payment request UID, will be randomly generated if missing. .UNINDENT .SS config @@ -186,7 +186,7 @@ The payment request UID, will be randomly generated if missing. This command inspect or change the configuration. .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .UNINDENT .sp @@ -198,16 +198,16 @@ This command lookup config value. It takes two arguments, the section name and the option name .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. .TP -\fB\-f\fP | \fB\-\-filename\fP +\fB\-f\fP | \fB–filename\fP Interpret value as path with dollar\-expansion. .UNINDENT .SS config dump @@ -215,13 +215,13 @@ Interpret value as path with dollar\-expansion. This command dump the configuration. .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. .UNINDENT .SS config pathsub @@ -231,13 +231,13 @@ This command substitute variables in a path. It takes one argument, a path expression. .INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +\fB\-c\fP | \fB–config\fP \fIFILENAME\fP Specifies the configuration file. .TP -\fB\-L\fP | \fB\-\-log\fP \fILOGLEVEL\fP +\fB\-L\fP | \fB–log\fP \fILOGLEVEL\fP Configure logging to use LOGLEVEL. .UNINDENT .SH SEE ALSO @@ -249,6 +249,6 @@ Report bugs by using \fI\%https://bugs.taler.net\fP or by sending electronic mai .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/libeufin-nexus.conf.5 b/man/libeufin-nexus.conf.5 index 51ea5f4c..a93b8524 100644 --- a/man/libeufin-nexus.conf.5 +++ b/man/libeufin-nexus.conf.5 @@ -27,7 +27,7 @@ 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 "LIBEUFIN-NEXUS.CONF" "5" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "LIBEUFIN-NEXUS.CONF" "5" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME libeufin-nexus.conf \- LibEuFin Nexus configuration file .SH DESCRIPTION @@ -49,7 +49,7 @@ escape characters in such strings; all characters between the double quotes (including other double quotes) are taken verbatim. .sp Durations must be expressed with a number followed by the time unit. The following -time units are supported: \(aqs\(aq (seconds), \(aqm\(aq (minutes), \(aqh\(aq (hours). For example, +time units are supported: ‘s’ (seconds), ‘m’ (minutes), ‘h’ (hours). For example, the value \fI5m\fP denotes a duration of \fIfive minutes\fP\&. .sp Values that represent filenames can begin with a \fB/bin/sh\fP\-like variable @@ -150,7 +150,7 @@ URL of the EBICS server .B BANK_DIALECT Name of the following combination: EBICS version and ISO20022 recommendations that Nexus would honor in the communication with the bank. Currently only the -\(aqpostfinance\(aq value is supported. +‘postfinance’ value is supported. .TP .B HOST_ID EBICS specific: name of the EBICS host @@ -195,6 +195,9 @@ The following configuration value(s) belong to the “[nexus\-fetch]” section. .B FREQUENCY Duration value to instruct the \fBebics\-fetch\fP subcommand how often it should download from the bank. +.TP +.B IGNORE_TRANSACTIONS_BEFORE +Ignore all transactions before a certain YYYY\-MM\-DD date, useful when you want to use an existing account with old transactions that should not be bounced. .UNINDENT .SS DATABASE OPTIONS .sp @@ -217,6 +220,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/sync-config.1 b/man/sync-config.1 index fce36b53..dd99d519 100644 --- a/man/sync-config.1 +++ b/man/sync-config.1 @@ -27,75 +27,75 @@ 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 "SYNC-CONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "SYNC-CONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME sync-config \- manipulate Sync configuration files .SH SYNOPSIS .sp \fBsync\-config\fP -[\fB\-b\fP\ \fIbackend\fP\ |\ \fB\-\-supported\-backend=\fP\fIbackend\fP] -[\fB\-c\fP\ \fIfilename\fP\ |\ \fB\-\-config=\fP\fIfilename\fP] -[\fB\-f\fP\ |\ \fB\-\-filename\fP] -[\fB\-F\fP\ |\ \fB\-\-full\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\-o\fP\ \fIoption\fP\ |\ \fB\-\-option=\fP\fIoption\fP] -[\fB\-r\fP\ |\ \fB\-\-rewrite\fP] -[\fB\-S\fP\ |\ \fB\-\-list\-sections\fP] -[\fB\-s\fP\ \fIsection\fP\ |\ \fB\-\-section=\fP\fIsection\fP] -[\fB\-V\fP\ \fIvalue\fP\ |\ \fB\-\-value=\fP\fIvalue\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-b\fP\ \fIbackend\fP\ |\ \fB–supported\-backend=\fP\fIbackend\fP] +[\fB\-c\fP\ \fIfilename\fP\ |\ \fB–config=\fP\fIfilename\fP] +[\fB\-f\fP\ |\ \fB–filename\fP] +[\fB\-F\fP\ |\ \fB–full\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\-o\fP\ \fIoption\fP\ |\ \fB–option=\fP\fIoption\fP] +[\fB\-r\fP\ |\ \fB–rewrite\fP] +[\fB\-S\fP\ |\ \fB–list\-sections\fP] +[\fB\-s\fP\ \fIsection\fP\ |\ \fB–section=\fP\fIsection\fP] +[\fB\-V\fP\ \fIvalue\fP\ |\ \fB–value=\fP\fIvalue\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBsync\-config\fP can be used to read or modify Sync configuration files. .INDENT 0.0 .TP -\fB\-b\fP \fIBACKEND\fP | \fB\-\-supported\-backend=\fP\fIBACKEND\fP +\fB\-b\fP \fIBACKEND\fP | \fB–supported\-backend=\fP\fIBACKEND\fP Tests whether the specified \fIBACKEND\fP is supported by the current installation. -The backend must match the name of a plugin, i.e. \(dqnamestore_postgres\(dq for -the PostgreSQL database backend of the \(dqNAMESTORE\(dq service. If \fIBACKEND\fP is +The backend must match the name of a plugin, i.e. “namestore_postgres” for +the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is supported, sync\-config will return a status code of 0 (success), otherwise 77 (unsupported). When this option is specified, no other options may be specified. Specifying this option together with other options will cause sync\-config to return a status code of 1 (error). .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration file \fIFILENAME\fP\&. .TP -\fB\-f\fP | \fB\-\-filename\fP +\fB\-f\fP | \fB–filename\fP Try to perform expansions as if the option values represent filenames (will also be applied even if the option is not really a filename). .TP -\fB\-F\fP | \fB\-\-full\fP +\fB\-F\fP | \fB–full\fP Write the full configuration file, not just the differences to the defaults. .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 Use \fILOGLEVEL\fP for logging. Valid values are \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, and \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\-o\fP \fIOPTION\fP | \fB\-\-option=\fP\fIOPTION\fP +\fB\-o\fP \fIOPTION\fP | \fB–option=\fP\fIOPTION\fP Which configuration option should be accessed or edited. Required to set a value. If not given, all values of a given section will be printed in the -format \(dqOPTION = VALUE\(dq. +format “OPTION = VALUE”. .TP -\fB\-r\fP | \fB\-\-rewrite\fP +\fB\-r\fP | \fB–rewrite\fP Write the configuration file even if nothing changed. Will remove all comments! .TP -\fB\-S\fP | \fB\-\-list\-sections\fP +\fB\-S\fP | \fB–list\-sections\fP List available configuration sections for use with \fB\-\-section\fP\&. .TP -\fB\-s\fP \fISECTION\fP | \fB\-\-section=\fP\fISECTION\fP +\fB\-s\fP \fISECTION\fP | \fB–section=\fP\fISECTION\fP Which configuration section should be accessed or edited. Required option. .TP -\fB\-V\fP \fIVALUE\fP | \fB\-\-value=\fP\fIVALUE\fP +\fB\-V\fP \fIVALUE\fP | \fB–value=\fP\fIVALUE\fP Configuration value to store in the given section under the given option. Must only be given together with \fB\-s\fP and \fB\-o\fP options. .INDENT 7.0 @@ -105,7 +105,7 @@ Changing the configuration file with \fB\-V\fP will remove comments and may reorder sections and remove \fB@INLINE@\fP directives. .UNINDENT .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print GNU Taler version number. .UNINDENT .SH SEE ALSO @@ -118,6 +118,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/sync-dbconfig.1 b/man/sync-dbconfig.1 index 2fb51b91..6d06034f 100644 --- a/man/sync-dbconfig.1 +++ b/man/sync-dbconfig.1 @@ -27,7 +27,7 @@ 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 "SYNC-DBCONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "SYNC-DBCONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME sync-dbconfig \- configure sync database .SH SYNOPSIS @@ -78,6 +78,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/sync-dbinit.1 b/man/sync-dbinit.1 index 6f34f31d..7db7d856 100644 --- a/man/sync-dbinit.1 +++ b/man/sync-dbinit.1 @@ -27,19 +27,19 @@ 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 "SYNC-DBINIT" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "SYNC-DBINIT" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME sync-dbinit \- initialize the Sync database .SH SYNOPSIS .sp \fBsync\-dbinit\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-g\fP\ |\ \fB\-\-garbagecollect\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-log=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-r\fP\ |\ \fB\-\-reset\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-g\fP\ |\ \fB–garbagecollect\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–log=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-r\fP\ |\ \fB–reset\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBsync\-dbinit\fP is a command\-line tool to initialize the Sync database. @@ -47,23 +47,23 @@ sync-dbinit \- initialize the Sync database Its options are as follows: .INDENT 0.0 .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 Sync commands to operate from \fIFILENAME\fP\&. .TP -\fB\-g\fP | \fB\-\-garbagecollect\fP +\fB\-g\fP | \fB–garbagecollect\fP Remove state data from database. .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\-\-log=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log=\fP\fILOGLEVEL\fP Configure logging to use \fILOGLEVEL\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Configure logging to write logs to \fIFILENAME\fP\&. .TP -\fB\-r\fP | \fB\-\-reset\fP +\fB\-r\fP | \fB–reset\fP Reset database. (\fBDANGEROUS\fP: All existing data is lost!) .TP \fB\-v\fP | \fB–version\fP @@ -79,6 +79,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/sync-httpd.1 b/man/sync-httpd.1 index eed1cfa4..ea47b170 100644 --- a/man/sync-httpd.1 +++ b/man/sync-httpd.1 @@ -27,22 +27,22 @@ 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 "SYNC-HTTPD" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "SYNC-HTTPD" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME sync-httpd \- provide the Sync HTTP interface .SH SYNOPSIS .sp \fBsync\-httpd\fP -[\fB\-A\fP\ \fIUSERNAME:PASSWORD\fP\ |\ \fB\-\-auth=\fP\fIUSERNAME:PASSWORD\fP] -[\fB\-C\fP\ |\ \fB\-\-connection\-close\fP] -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-k\fP\ \fIKEYFILE\fP\ |\ \fB\-\-key=\fP\fIKEYFILE\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-log=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-p\fP\ \fIKEYFILEPASSPHRASE\fP\ |\ \fB\-\-pass=\fP\fIKEYFILEPASSPHRASE\fP] -[\fB\-t\fP\ \fICERTTYPE\fP\ |\ \fB\-\-type=\fP\fICERTTYPE\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-A\fP\ \fIUSERNAME:PASSWORD\fP\ |\ \fB–auth=\fP\fIUSERNAME:PASSWORD\fP] +[\fB\-C\fP\ |\ \fB–connection\-close\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-k\fP\ \fIKEYFILE\fP\ |\ \fB–key=\fP\fIKEYFILE\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–log=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-p\fP\ \fIKEYFILEPASSPHRASE\fP\ |\ \fB–pass=\fP\fIKEYFILEPASSPHRASE\fP] +[\fB\-t\fP\ \fICERTTYPE\fP\ |\ \fB–type=\fP\fICERTTYPE\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBsync\-httpd\fP is a command\-line tool to provide the Sync HTTP interface. @@ -50,32 +50,32 @@ sync-httpd \- provide the Sync HTTP interface Its options are as follows: .INDENT 0.0 .TP -\fB\-A\fP \fIUSERNAME:PASSWORD\fP | \fB\-\-auth=\fP\fIUSERNAME:PASSWORD\fP +\fB\-A\fP \fIUSERNAME:PASSWORD\fP | \fB–auth=\fP\fIUSERNAME:PASSWORD\fP Use the given \fIUSERNAME\fP and \fIPASSWORD\fP for client authentication. .TP -\fB\-C\fP | \fB\-\-connection\-close\fP +\fB\-C\fP | \fB–connection\-close\fP Force HTTP connections to be closed after each request. .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 Sync commands to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-k\fP \fIKEYFILE\fP | \fB\-\-key=\fP\fIKEYFILE\fP +\fB\-k\fP \fIKEYFILE\fP | \fB–key=\fP\fIKEYFILE\fP Consult \fIKEYFILE\fP for the private TLS key for TLS client authentication. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-log=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log=\fP\fILOGLEVEL\fP Configure logging to use \fILOGLEVEL\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Configure logging to write logs to \fIFILENAME\fP\&. .TP -\fB\-p\fP \fIKEYFILEPASSPHRASE\fP | \fB\-\-pass=\fP\fIKEYFILEPASSPHRASE\fP +\fB\-p\fP \fIKEYFILEPASSPHRASE\fP | \fB–pass=\fP\fIKEYFILEPASSPHRASE\fP Use \fIKEYFILEPASSPHRASE\fP to decrypt the TLS client private key file. .TP -\fB\-t\fP \fICERTTYPE\fP | \fB\-\-type=\fP\fICERTTYPE\fP +\fB\-t\fP \fICERTTYPE\fP | \fB–type=\fP\fICERTTYPE\fP Use \fICERTTYPE\fP as the type of the TLS client certificate. If unspecified, defaults to PEM. .TP @@ -92,6 +92,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/sync.conf.5 b/man/sync.conf.5 index bf56c33b..c1d3e318 100644 --- a/man/sync.conf.5 +++ b/man/sync.conf.5 @@ -27,7 +27,7 @@ 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 "SYNC.CONF" "5" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "SYNC.CONF" "5" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME sync.conf \- Sync configuration file .SH DESCRIPTION @@ -178,6 +178,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-aggregator-benchmark.1 b/man/taler-aggregator-benchmark.1 index 5f7d8a0b..ee744c30 100644 --- a/man/taler-aggregator-benchmark.1 +++ b/man/taler-aggregator-benchmark.1 @@ -27,20 +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-AGGREGATOR-BENCHMARK" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AGGREGATOR-BENCHMARK" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-aggregator-benchmark \- generate database to measure aggregator performance .SH SYNOPSIS .sp \fBtaler\-aggregator\-benchmark\fP -[\fB\-c\fP\ \fICONFIG_FILENAME\fP\ |\ \fB\-\-config=\fP\fICONFIG_FILENAME\fP] -[\fB\-d\fP\ \fIDN\fP\ |\ \fB\-\-deposits=\fP\fIDN\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-log\-level=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIDM\fP\ |\ \fB\-\-merchants=\fP\fIDM\fP] -[\fB\-r\fP\ \fIRATE\fP\ |\ \fB\-\-refunds=\fP\fIRATE\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fICONFIG_FILENAME\fP\ |\ \fB–config=\fP\fICONFIG_FILENAME\fP] +[\fB\-d\fP\ \fIDN\fP\ |\ \fB–deposits=\fP\fIDN\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–log\-level=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIDM\fP\ |\ \fB–merchants=\fP\fIDM\fP] +[\fB\-r\fP\ \fIRATE\fP\ |\ \fB–refunds=\fP\fIRATE\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-aggregator\-benchmark\fP is a command\-line tool to fill an exchange @@ -51,30 +51,30 @@ starting multiple \fBtaler\-exchange\-aggregator\fP processes) and instead only prepares the database with synthetic work. .INDENT 0.0 .TP -\fB\-c\fP \fICONFIG_FILENAME\fP | \fB\-\-config=\fP\fICONFIG_FILENAME\fP +\fB\-c\fP \fICONFIG_FILENAME\fP | \fB–config=\fP\fICONFIG_FILENAME\fP (Mandatory) Use CONFIG_FILENAME as the name for the configuration file. .TP -\fB\-d\fP \fIDN\fP | \fB\-\-deposits=\fP\fIDN\fP +\fB\-d\fP \fIDN\fP | \fB–deposits=\fP\fIDN\fP How many deposits should be instantiated \fIper merchant\fP\&. Defaults to 1. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Prints a compiled\-in help text. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-log\-level=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log\-level=\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\-m\fP \fIDM\fP | \fB\-\-merchants=\fP\fIDM\fP +\fB\-m\fP \fIDM\fP | \fB–merchants=\fP\fIDM\fP How many different merchants should we create. Defaults to 1. .TP -\fB\-r\fP \fIRATE\fP | \fB\-\-refunds=\fP\fIRATE\fP +\fB\-r\fP \fIRATE\fP | \fB–refunds=\fP\fIRATE\fP Probability of a deposit having a refund (as an integer between 0\-100). .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -88,6 +88,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-auditor-dbconfig.1 b/man/taler-auditor-dbconfig.1 index ae0f67c0..2918932d 100644 --- a/man/taler-auditor-dbconfig.1 +++ b/man/taler-auditor-dbconfig.1 @@ -27,7 +27,7 @@ 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-AUDITOR-DBCONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-DBCONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor-dbconfig \- configure Taler auditor database .SH SYNOPSIS @@ -78,6 +78,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-auditor-dbinit.1 b/man/taler-auditor-dbinit.1 index 69ffbb3e..f2193ff0 100644 --- a/man/taler-auditor-dbinit.1 +++ b/man/taler-auditor-dbinit.1 @@ -27,20 +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-AUDITOR-DBINIT" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-DBINIT" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor-dbinit \- setup auditor database .SH SYNOPSIS .sp \fBtaler\-auditor\-dbinit\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-g\fP\ |\ \fB\-\-gc\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\-R\fP\ |\ \fB\-\-reset\fP] -[\fB\-r\fP\ |\ \fB\-\-restart\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-g\fP\ |\ \fB–gc\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\-R\fP\ |\ \fB–reset\fP] +[\fB\-r\fP\ |\ \fB–restart\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-dbinit\fP is a command\-line tool to initialize the Taler @@ -50,32 +50,32 @@ Taler exchange to operate. Its options are as follows: .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .TP -\fB\-g\fP | \fB\-\-gc\fP +\fB\-g\fP | \fB–gc\fP Garbage collect database. Deletes all unnecessary data in the database. .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\-R\fP | \fB\-\-reset\fP +\fB\-R\fP | \fB–reset\fP Drop tables. Dangerous, will delete all existing data in the database. .TP -\fB\-r\fP | \fB\-\-restart\fP +\fB\-r\fP | \fB–restart\fP Restart all auditors from the beginning. Useful for testing. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -88,6 +88,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-auditor-exchange.1 b/man/taler-auditor-exchange.1 index b1438c8c..f1fd1c66 100644 --- a/man/taler-auditor-exchange.1 +++ b/man/taler-auditor-exchange.1 @@ -27,18 +27,18 @@ 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-AUDITOR-EXCHANGE" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-EXCHANGE" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor-exchange \- add or remove exchange from auditor’s list .SH SYNOPSIS .sp \fBtaler\-auditor\-exchange\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-m\fP\ \fIMASTERKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIMASTERKEY\fP] -[\fB\-r\fP\ |\ \fB\-\-remove\fP] -[\fB\-u\fP\ \fIEXCHANGE_URL\fP\ |\ \fB\-\-auditor\-url=\fP\fIEXCHANGE_URL\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-m\fP\ \fIMASTERKEY\fP\ |\ \fB–exchange\-key=\fP\fIMASTERKEY\fP] +[\fB\-r\fP\ |\ \fB–remove\fP] +[\fB\-u\fP\ \fIEXCHANGE_URL\fP\ |\ \fB–auditor\-url=\fP\fIEXCHANGE_URL\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-auditor\-exchange\fP is a command\-line tool to be used by an @@ -49,27 +49,27 @@ taler\-auditor or taler\-wire\-auditor. Afterwards the exchange will be visible via the /exchanges API of the taler\-auditor\-httpd. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-m\fP \fIMASTERKEY\fP | \fB\-\-exchange\-key=\fP\fIMASTERKEY\fP +\fB\-m\fP \fIMASTERKEY\fP | \fB–exchange\-key=\fP\fIMASTERKEY\fP Public key of the exchange in Crockford base32 encoding, for example as generated by \fBtaler\-auditor\-offline setup\fP\&. .TP -\fB\-r\fP | \fB\-\-remove\fP +\fB\-r\fP | \fB–remove\fP Instead of adding the exchange, remove it. Note that this will drop ALL data associated with that exchange, including existing auditing information. So use with extreme care! .TP -\fB\-u\fP \fIEXCHANGE_URL\fP | \fB\-\-auditor\-url=\fP\fIEXCHANGE_URL\fP +\fB\-u\fP \fIEXCHANGE_URL\fP | \fB–auditor\-url=\fP\fIEXCHANGE_URL\fP URL of the exchange. The exchange’s HTTP API must be available at this address. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH DIAGNOSTICS @@ -92,6 +92,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-auditor-httpd.1 b/man/taler-auditor-httpd.1 index 389830f7..68b96f58 100644 --- a/man/taler-auditor-httpd.1 +++ b/man/taler-auditor-httpd.1 @@ -27,19 +27,19 @@ 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-AUDITOR-HTTPD" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-HTTPD" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor-httpd \- HTTP server providing a RESTful API to access a Taler auditor .SH SYNOPSIS .sp \fBtaler\-auditor\-httpd\fP -[\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\ \fISECONDS\fP\ |\ \fB\-\-timeout\fP\fISECONDS\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\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\ \fISECONDS\fP\ |\ \fB–timeout\fP\fISECONDS\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-auditor\-httpd\fP is a command\-line tool to run the Taler auditor @@ -48,30 +48,30 @@ before running this command. .SH OPTIONS .INDENT 0.0 .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 auditor 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 \fISECONDS\fP | \fB\-\-timeout=\fP\fISECONDS\fP +\fB\-t\fP \fISECONDS\fP | \fB–timeout=\fP\fISECONDS\fP Specifies the number of \fISECONDS\fP after which the HTTPD should close (idle) HTTP connections. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SIGNALS @@ -91,6 +91,6 @@ electronic mail to <\fI\%taler@gnu.org\fP> .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-auditor-offline.1 b/man/taler-auditor-offline.1 index 47bb6712..d73d2a32 100644 --- a/man/taler-auditor-offline.1 +++ b/man/taler-auditor-offline.1 @@ -27,18 +27,18 @@ 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-AUDITOR-OFFLINE" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-OFFLINE" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor-offline \- Taler auditor certifies that it audits a Taler exchange .SH SYNOPSIS .sp \fBtaler\-auditor\-offline\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\-v\fP\ |\ \fB\-\-version\fP] -[subcommand ...] +[\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\-v\fP\ |\ \fB–version\fP] +[subcommand …] .SH DESCRIPTION .sp \fBtaler\-auditor\-offline\fP is a command\-line tool to be used by an auditor to @@ -47,7 +47,7 @@ signature, the auditor affirms that he will verify that the exchange is properly accounting for coins of those denominations. The tool takes a list of subcommands as arguments which are then processed sequentially. .sp -The tool includes two subcommands to interact \fIonline\fP with the exchange\(aqs +The tool includes two subcommands to interact \fIonline\fP with the exchange’s REST APIs. The \fBdownload\fP subcommand downloads current public keys from the running exchange. Note that this only includes keys that the exchange operator has previously validated using the \fBtaler\-exchange\-offline\fP tool. @@ -55,10 +55,10 @@ The resulting data serves as input to the \fBsign\fP and \fBshow\fP subcommands. .sp The \fBupload\fP subcommand uploads the signatures created with the private key to the exchange. It handles the output of all subcommands (except \fBdownload\fP). -The \fBdownload\fP and \fBupload\fP subcommands must naturally be run \(dqonline\(dq and do not -require access to the auditor\(aqs private key, which should be kept offline. +The \fBdownload\fP and \fBupload\fP subcommands must naturally be run “online” and do not +require access to the auditor’s private key, which should be kept offline. .sp -All other subcommands are intended to be run \(dqoffline\(dq. However, especially +All other subcommands are intended to be run “offline”. However, especially when testing, it is of course possible to run the subcommands online as well. Generally, subcommands read inputs (beyond command\-line arguments) from \fBstdin\fP\&. However, they may also consume outputs of previous @@ -68,28 +68,28 @@ and if not consumed the final output is printed to \fBstdout\fP\&. The general options for \fBtaler\-auditor\-offline\fP are: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH CONFIGURATION .sp The exchange and the \fBtaler\-auditor\-httpd\fP must both be provided with -the auditor\(aqs public key, such that they can validate messages signed -by the auditor. To obtain the auditor\(aqs public key, use: +the auditor’s public key, such that they can validate messages signed +by the auditor. To obtain the auditor’s public key, use: .INDENT 0.0 .INDENT 3.5 .sp @@ -102,13 +102,13 @@ $ taler\-auditor\-offline setup .UNINDENT .sp Note that if the private key file already exists, the above will simply output -the existing key. Passing additional arguments after setup (including \(dq\-\(dq) +the existing key. Passing additional arguments after setup (including “\-“) will cause the output to be encapsulated in JSON. .sp Relevant configuration options for \fBtaler\-auditor\-offline\fP are: .INDENT 0.0 .IP \(bu 2 -\fB[auditor/AUDITOR_PRIV_FILE]\fP \-\-\- where to store the private key +\fB[auditor/AUDITOR_PRIV_FILE]\fP — where to store the private key .UNINDENT .SH SUBCOMMANDS .SS setup @@ -233,6 +233,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-auditor-sync.1 b/man/taler-auditor-sync.1 index 44ff5694..55a33fb2 100644 --- a/man/taler-auditor-sync.1 +++ b/man/taler-auditor-sync.1 @@ -27,23 +27,23 @@ 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-AUDITOR-SYNC" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-SYNC" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor-sync \- tool to safely synchronize auditor database .SH SYNOPSIS .sp \fBtaler\-auditor\-sync\fP -[\fB\-s\fP\ \fIFILENAME\fP\ |\ \fB\-\-source\-configuration=\fP\fIFILENAME\fP] -[\fB\-d\fP\ \fIFILENAME\fP\ |\ \fB\-\-destination\-configuration=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-b\fP\ \fISIZE\fP\ |\ \fB\-\-batch=\fP\fISIZE\fP] -[\fB\-t\fP\ |\ \fB\-\-terminate\-when\-synchronized\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] +[\fB\-s\fP\ \fIFILENAME\fP\ |\ \fB–source\-configuration=\fP\fIFILENAME\fP] +[\fB\-d\fP\ \fIFILENAME\fP\ |\ \fB–destination\-configuration=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-b\fP\ \fISIZE\fP\ |\ \fB–batch=\fP\fISIZE\fP] +[\fB\-t\fP\ |\ \fB–terminate\-when\-synchronized\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] .SH DESCRIPTION .sp \fBtaler\-auditor\-sync\fP is a command\-line tool to synchronize the -Taler auditor\(aqs database in a safe way from a Taler exchange +Taler auditor’s database in a safe way from a Taler exchange database. If the exchange database violates the assumed database invariants (as expressed by database constraints) or attempts to DELETE or UPDATE tables (at least those that the auditor relies @@ -53,31 +53,31 @@ and instead halt with an error. Its options are as follows: .INDENT 0.0 .TP -\fB\-s\fP \fIFILENAME\fP | \fB\-\-source\-configuration=\fP\fIFILENAME\fP +\fB\-s\fP \fIFILENAME\fP | \fB–source\-configuration=\fP\fIFILENAME\fP Use the configuration in \fIFILENAME\fP to access the original (source) exchange database to copy records from. .TP -\fB\-d\fP \fIFILENAME\fP | \fB\-\-destination\-configuration=\fP\fIFILENAME\fP +\fB\-d\fP \fIFILENAME\fP | \fB–destination\-configuration=\fP\fIFILENAME\fP Use the configuration in \fIFILENAME\fP to access the target (destination) exchange database to copy records to. .TP -\fB\-t\fP | \fB\-\-terminate\-when\-synchronized\fP +\fB\-t\fP | \fB–terminate\-when\-synchronized\fP The program should exit once the two databases are in sync, instead of continuously copying more records when the source database is updated. .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\-b\fP \fISIZE\fP | \fB\-\-batch=\fP\fISIZE\fP +\fB\-b\fP \fISIZE\fP | \fB–batch=\fP\fISIZE\fP Target number of records to copy in one transaction. Once the databases are in sync, the batch size is used to determine how long the process sleeps before trying to again synchronize the two databases. Not useful if \fB\-t\fP is used. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -90,6 +90,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-auditor.1 b/man/taler-auditor.1 index 15ce797a..89903a2e 100644 --- a/man/taler-auditor.1 +++ b/man/taler-auditor.1 @@ -27,21 +27,21 @@ 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-AUDITOR" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-AUDITOR" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor \- audit exchange .SH SYNOPSIS .sp \fBtaler\-auditor\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-i**_|_\fP\-\-internal**] -[\fB\-I**_|_\fP\-\-ignore\-not\-found**] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIMASTER_KEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIMASTER_KEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-i**_|_\fP–internal**] +[\fB\-I**_|_\fP–ignore\-not\-found**] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIMASTER_KEY\fP\ |\ \fB–exchange\-key=\fP\fIMASTER_KEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-auditor\fP is a command\-line tool to be used by an auditor to @@ -55,40 +55,40 @@ incoming and outgoing wire transfers that the bank claims to have matches the exchange’s database. Its options are as follows. .INDENT 0.0 .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 \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Run additional checks that can only performed on the exchange\-internal -database and not the \(dqsafe\(dq replicated database at the auditor. +database and not the “safe” replicated database at the auditor. .TP -\fB\-I\fP | \fB\-\-ignore\-not\-found\fP +\fB\-I\fP | \fB–ignore\-not\-found\fP Do not fail if the bank says that the exchange bank account does not (yet) exist. Keep trying. .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\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Public master key of the exchange in Crockford base32 encoding, for example as generated by \fBtaler\-auditor\-offline setup\fP\&. If this option is missing, taler\-auditor will use the MASTER_PUBLIC_KEY value from the “exchange” section of the configuration. .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 SEE ALSO @@ -101,6 +101,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-bank-benchmark.1 b/man/taler-bank-benchmark.1 index 072b6c9d..9bf26087 100644 --- a/man/taler-bank-benchmark.1 +++ b/man/taler-bank-benchmark.1 @@ -27,68 +27,68 @@ 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-BANK-BENCHMARK" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-BANK-BENCHMARK" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-bank-benchmark \- measure bank performance .SH SYNOPSIS .sp \fBtaler\-bank\-benchmark\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-f\fP\ |\ \fB\-\-fakebank\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\-p\fP\ \fINPROCS\fP\ |\ \fB\-\-worker\-parallelism=\fP\fINPROCS\fP] -[\fB\-r\fP\ \fINRESERVES\fP\ |\ \fB\-\-reserves=\fP\fINRESERVES\fP] -[\fB\-u\fP\ \fISECTION\fP\ |\ \fB\-\-exchange\-account\-section=\fP\fISECTION\fP] -[\fB\-V\fP\ |\ \fB\-\-verbose\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[\fB\-w**_*NPROC*\ |\ **\-\-wirewatch=\fP\fINPROC\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-f\fP\ |\ \fB–fakebank\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\-p\fP\ \fINPROCS\fP\ |\ \fB–worker\-parallelism=\fP\fINPROCS\fP] +[\fB\-r\fP\ \fINRESERVES\fP\ |\ \fB–reserves=\fP\fINRESERVES\fP] +[\fB\-u\fP\ \fISECTION\fP\ |\ \fB–exchange\-account\-section=\fP\fISECTION\fP] +[\fB\-V\fP\ |\ \fB–verbose\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[\fB\-w**_*NPROC*\ |\ **–wirewatch=\fP\fINPROC\fP] .SH DESCRIPTION .sp -\fBtaler\-bank\-benchmark\fP is a command\-line tool to benchmark only the \(dqbank\(dq +\fBtaler\-bank\-benchmark\fP is a command\-line tool to benchmark only the “bank” and the \fBtaler\-exchange\-wirewatch\fP tool. .sp The options for \fBtaler\-bank\-benchmark\fP are: .INDENT 0.0 .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 \fIFILENAME\fP\&. .TP -\fB\-f\fP | \fB\-\-fakebank\fP +\fB\-f\fP | \fB–fakebank\fP Expect to be run against a fakebank (instead of against libeufin) .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\-m\fP \fIMODE\fP | \fB\-\-mode=\fP\fIMODE\fP +\fB\-m\fP \fIMODE\fP | \fB–mode=\fP\fIMODE\fP Run as \fBbank\fP, \fBclient\fP or \fBboth\fP\&. If unspecified, \fIMODE\fP defaults to \fBboth\fP\&. .TP -\fB\-p\fP \fINPROCS\fP | \fB\-\-worker\-parallelism=\fP\fINPROCS\fP +\fB\-p\fP \fINPROCS\fP | \fB–worker\-parallelism=\fP\fINPROCS\fP Run with \fINPROCS\fP client processes. .TP -\fB\-r\fP \fINRESERVES\fP | \fB\-\-reserves=\fP\fINRESERVES\fP +\fB\-r\fP \fINRESERVES\fP | \fB–reserves=\fP\fINRESERVES\fP Create \fINRESERVES\fP reserves per client. .TP -\fB\-u\fP \fISECTION\fP | \fB\-\-exchange\-account\-section=\fP\fISECTION\fP +\fB\-u\fP \fISECTION\fP | \fB–exchange\-account\-section=\fP\fISECTION\fP Use \fISECTION\fP as the name of the configuration section which specifies the exchange bank account. .TP -\fB\-V\fP | \fB\-\-verbose\fP +\fB\-V\fP | \fB–verbose\fP Display more output than usual. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .TP -\fB\-w\fP \fINPROC\fP | \fB\-\-wirewatch=\fP\fINPROC\fP +\fB\-w\fP \fINPROC\fP | \fB–wirewatch=\fP\fINPROC\fP Run \fINPROC\fP processes of the \fBtaler\-exchange\-wirewatch\fP tool. .UNINDENT .SH SEE ALSO @@ -101,6 +101,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-config.1 b/man/taler-config.1 index 3d3e218b..37ee9fd8 100644 --- a/man/taler-config.1 +++ b/man/taler-config.1 @@ -27,75 +27,75 @@ 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-CONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-CONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-config \- Taler configuration inspection and editing .SH SYNOPSIS .sp \fBtaler\-config\fP -[\fB\-b\fP\ \fIbackend\fP\ |\ \fB\-\-supported\-backend=\fP\fIbackend\fP] -[\fB\-c\fP\ \fIfilename\fP\ |\ \fB\-\-config=\fP\fIfilename\fP] -[\fB\-f\fP\ |\ \fB\-\-filename\fP] -[\fB\-F\fP\ |\ \fB\-\-full\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\-o\fP\ \fIoption\fP\ |\ \fB\-\-option=\fP\fIoption\fP] -[\fB\-r\fP\ |\ \fB\-\-rewrite\fP] -[\fB\-S\fP\ |\ \fB\-\-list\-sections\fP] -[\fB\-s\fP\ \fIsection\fP\ |\ \fB\-\-section=\fP\fIsection\fP] -[\fB\-V\fP\ \fIvalue\fP\ |\ \fB\-\-value=\fP\fIvalue\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-b\fP\ \fIbackend\fP\ |\ \fB–supported\-backend=\fP\fIbackend\fP] +[\fB\-c\fP\ \fIfilename\fP\ |\ \fB–config=\fP\fIfilename\fP] +[\fB\-f\fP\ |\ \fB–filename\fP] +[\fB\-F\fP\ |\ \fB–full\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\-o\fP\ \fIoption\fP\ |\ \fB–option=\fP\fIoption\fP] +[\fB\-r\fP\ |\ \fB–rewrite\fP] +[\fB\-S\fP\ |\ \fB–list\-sections\fP] +[\fB\-s\fP\ \fIsection\fP\ |\ \fB–section=\fP\fIsection\fP] +[\fB\-V\fP\ \fIvalue\fP\ |\ \fB–value=\fP\fIvalue\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-config\fP can be used to read or modify GNU Taler configuration files. .INDENT 0.0 .TP -\fB\-b\fP \fIBACKEND\fP | \fB\-\-supported\-backend=\fP\fIBACKEND\fP +\fB\-b\fP \fIBACKEND\fP | \fB–supported\-backend=\fP\fIBACKEND\fP Tests whether the specified \fIBACKEND\fP is supported by the current installation. -The backend must match the name of a plugin, i.e. \(dqnamestore_postgres\(dq for -the PostgreSQL database backend of the \(dqNAMESTORE\(dq service. If \fIBACKEND\fP is +The backend must match the name of a plugin, i.e. “namestore_postgres” for +the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is supported, taler\-config will return a status code of 0 (success), otherwise 77 (unsupported). When this option is specified, no other options may be specified. Specifying this option together with other options will cause taler\-config to return a status code of 1 (error). .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration file \fIFILENAME\fP\&. .TP -\fB\-f\fP | \fB\-\-filename\fP +\fB\-f\fP | \fB–filename\fP Try to perform expansions as if the option values represent filenames (will also be applied even if the option is not really a filename). .TP -\fB\-F\fP | \fB\-\-full\fP +\fB\-F\fP | \fB–full\fP Write the full configuration file, not just the differences to the defaults. .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 Use \fILOGLEVEL\fP for logging. Valid values are \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, and \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\-o\fP \fIOPTION\fP | \fB\-\-option=\fP\fIOPTION\fP +\fB\-o\fP \fIOPTION\fP | \fB–option=\fP\fIOPTION\fP Which configuration option should be accessed or edited. Required to set a value. If not given, all values of a given section will be printed in the -format \(dqOPTION = VALUE\(dq. +format “OPTION = VALUE”. .TP -\fB\-r\fP | \fB\-\-rewrite\fP +\fB\-r\fP | \fB–rewrite\fP Write the configuration file even if nothing changed. Will remove all comments! .TP -\fB\-S\fP | \fB\-\-list\-sections\fP +\fB\-S\fP | \fB–list\-sections\fP List available configuration sections for use with \fB\-\-section\fP\&. .TP -\fB\-s\fP \fISECTION\fP | \fB\-\-section=\fP\fISECTION\fP +\fB\-s\fP \fISECTION\fP | \fB–section=\fP\fISECTION\fP Which configuration section should be accessed or edited. Required option. .TP -\fB\-V\fP \fIVALUE\fP | \fB\-\-value=\fP\fIVALUE\fP +\fB\-V\fP \fIVALUE\fP | \fB–value=\fP\fIVALUE\fP Configuration value to store in the given section under the given option. Must only be given together with \fB\-s\fP and \fB\-o\fP options. .INDENT 7.0 @@ -106,7 +106,7 @@ and may reorder sections and remove \fB@INLINE@\fP directives. Using \fB\-V\fP is thus dangerous! Use with extreme caution! .UNINDENT .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print GNU Taler version number. .UNINDENT .SH SEE ALSO @@ -119,6 +119,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-aggregator.1 b/man/taler-exchange-aggregator.1 index f9913356..c9a226e2 100644 --- a/man/taler-exchange-aggregator.1 +++ b/man/taler-exchange-aggregator.1 @@ -27,20 +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-EXCHANGE-AGGREGATOR" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-AGGREGATOR" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-aggregator \- aggregate deposits into wire transfers .SH SYNOPSIS .sp \fBtaler\-exchange\-aggregator\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[\fB\-y**_|_\fP\-\-kyc\-off**] +[\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[\fB\-y**_|_\fP–kyc\-off**] .SH DESCRIPTION .sp \fBtaler\-exchange\-aggregator\fP is a command\-line tool to run aggregate deposits @@ -49,35 +49,35 @@ done by \fBtaler\-exchange\-transfer\fP\&. .sp The AGGREGATOR_SHARD_SIZE option can be used to allow multiple aggregator processes to run in parallel and share the load. This is only recommended if a single aggregator is insufficient for the workload. .sp -The aggregator uses a special table to lock shards it is working on. If an aggregator process dies (say due to a power failure), these shard locks may prevent the aggregator from resuming normally. In this case, you must run \(dqtaler\-exchange\-dbinit \-s\(dq to release the shard locks before restarting the aggregator. +The aggregator uses a special table to lock shards it is working on. If an aggregator process dies (say due to a power failure), these shard locks may prevent the aggregator from resuming normally. In this case, you must run “taler\-exchange\-dbinit \-s” to release the shard locks before restarting the aggregator. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode and exit when idle. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .TP -\fB\-y\fP | \fB\-\-kyc\-off\fP +\fB\-y\fP | \fB–kyc\-off\fP Run without KYC checks. Talk with your regulator before using this option. .UNINDENT .SH SEE ALSO @@ -91,6 +91,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-benchmark.1 b/man/taler-exchange-benchmark.1 index 1e9ec168..18e966c0 100644 --- a/man/taler-exchange-benchmark.1 +++ b/man/taler-exchange-benchmark.1 @@ -27,24 +27,24 @@ 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-EXCHANGE-BENCHMARK" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-BENCHMARK" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-benchmark \- measure exchange performance .SH SYNOPSIS .sp \fBtaler\-exchange\-benchmark\fP -[\fB\-c\fP\ \fICONFIG_FILENAME\fP\ |\ \fB\-\-config=\fP\fICONFIG_FILENAME\fP] -[\fB\-F\fP\ |\ \fB\-\-reserves\-first\fP] -[\fB\-f\fP\ |\ \fB\-\-fakebank\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-log\-level=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-n\fP\ \fIHOWMANY_COINS\fP\ |\ \fB\-\-coins\-number=\fP\fIHOWMANY_COINS\fP] -[\fB\-p\fP\ \fINPROCS\fP\ |\ \fB\-\-parallelism=\fP\fINPROCS\fP] -[\fB\-R\fP\ \fIRATE\fP\ |\ \fB\-\-refresh\-rate=\fP\fIRATE\fP] -[\fB\-r\fP\ \fIN\fP\ |\ \fB\-\-reserves=\fP\fIN\fP] -[\fB\-u\fP\ \fISECTION\fP\ |\ \fB\-\-exchange\-account\-section=\fP\fISECTION\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fICONFIG_FILENAME\fP\ |\ \fB–config=\fP\fICONFIG_FILENAME\fP] +[\fB\-F\fP\ |\ \fB–reserves\-first\fP] +[\fB\-f\fP\ |\ \fB–fakebank\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–log\-level=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-n\fP\ \fIHOWMANY_COINS\fP\ |\ \fB–coins\-number=\fP\fIHOWMANY_COINS\fP] +[\fB\-p\fP\ \fINPROCS\fP\ |\ \fB–parallelism=\fP\fINPROCS\fP] +[\fB\-R\fP\ \fIRATE\fP\ |\ \fB–refresh\-rate=\fP\fIRATE\fP] +[\fB\-r\fP\ \fIN\fP\ |\ \fB–reserves=\fP\fIN\fP] +[\fB\-u\fP\ \fISECTION\fP\ |\ \fB–exchange\-account\-section=\fP\fISECTION\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-benchmark\fP is a command\-line tool to measure the time @@ -52,44 +52,44 @@ spent to serve withdrawals/deposits/refreshes. Before running the benchmark, the GNU Taler services must already be running at the configured addresses. .INDENT 0.0 .TP -\fB\-c\fP \fICONFIG_FILENAME\fP | \fB\-\-config=\fP\fICONFIG_FILENAME\fP +\fB\-c\fP \fICONFIG_FILENAME\fP | \fB–config=\fP\fICONFIG_FILENAME\fP (Mandatory) Use CONFIG_FILENAME. .TP -\fB\-F\fP | \fB\-\-reserves\-first\fP +\fB\-F\fP | \fB–reserves\-first\fP Create all reserves first, before starting normal operations. .TP -\fB\-f\fP | \fB\-\-fakebank\fP +\fB\-f\fP | \fB–fakebank\fP Expect to interact with a fakebank instead of libeufin. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Prints a compiled\-in help text. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-log\-level=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log\-level=\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\-n\fP \fIHOWMANY_COINS\fP | \fB\-\-coins\-number=\fP\fIHOWMANY_COINS\fP +\fB\-n\fP \fIHOWMANY_COINS\fP | \fB–coins\-number=\fP\fIHOWMANY_COINS\fP Defaults to 1. Specifies how many coins this benchmark should withdraw and spend. After being spent, each coin will be refreshed with a probability RATE (see option \fB\-\-refresh\-rate\fP). .TP -\fB\-p\fP \fINPROCS\fP | \fB\-\-parallelism=\fP\fINPROCS\fP +\fB\-p\fP \fINPROCS\fP | \fB–parallelism=\fP\fINPROCS\fP Run with \fINPROCS\fP client processes. .TP -\fB\-R\fP \fIRATE\fP | \fB\-\-refresh\-rate=\fP\fIRATE\fP +\fB\-R\fP \fIRATE\fP | \fB–refresh\-rate=\fP\fIRATE\fP Defaults to 10. Probability of refresh per coin (0\-100). .TP -\fB\-r\fP \fIN\fP | \fB\-\-reserves=\fP\fIN\fP +\fB\-r\fP \fIN\fP | \fB–reserves=\fP\fIN\fP Create \fIN\fP reserves per client. .TP -\fB\-u\fP \fISECTION\fP | \fB\-\-exchange\-account\-section=\fP\fISECTION\fP +\fB\-u\fP \fISECTION\fP | \fB–exchange\-account\-section=\fP\fISECTION\fP Which configuration section should be used for the bank account of the exchange. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -103,6 +103,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-closer.1 b/man/taler-exchange-closer.1 index e12885eb..8ddc6550 100644 --- a/man/taler-exchange-closer.1 +++ b/man/taler-exchange-closer.1 @@ -27,19 +27,19 @@ 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-EXCHANGE-CLOSER" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-CLOSER" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-closer \- close idle reserves .SH SYNOPSIS .sp \fBtaler\-exchange\-closer\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-closer\fP is a command\-line tool to run close @@ -47,29 +47,29 @@ reserves that have been idle for too long, causing transfers to the originating bank account to be scheduled. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode and exit when idle. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -82,6 +82,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-dbconfig.1 b/man/taler-exchange-dbconfig.1 index 63bc1780..6e3846f6 100644 --- a/man/taler-exchange-dbconfig.1 +++ b/man/taler-exchange-dbconfig.1 @@ -27,7 +27,7 @@ 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-EXCHANGE-DBCONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-DBCONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-dbconfig \- configure Taler exchange database .SH SYNOPSIS @@ -78,6 +78,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-dbinit.1 b/man/taler-exchange-dbinit.1 index 5b4f8167..2fe53de3 100644 --- a/man/taler-exchange-dbinit.1 +++ b/man/taler-exchange-dbinit.1 @@ -27,20 +27,21 @@ 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-EXCHANGE-DBINIT" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-DBINIT" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-dbinit \- initialize Taler exchange database .SH SYNOPSIS .sp \fBtaler\-exchange\-dbinit\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-g\fP\ |\ \fB\-\-gc\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\-r\fP\ |\ \fB\-\-reset\fP] -[\fB\-s\fP\ |\ \fB\-\-shardunlock\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-a\fP\ |\ \fB–inject\-auditor\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-g\fP\ |\ \fB–gc\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\-r\fP\ |\ \fB–reset\fP] +[\fB\-s\fP\ |\ \fB–shardunlock\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-dbinit\fP is a command\-line tool to initialize the Taler @@ -50,29 +51,32 @@ Taler exchange to operate. Its options are as follows: .INDENT 0.0 .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-a\fP | \fB–inject\-auditor\fP +Installs triggers to notify real\-time auditors of relevant changes to the database state. +.TP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the exchange to operate from \fIFILENAME\fP\&. .TP -\fB\-g\fP | \fB\-\-gc\fP +\fB\-g\fP | \fB–gc\fP Garbage collect database. Deletes all unnecessary data in the database. .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\-r\fP | \fB\-\-reset\fP +\fB\-r\fP | \fB–reset\fP Drop tables. Dangerous, will delete all existing data in the database before creating the tables. .TP -\fB\-s\fP | \fB\-\-shardunlock\fP +\fB\-s\fP | \fB–shardunlock\fP Clears the (revolving) shards table. Needed to clear locks that may be held after a crash (of taler\-exchange\-aggregator or the operating system, say due to power outage) or if the AGGREGATOR_SHARD_SIZE option is changed in the configuration file. .TP \fB\-v\fP | \fB–version\fP @@ -89,6 +93,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-drain.1 b/man/taler-exchange-drain.1 index 4b682f23..48a7db8a 100644 --- a/man/taler-exchange-drain.1 +++ b/man/taler-exchange-drain.1 @@ -27,40 +27,40 @@ 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-EXCHANGE-DRAIN" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-DRAIN" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-drain \- drain profits from exchange .SH SYNOPSIS .sp \fBtaler\-exchange\-drain\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\-v\fP\ |\ \fB\-\-version\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\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp -\fBtaler\-exchange\-drain\fP is used to trigger a wire transfer from the exchange\(aqs escrow account to a normal (non\-escrowed) bank account of the exchange. The entire drain process is necessary to ensure that the auditor is aware of the +\fBtaler\-exchange\-drain\fP is used to trigger a wire transfer from the exchange’s escrow account to a normal (non\-escrowed) bank account of the exchange. The entire drain process is necessary to ensure that the auditor is aware of the balance changes arising from an exchange making profits from fees. .sp -To use it, you must first create an upload a \(aqdrain\(aq command using \fBtaler\-exchange\-offline\fP\&. Afterwards this command should be run to actually queue the drain. The actual drain will then be executed by \fBtaler\-exchange\-transfer\fP\&. +To use it, you must first create an upload a ‘drain’ command using \fBtaler\-exchange\-offline\fP\&. Afterwards this command should be run to actually queue the drain. The actual drain will then be executed by \fBtaler\-exchange\-transfer\fP\&. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .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\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -73,6 +73,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-expire.1 b/man/taler-exchange-expire.1 index 9c003f88..27eb47af 100644 --- a/man/taler-exchange-expire.1 +++ b/man/taler-exchange-expire.1 @@ -27,19 +27,19 @@ 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-EXCHANGE-EXPIRE" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-EXPIRE" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-expire \- refund expired purses .SH SYNOPSIS .sp \fBtaler\-exchange\-expire\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-expire\fP is a command\-line tool to run refund @@ -48,29 +48,29 @@ This allows the wallet to recover the funds deposited into the purse using a refresh operation. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode and exit when idle. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -83,6 +83,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-httpd.1 b/man/taler-exchange-httpd.1 index 4889740c..395e0f95 100644 --- a/man/taler-exchange-httpd.1 +++ b/man/taler-exchange-httpd.1 @@ -27,24 +27,24 @@ 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-EXCHANGE-HTTPD" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-HTTPD" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-httpd \- run Taler exchange (with RESTful API) .SH SYNOPSIS .sp \fBtaler\-exchange\-httpd\fP -[\fB\-a\fP\ |\ \fB\-\-allow\-timetravel\fP] -[\fB\-C\fP\ |\ \fB\-\-connection\-close\fP] -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-f\fP\ \fIFILENAME\fP\ |\ \fB\-\-file\-input=\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\-n\fP\ \fIN\fP\ |\ \fB\-\-num\-threads=\fP\fIN\fP] -[\fB\-r**|\fP\-\-allow\-reuse\-address**] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-t\fP\ \fISECONDS\fP\ |\ \fB\-\-timeout=\fP\fISECONDS\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-a\fP\ |\ \fB–allow\-timetravel\fP] +[\fB\-C\fP\ |\ \fB–connection\-close\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-f\fP\ \fIFILENAME\fP\ |\ \fB–file\-input=\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\-n\fP\ \fIN\fP\ |\ \fB–num\-threads=\fP\fIN\fP] +[\fB\-r**|\fP–allow\-reuse\-address**] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-t\fP\ \fISECONDS\fP\ |\ \fB–timeout=\fP\fISECONDS\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-httpd\fP is a command\-line tool to run the Taler @@ -54,24 +54,24 @@ must exist before running this command. Its options are as follows: .INDENT 0.0 .TP -\fB\-a\fP | \fB\-\-allow\-timetravel\fP +\fB\-a\fP | \fB–allow\-timetravel\fP Allow clients to request /keys for arbitrary timestamps. This should only be enabled for testing and development, as clients could abuse this in denial of service attacks, as it makes the /keys response generation much more expensive. .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 \fB\-f\fP to avoid having to wait for netcat (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\-f\fP \fIFILENAME\fP | \fB\-\-file\-input=\fP\fIFILENAME\fP +\fB\-f\fP \fIFILENAME\fP | \fB–file\-input=\fP\fIFILENAME\fP This option is only available if the exchange was compiled with the -configure option \-\-enable\-developer\-mode. It is used for generating +configure option –enable\-developer\-mode. It is used for generating test cases against the exchange using AFL. When this option is present, the HTTP server will .INDENT 7.0 @@ -89,31 +89,31 @@ input from an HTTP client and then immediately exit. This is useful to test taler\-exchange\-httpd against many different possible inputs in a controlled way. .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\-r\fP | \fB\-\-allow\-reuse\-address\fP +\fB\-r\fP | \fB–allow\-reuse\-address\fP Allow the exchange to re\-use the listen port even if another service is already using it. Useful if multiple processes are used to increase processing capacity. .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\-t\fP \fISECONDS\fP | \fB\-\-timeout=\fP\fISECONDS\fP +\fB\-t\fP \fISECONDS\fP | \fB–timeout=\fP\fISECONDS\fP Specifies the number of SECONDS after which the HTTPD should close (idle) HTTP connections. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SIGNALS @@ -142,6 +142,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-kyc-aml-pep-trigger.1 b/man/taler-exchange-kyc-aml-pep-trigger.1 index e3be6bcf..e6a0fb7f 100644 --- a/man/taler-exchange-kyc-aml-pep-trigger.1 +++ b/man/taler-exchange-kyc-aml-pep-trigger.1 @@ -27,7 +27,7 @@ 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-EXCHANGE-KYC-AML-PEP-TRIGGER" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-KYC-AML-PEP-TRIGGER" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-kyc-aml-pep-trigger \- Taler KYC_AML_TRIGGER example .SH SYNOPSIS @@ -35,7 +35,7 @@ taler-exchange-kyc-aml-pep-trigger \- Taler KYC_AML_TRIGGER example \fBtaler\-exchange\-kyc\-aml\-pep\-trigger\fP .SH DESCRIPTION .sp -\fBtaler\-exchange\-kyc\-aml\-pep\-trigger\fP is a trivial shell script to illustrate how to trigger an AML process when the KYC process sets the \(dqPEP\(dq flag in the attribute data. +\fBtaler\-exchange\-kyc\-aml\-pep\-trigger\fP is a trivial shell script to illustrate how to trigger an AML process when the KYC process sets the “PEP” flag in the attribute data. .sp The script is mostly an example (or starting point) for writing programs for the KYC_AML_TRIGGER option of the @@ -50,6 +50,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-kyc-tester.1 b/man/taler-exchange-kyc-tester.1 index 26ed737a..ff80a8df 100644 --- a/man/taler-exchange-kyc-tester.1 +++ b/man/taler-exchange-kyc-tester.1 @@ -27,24 +27,24 @@ 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-EXCHANGE-KYC-TESTER" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-KYC-TESTER" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-kyc-tester \- test KYC service integration .SH SYNOPSIS .sp \fBtaler\-exchange\-kyc\-tester\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\-i\fP\ \fISECTION_NAME\fP\ |\ \fB\-\-initiate=\fP\fISECTION_NAME\fP] -[\fB\-u\fP\ \fIID\fP\ |\ \fB\-\-user=\fP\fIID\fP] -[\fB\-U\fP\ \fIID\fP\ |\ \fB\-\-legitimization=\fP\fIID\fP] -[\fB\-P\fP\ |\ \fB\-\-print\-payto\-hash\fP] -[\fB\-p\fP\ \fIHASH\fP\ |\ \fB\-\-payto\-hash=\fP\fIHASH\fP] -[\fB\-r\fP\ \fINUMBER\fP\ |\ \fB\-\-rowid=\fP\fINUMBER\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[\fB\-w\fP\ |\ \fB\-\-run\-webservice\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\-i\fP\ \fISECTION_NAME\fP\ |\ \fB–initiate=\fP\fISECTION_NAME\fP] +[\fB\-u\fP\ \fIID\fP\ |\ \fB–user=\fP\fIID\fP] +[\fB\-U\fP\ \fIID\fP\ |\ \fB–legitimization=\fP\fIID\fP] +[\fB\-P\fP\ |\ \fB–print\-payto\-hash\fP] +[\fB\-p\fP\ \fIHASH\fP\ |\ \fB–payto\-hash=\fP\fIHASH\fP] +[\fB\-r\fP\ \fINUMBER\fP\ |\ \fB–rowid=\fP\fINUMBER\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[\fB\-w\fP\ |\ \fB–run\-webservice\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-kyc\-tester\fP is used to test the interaction between a Taler exchange and a KYC service. The tool can be used to manually trigger the various steps of a KYC process and to observe the interaction with the respective KYC service. It is supposted to help test the configuration of the integration, and \fInot\fP required at all during production. @@ -53,48 +53,48 @@ To use it, you must first provide a configuration file with at least one KYC ser .sp Begin with a first invocation of taler\-exchange\-kyc\-tester using the options \fB\-i\fP for an individual or business and use \fB\-R\fP to specify a list of checks required from the process. The output will be an URL to visit with the browser, as well as \fB\-p\fP, \fB\-u\fP, \fB\-U\fP options to use in future invocations of the tool. .sp -Next, run taler\-exchange\-kyc\-tester again, but this time using \fB\-w\fP (to run the Webserver) and using the \fB\-u\fP and \fB\-U\fP options output by the previous call, as well as the \fB\-p\fP option with the payto hash. Then visit the Web site from the link output by the previous invocation and \(dqpass\(dq (or \(dqfail\(dq) the KYC check. +Next, run taler\-exchange\-kyc\-tester again, but this time using \fB\-w\fP (to run the Webserver) and using the \fB\-u\fP and \fB\-U\fP options output by the previous call, as well as the \fB\-p\fP option with the payto hash. Then visit the Web site from the link output by the previous invocation and “pass” (or “fail”) the KYC check. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .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\-i\fP \fIUSERTYPE\fP | \fB\-\-initiate=\fP\fIUSERTYPE\fP -Specifies the type of user for which we are starting a fresh KYC process. USERTYPE must be either \(dqindividual\(dq or \(dqbusiness\(dq. +\fB\-i\fP \fIUSERTYPE\fP | \fB–initiate=\fP\fIUSERTYPE\fP +Specifies the type of user for which we are starting a fresh KYC process. USERTYPE must be either “individual” or “business”. .TP -\fB\-u\fP \fIID\fP | \fB\-\-user=\fP\fIID\fP +\fB\-u\fP \fIID\fP | \fB–user=\fP\fIID\fP Run the process with ID for the user identifier at the KYC provider. Not useful in conjunction with \fB\-i\fP and \fB\-R\fP as that option will override whatever value is provided here. .TP -\fB\-U\fP \fIID\fP | \fB\-\-legitimization=\fP\fIID\fP +\fB\-U\fP \fIID\fP | \fB–legitimization=\fP\fIID\fP Run the process with ID for the legitimization process identifier at the KYC provider. Not useful in conjunction with \fB\-R\fP / \fB\-i\fP as that option will override whatever value is provided here. .TP -\fB\-p\fP \fIHASH\fP | \fB\-\-payto\-hash=\fP\fIHASH\fP +\fB\-p\fP \fIHASH\fP | \fB–payto\-hash=\fP\fIHASH\fP Run the process with HASH as the hash of the payto://\-URI that identifies the account or wallet triggering the KYC requirement. If not given, a fresh random value is used. Rarely useful. .TP -\fB\-P\fP | \fB\-\-print\-payto\-hash\fP +\fB\-P\fP | \fB–print\-payto\-hash\fP Print the HASH of the payto://\-URI used for the KYC simulation this time. Useful if the hash is needed for a subsequent use in conjunction with \fB\-p\fP\&. .TP -\fB\-r\fP \fINUMBER\fP | \fB\-\-rowid=\fP\fINUMBER\fP +\fB\-r\fP \fINUMBER\fP | \fB–rowid=\fP\fINUMBER\fP Run the process with NUMBER as the database row for the legitimization operation. Rarely useful, except maybe for debugging. Defaults to 42. .TP -\fB\-R\fP \fICHECKS\fP | \fB\-\-requirements=\fP\fICHECKS\fP +\fB\-R\fP \fICHECKS\fP | \fB–requirements=\fP\fICHECKS\fP Start a fresh KYC process for the given list of CHECKS. CHECKS must be a space\-separated list of checks that must be in the configuration under \fIPROVIDED_CHECKS\fP for some of the providers. The exchange will determine which provider to use for KYC based on the CHECKS given. The tool will output the HTTP URL where the user has to begin the KYC process to the command\-line. This is usually the first thing to do when using this tool. Outputs the KYC\-logic specific user and legitimization IDs, or NULL if not used by the KYC\-logic at the initiation stage. You may want to use the \fB\-P\fP option to also obtain the Payto\-Hash for use with \fBp\fP later. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .TP -\fB\-w\fP | \fB\-\-run\-webservice\fP +\fB\-w\fP | \fB–run\-webservice\fP Run a simulated Taler exchange HTTP service on the configured port with the \fB/kyc\-proof/\fP and \fB/kyc\-webhook/\fP endpoints. .UNINDENT .SH SEE ALSO @@ -107,6 +107,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-offline.1 b/man/taler-exchange-offline.1 index 88eb1978..687d86c0 100644 --- a/man/taler-exchange-offline.1 +++ b/man/taler-exchange-offline.1 @@ -27,27 +27,27 @@ 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-EXCHANGE-OFFLINE" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-OFFLINE" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-offline \- operations using the offline key of a Taler exchange .SH SYNOPSIS .sp \fBtaler\-exchange\-offline\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\-v\fP\ |\ \fB\-\-version\fP] -[subcommand ...] +[\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\-v\fP\ |\ \fB–version\fP] +[subcommand …] .SH DESCRIPTION .sp \fBtaler\-exchange\-offline\fP is a command\-line tool to interact with the Taler -exchange\(aqs master private key. Most operations of this tool require access to +exchange’s master private key. Most operations of this tool require access to the exchange’s long\-term offline signing key and should be run in a secure (offline) environment under strict controls. The tool takes a list of subcommands as arguments which are then processed sequentially. .sp -The tool includes two subcommands to interact \fIonline\fP with the exchange\(aqs +The tool includes two subcommands to interact \fIonline\fP with the exchange’s REST APIs. To determine how to talk to the exchange, these two subcommands rely on the \fBBASE_URL\fP configuration option from the \fB[exchange]\fP section of the configuration file. The \fBdownload\fP subcommand downloads the future @@ -55,10 +55,10 @@ public keys from the running exchange. The resulting data serves as input to the \fBsign\fP and \fBshow\fP subcommands. The \fBupload\fP subcommand uploads the signatures created with the private master key to the exchange. It handles the output of all subcommands (except \fBdownload\fP). The \fBdownload\fP and -\fBupload\fP subcommands must naturally be run \(dqonline\(dq and do not require +\fBupload\fP subcommands must naturally be run “online” and do not require access to the offline key. .sp -All other subcommands are intended to be run \(dqoffline\(dq. However, especially +All other subcommands are intended to be run “offline”. However, especially when testing, it is of course possible to run the subcommands online as well. Generally, subcommands read inputs (beyond command\-line arguments) from \fBstdin\fP\&. However, they may also consume outputs of previous @@ -68,21 +68,21 @@ and if not consumed the final output is printed to \fBstdout\fP\&. The general options for \fBtaler\-exchange\-offline\fP are: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH CONFIGURATION @@ -102,17 +102,17 @@ $ taler\-exchange\-offline setup .UNINDENT .sp Note that if the private key file already exists, the above will simply output -the existing key. Passing additional arguments after setup (including \(dq\-\(dq) +the existing key. Passing additional arguments after setup (including “\-“) will cause the output to be encapsulated in JSON. .sp Relevant configuration options for \fBtaler\-exchange\-offline\fP are: .INDENT 0.0 .IP \(bu 2 -\fB[exchange/BASE_URL]\fP \-\-\- how to reach the exchange (for download/upload) +\fB[exchange/BASE_URL]\fP — how to reach the exchange (for download/upload) .IP \(bu 2 -\fB[exchange\-offline/MASTER_PRIV_FILE]\fP \-\-\- where to store the private keys +\fB[exchange\-offline/MASTER_PRIV_FILE]\fP — where to store the private keys .IP \(bu 2 -\fB[exchange\-offline/SECM_TOFU_FILE]\fP \-\-\- where to store TOFU data +\fB[exchange\-offline/SECM_TOFU_FILE]\fP — where to store TOFU data .UNINDENT .SH SUBCOMMANDS .SS setup @@ -164,7 +164,7 @@ configuration of extensions, in a format suitable for the \fBupload\fP subcommand. .sp Note that an extension on the exchange will only become activated at runtime -\fIafter\fP the extension\(aqs configurations has been signed by the offline tool with +\fIafter\fP the extension’s configurations has been signed by the offline tool with the signing key and the signed configuration been uploaded to the exchange. .SS drain .sp @@ -208,23 +208,23 @@ in a format suitable for the \fBupload\fP subcommand. .sp This subcommand informs an exchange that an auditor is to be activated. Afterwards, the -exchange will accept inputs from that auditor\(aqs \fBtaler\-auditor\-offline\fP +exchange will accept inputs from that auditor’s \fBtaler\-auditor\-offline\fP tool. Note that the auditor also must add the exchange to the list of exchanges that it audits via \fBtaler\-auditor\-exchange\fP\&. Furthermore, the -exchange\(aqs database will need to be provided to the auditor. This subcommand +exchange’s database will need to be provided to the auditor. This subcommand only informs the exchange about the auditor, but does not perform those additional mandatory steps for a working auditor. .sp -The auditor\(aqs public key must be given in the usual base32\-encoding as the +The auditor’s public key must be given in the usual base32\-encoding as the first argument. .sp -The auditor\(aqs REST API base URL must be given as the second argument. The tool -performs a minimal sanity check, namely that the URL begins with \(dqhttp\(dq -(this also allows \(dqhttps\(dq), but as it runs offline does not perform any further +The auditor’s REST API base URL must be given as the second argument. The tool +performs a minimal sanity check, namely that the URL begins with “http” +(this also allows “https”), but as it runs offline does not perform any further validation! .sp The third argument must be a human\-readable name for the auditor. This may -be shown to users and should identify the auditor\(aqs business entity. If +be shown to users and should identify the auditor’s business entity. If the name includes spaces, the argument should be quoted. .sp The subcommand takes no inputs from \fBstdin\fP or other subcommands. @@ -235,10 +235,10 @@ in a format suitable for the \fBupload\fP subcommand. .sp This subcommand informs an exchange that an auditor is to be deactivated. Afterwards, the -exchange will refuse inputs from that auditor\(aqs \fBtaler\-auditor\-offline\fP +exchange will refuse inputs from that auditor’s \fBtaler\-auditor\-offline\fP tool. .sp -The auditor\(aqs public key must be given in the usual base32\-encoding as the +The auditor’s public key must be given in the usual base32\-encoding as the first argument. .sp The subcommand takes no inputs from \fBstdin\fP or other subcommands. @@ -256,7 +256,7 @@ account information advertised could theoretically differ from that which these tool actually use, for example if the public bank account is only a front for the actual internal business accounts. .sp -The \fBpayto://\fP URI (RFC 8905) of the exchange\(aqs bank account must be given +The \fBpayto://\fP URI (RFC 8905) of the exchange’s bank account must be given as the first argument to the subcommand. .sp Afterwards, optional arguments can be given: @@ -269,6 +269,14 @@ to currency conversion. $URL must be the address of a currency conversion REST API that allows merchants and wallets to determine the current conversion rate. .IP \(bu 2 +\fBdisplay\-hint\fP $PRIORITY $LABEL: specifies that this bank account should +be shown to the user with the given numeric $PRIORITY (higher is earlier) +and with the given $LABEL. This is useful to ensure that if an exchange +has multiple bank accounts, we can show the user those that are most likely +useful first, and give them appropriately labeled hints for selecting other +accounts as well. A display hint is optional, if missing the priority is 0 +and the wallet must pick some appropriate label itself somehow. +.IP \(bu 2 \fBcredit\-restriction\fP $TYPE [$ARGS]: Specifies that there are restrictions in place when crediting this bank account. Details depend on the restriction $TYPE. This argument may be given multiple times, in which @@ -294,7 +302,7 @@ The following types of credit\- and debit\-restrictions are supported: \fBdeny\fP: A $TYPE of \fBdeny\fP means that this bank account cannot be used for the given operation. \fBdeny\fP takes no further arguments. .IP \(bu 2 -\fBregex\fP $EXPR $HINT $JSON: A $TYPE of \fBregex\fP means that the partner\(aqs +\fBregex\fP $EXPR $HINT $JSON: A $TYPE of \fBregex\fP means that the partner’s bank account \fBpayto\fP\-URI representation must follow a certain regular expression given in $EXPR where the syntax follows posix\-egrep, but without support for character classes, GNU extensions, back\-references or @@ -317,7 +325,7 @@ This subcommand informs an exchange that it should stop advertising a bank account as belonging to the exchange on its \fB/keys\fP endpoint. .sp -The \fBpayto://\fP URI (RFC 8905) of the exchange\(aqs (former) bank account must be +The \fBpayto://\fP URI (RFC 8905) of the exchange’s (former) bank account must be given as the first argument to the subcommand. .sp The subcommand takes no inputs from \fBstdin\fP or other subcommands. @@ -371,11 +379,11 @@ Partner exchange base URL. .IP 2. 3 Partner exchange master public key. .IP 3. 3 -Calendar year for which the fee applies, \(aqnow\(aq for the current year. +Calendar year for which the fee applies, ‘now’ for the current year. .IP 4. 3 -Wad frequency, in minutes (for example, \(aq30\(aq). +Wad frequency, in minutes (for example, ‘30’). .IP 5. 3 -Wad fee (for example, \(aqKUDOS:0.1\(aq). +Wad fee (for example, ‘KUDOS:0.1’). .UNINDENT .UNINDENT .UNINDENT @@ -388,7 +396,7 @@ The arguments provided must include: .INDENT 3.5 .INDENT 0.0 .IP 1. 3 -Calendar year for which the fee applies, \(aqnow\(aq for the current year. +Calendar year for which the fee applies, ‘now’ for the current year. .IP 2. 3 KYC timeout. How long does the exchange keep a reserve open that is waiting for the KYC. .IP 3. 3 @@ -410,8 +418,8 @@ History fee charged when inquiring about non\-recent account history. .UNINDENT .SS aml\-enable .sp -Enable AML officer\(aqs account, granting them access to AML data and, -if \(aqrw\(aq is given, the power to make AML decisions. +Enable AML officer’s account, granting them access to AML data and, +if ‘rw’ is given, the power to make AML decisions. .sp The arguments provided must include: .INDENT 0.0 @@ -422,13 +430,13 @@ AML staff member public key (in base32 encoding) .IP 2. 3 AML staff member legal name .IP 3. 3 -\(aqro\(aq or \(aqrw\(aq to set access to read\-only or read\-write +‘ro’ or ‘rw’ to set access to read\-only or read\-write .UNINDENT .UNINDENT .UNINDENT .SS aml\-disable .sp -Disable AML officer\(aqs account. Also updates the legal name. +Disable AML officer’s account. Also updates the legal name. .sp The arguments provided must include: .INDENT 0.0 @@ -459,7 +467,7 @@ Wad fee to charge. .IP 4. 3 Wad transfer frequency. .IP 5. 3 -Year for which the above options are to be configured, \(aqnow\(aq for the current year. +Year for which the above options are to be configured, ‘now’ for the current year. .UNINDENT .UNINDENT .UNINDENT @@ -522,7 +530,7 @@ $ taler\-exchange\-offline upload < sigs.json .SS Download, sign and upload, all in one (online) .sp Note that doing this is only recommended in non\-production deployments, -as this requires putting the \(dqoffline\(dq key onto a system that is actually +as this requires putting the “offline” key onto a system that is actually online! .INDENT 0.0 .INDENT 3.5 @@ -658,7 +666,7 @@ $ taler\-exchange\-offline \e .UNINDENT .UNINDENT .sp -The outputs (\(dqrevoke.json\(dq, \(dqmix.json\(dq) must be uploaded using the \fBupload\fP +The outputs (“revoke.json”, “mix.json”) must be uploaded using the \fBupload\fP subcommand to the exchange to actually revoke the keys. .SH SECURITY CONSIDERATIONS .sp @@ -667,8 +675,8 @@ system with \fImonotonic time\fP\&. The time does not have to precisely match th of the exchange, but it must be monotonic across tool invocations. The clock of the offline system is used in the enable/disable signatures to communicate an order of the events to the exchange. This prevents someone from replaying -an older \(dqenable\(dq (or \(dqdisable\(dq) message after a more recent \(dqdisable\(dq (or -\(dqenable\(dq) message has been provided to the exchange. Thus, there is no need +an older “enable” (or “disable”) message after a more recent “disable” (or +“enable”) message has been provided to the exchange. Thus, there is no need to keep the actual files exchanged with the offline tool secret. .sp The \fBtaler\-exchange\-offline\fP tool tries to make sure that the online signing @@ -678,7 +686,7 @@ but \fInot\fP the security modules from providing attacker\-controlled keys to t offline signing process. .sp For this, the \fBtaler\-exchange\-offline\fP signing subcommand always -automatically learns the security module\(aqs public signing key and \fItrusts it +automatically learns the security module’s public signing key and \fItrusts it on first use\fP (TOFU), but stores it to disk (see the \fBSECM_TOFU_FILE\fP option in the \fB[exchange\-offline]\fP section of the configuration). If the keys change subsequently, the tool will refuse to sign. @@ -692,6 +700,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-router.1 b/man/taler-exchange-router.1 index 729b4e75..3b4c095b 100644 --- a/man/taler-exchange-router.1 +++ b/man/taler-exchange-router.1 @@ -27,19 +27,19 @@ 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-EXCHANGE-ROUTER" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-ROUTER" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-router \- route payments to partner exchanges .SH SYNOPSIS .sp \fBtaler\-exchange\-router\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-router\fP is a NOT YET IMPLEMENTED command\-line @@ -49,29 +49,29 @@ wallets where the recipient has performed the KYC at a different exchange than the sender. This is currently not supported. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode and exit when idle. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -84,6 +84,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-secmod-cs.1 b/man/taler-exchange-secmod-cs.1 index f826996e..cd8001b5 100644 --- a/man/taler-exchange-secmod-cs.1 +++ b/man/taler-exchange-secmod-cs.1 @@ -27,20 +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-EXCHANGE-SECMOD-CS" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-CS" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-secmod-cs \- handle private CS key operations for a Taler exchange .SH SYNOPSIS .sp \fBtaler\-exchange\-secmod\-cs\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\-p\fP\ \fIN\fP\ |\ ,**\-\-parallelism=**\fIN\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-t\fP\ \fITIMESTAMP\fP\ |\ \fB\-\-time=\fP\fITIMESTAMP\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-p\fP\ \fIN\fP\ |\ ,**–parallelism=**\fIN\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-t\fP\ \fITIMESTAMP\fP\ |\ \fB–time=\fP\fITIMESTAMP\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-secmod\-cs\fP is a command\-line tool to @@ -51,33 +51,33 @@ FIXME: More details. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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 -\fBp\fP \fIN\fP | \fB\-\-parallelism=\fP\fIN\fP +\fBp\fP \fIN\fP | \fB–parallelism=\fP\fIN\fP Run with \fIN\fP worker threads. .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\-t\fP \fITIMESTAMP\fP | \fB\-\-time=\fP\fITIMESTAMP\fP +\fB\-t\fP \fITIMESTAMP\fP | \fB–time=\fP\fITIMESTAMP\fP Pretend it is \fITIMESTAMP\fP for the update. \fITIMESTAMP\fP is a human\-readable string (e.g., \fBYYYY\-MM\-DD HH:MM:SS\fP). .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -90,6 +90,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-secmod-eddsa.1 b/man/taler-exchange-secmod-eddsa.1 index 765e0d26..4e4a890b 100644 --- a/man/taler-exchange-secmod-eddsa.1 +++ b/man/taler-exchange-secmod-eddsa.1 @@ -27,20 +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-EXCHANGE-SECMOD-EDDSA" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-EDDSA" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-secmod-eddsa \- handle private EDDSA key operations for a Taler exchange .SH SYNOPSIS .sp \fBtaler\-exchange\-secmod\-eddsa\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\-p\fP\ \fIN\fP\ |\ ,**\-\-parallelism=**\fIN\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-t\fP\ \fITIMESTAMP\fP\ |\ \fB\-\-time=\fP\fITIMESTAMP\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-p\fP\ \fIN\fP\ |\ ,**–parallelism=**\fIN\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-t\fP\ \fITIMESTAMP\fP\ |\ \fB–time=\fP\fITIMESTAMP\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-secmod\-eddsa\fP is a command\-line tool to @@ -51,33 +51,33 @@ FIXME: More details. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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 -\fBp\fP \fIN\fP | \fB\-\-parallelism=\fP\fIN\fP +\fBp\fP \fIN\fP | \fB–parallelism=\fP\fIN\fP Run with \fIN\fP worker threads. .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\-t\fP \fITIMESTAMP\fP | \fB\-\-time=\fP\fITIMESTAMP\fP +\fB\-t\fP \fITIMESTAMP\fP | \fB–time=\fP\fITIMESTAMP\fP Pretend it is \fITIMESTAMP\fP for the update. \fITIMESTAMP\fP is a human\-readable string (e.g., \fBYYYY\-MM\-DD HH:MM:SS\fP). .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -90,6 +90,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-secmod-rsa.1 b/man/taler-exchange-secmod-rsa.1 index 8e24c1e2..ee998ad6 100644 --- a/man/taler-exchange-secmod-rsa.1 +++ b/man/taler-exchange-secmod-rsa.1 @@ -27,20 +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-EXCHANGE-SECMOD-RSA" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-RSA" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-secmod-rsa \- handle private RSA key operations for a Taler exchange .SH SYNOPSIS .sp \fBtaler\-exchange\-secmod\-rsa\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\-p\fP\ \fIN\fP\ |\ ,**\-\-parallelism=**\fIN\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-t\fP\ \fITIMESTAMP\fP\ |\ \fB\-\-time=\fP\fITIMESTAMP\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-p\fP\ \fIN\fP\ |\ ,**–parallelism=**\fIN\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-t\fP\ \fITIMESTAMP\fP\ |\ \fB–time=\fP\fITIMESTAMP\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-secmod\-rsa\fP is a command\-line tool to @@ -51,33 +51,33 @@ FIXME: More details. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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 -\fBp\fP \fIN\fP | \fB\-\-parallelism=\fP\fIN\fP +\fBp\fP \fIN\fP | \fB–parallelism=\fP\fIN\fP Run with \fIN\fP worker threads. .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\-t\fP \fITIMESTAMP\fP | \fB\-\-time=\fP\fITIMESTAMP\fP +\fB\-t\fP \fITIMESTAMP\fP | \fB–time=\fP\fITIMESTAMP\fP Pretend it is \fITIMESTAMP\fP for the update. \fITIMESTAMP\fP is a human\-readable string (e.g., \fBYYYY\-MM\-DD HH:MM:SS\fP). .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -90,6 +90,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-transfer.1 b/man/taler-exchange-transfer.1 index 20aa354b..d8b3426f 100644 --- a/man/taler-exchange-transfer.1 +++ b/man/taler-exchange-transfer.1 @@ -27,48 +27,48 @@ 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-EXCHANGE-TRANSFER" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-TRANSFER" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-transfer \- execute wire transfers .SH SYNOPSIS .sp \fBtaler\-exchange\-transfer\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-transfer\fP is a command\-line tool to actually execute scheduled wire transfers (using the bank/wire gateway). The transfers are prepared by the \fBtaler\-exchange\-aggregator\fP and \fBtaler\-exchange\-closer\fP tools. .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode and exit when idle. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -82,6 +82,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-wire-gateway-client.1 b/man/taler-exchange-wire-gateway-client.1 index aca0ecf1..25d09723 100644 --- a/man/taler-exchange-wire-gateway-client.1 +++ b/man/taler-exchange-wire-gateway-client.1 @@ -27,28 +27,28 @@ 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-EXCHANGE-WIRE-GATEWAY-CLIENT" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-WIRE-GATEWAY-CLIENT" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-wire-gateway-client \- trigger a transfer at the bank .SH SYNOPSIS .sp \fBtaler\-exchange\-wire\-gateway\-client\fP -[\fB\-a\fP\ \fIVALUE\fP\ |\ \fB\-\-amount=\fP\fIVALUE\fP] -[\fB\-b\fP\ \fIURL\fP\ |\ \fB\-\-bank=\fP\fIURL\fP] -[\fB\-C\fP\ \fIACCOUNT\fP\ |\ \fB\-\-credit=\fP\fIACCOUNT\fP] -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-D\fP\ \fIACCOUNT\fP\ |\ \fB\-\-debit=\fP\fIACCOUNT\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-i\fP\ |\ \fB\-\-credit\-history\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-o\fP\ |\ \fB\-\-debit\-history\fP] -[\fB\-p\fP\ \fIPASSPHRASE\fP\ |\ \fB\-\-pass=\fP\fIPASSPHRASE\fP] -[\fB\-S\fP\ \fISTRING\fP\ |\ \fB\-\-subject=\fP\fISTRING\fP] -[\fB\-s\fP\ \fIACCOUNT\-SECTION\fP\ |\ \fB\-\-section=\fP\fIACCOUNT\-SECTION\fP] -[\fB\-u\fP\ \fIUSERNAME\fP\ |\ \fB\-\-user=\fP\fIUSERNAME\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[\fB\-w\fP\ \fIROW\fP\ |\ \fB\-\-since\-when=\fP\fIROW\fP] +[\fB\-a\fP\ \fIVALUE\fP\ |\ \fB–amount=\fP\fIVALUE\fP] +[\fB\-b\fP\ \fIURL\fP\ |\ \fB–bank=\fP\fIURL\fP] +[\fB\-C\fP\ \fIACCOUNT\fP\ |\ \fB–credit=\fP\fIACCOUNT\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-D\fP\ \fIACCOUNT\fP\ |\ \fB–debit=\fP\fIACCOUNT\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-i\fP\ |\ \fB–credit\-history\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-o\fP\ |\ \fB–debit\-history\fP] +[\fB\-p\fP\ \fIPASSPHRASE\fP\ |\ \fB–pass=\fP\fIPASSPHRASE\fP] +[\fB\-S\fP\ \fISTRING\fP\ |\ \fB–subject=\fP\fISTRING\fP] +[\fB\-s\fP\ \fIACCOUNT\-SECTION\fP\ |\ \fB–section=\fP\fIACCOUNT\-SECTION\fP] +[\fB\-u\fP\ \fIUSERNAME\fP\ |\ \fB–user=\fP\fIUSERNAME\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[\fB\-w\fP\ \fIROW\fP\ |\ \fB–since\-when=\fP\fIROW\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-wire\-gateway\-client\fP is a command\-line tool to trigger bank transfers or @@ -77,63 +77,63 @@ on transaction history operations. .SH OPTIONS .INDENT 0.0 .TP -\fB\-a\fP \fIVALUE\fP | \fB\-\-amount=\fP\fIVALUE\fP +\fB\-a\fP \fIVALUE\fP | \fB–amount=\fP\fIVALUE\fP Amount to transfer. Given in the Taler\-typical format of CURRENCY:VALUE.FRACTION. .TP -\fB\-b\fP \fIURL\fP | \fB\-\-bank=\fP\fIURL\fP +\fB\-b\fP \fIURL\fP | \fB–bank=\fP\fIURL\fP URL at which the bank is operation. Conflicts with \fB\-s\fP\&. .TP -\fB\-C\fP \fIACCOUNT\fP | \fB\-\-credit=\fP\fIACCOUNT\fP +\fB\-C\fP \fIACCOUNT\fP | \fB–credit=\fP\fIACCOUNT\fP When doing a wire transfer from the exchange, the money should be credited to \fIACCOUNT\fP\&. Specifies the payto:// URI of the account. Can also be used as a filter by credit account when looking at transaction histories. .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the given configuration file. .TP -\fB\-D\fP \fIACCOUNT\fP | \fB\-\-debit=\fP\fIACCOUNT\fP +\fB\-D\fP \fIACCOUNT\fP | \fB–debit=\fP\fIACCOUNT\fP When doing a wire transfer to the exchange, the \fIACCOUNT\fP is to be debited. Specifies the payto:// URI of the account. Can also be used as a filter by debit account when looking at transaction histories. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-credit\-history\fP +\fB\-i\fP | \fB–credit\-history\fP Obtain credit history of the exchange. Conflicts with \fB\-o\fP\&. .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\-o\fP | \fB\-\-debit\-history\fP +\fB\-o\fP | \fB–debit\-history\fP Obtain debit history of the exchange. Conflicts with \fB\-i\fP\&. .TP -\fB\-p\fP \fIPASSPHRASE\fP | \fB\-\-pass=\fP\fIPASSPHRASE\fP +\fB\-p\fP \fIPASSPHRASE\fP | \fB–pass=\fP\fIPASSPHRASE\fP Specifies the pass phrase for authentication. Conflicts with \fB\-s\fP\&. .TP -\fB\-S\fP \fISUBJECT\fP | \fB\-\-subject=\fP\fISUBJECT\fP +\fB\-S\fP \fISUBJECT\fP | \fB–subject=\fP\fISUBJECT\fP Use \fISUBJECT\fP for the wire transfer subject. Must be a reserve public key for credit operations and a wire transfer identifier for debit operations. If not specified, a random value will be generated instead. .TP -\fB\-s\fP \fIACCOUNT_SECTION\fP | \fB\-\-section=\fP\fIACCOUNT\-SECTION\fP +\fB\-s\fP \fIACCOUNT_SECTION\fP | \fB–section=\fP\fIACCOUNT\-SECTION\fP Obtain exchange account information from the \fIACCOUNT\-SECTION\fP of the configuration. The argument must be a \fB[exchange\-accountcredentials\-$NAME]\fP section name and thus start with the \fBexchange\-accountcredentials\-\fP prefix. Conflicts with \fB\-u\fP, \fB\-p\fP and \fB\-b\fP\&. Note that either \fB\-b\fP or \fB\-s\fP must be specified. .TP -\fB\-u\fP \fIUSERNAME\fP | \fB\-\-user=\fP\fIUSERNAME\fP +\fB\-u\fP \fIUSERNAME\fP | \fB–user=\fP\fIUSERNAME\fP Specifies the username for authentication. Optional and conflicts with \fB\-s\fP\&. If neither \fB\-u\fP nor \fB\-s\fP are used, we will attempt to talk to the bank without authentication. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .TP -\fB\-w\fP \fIROW\fP | \fB\-\-since\-when=\fP\fIROW\fP +\fB\-w\fP \fIROW\fP | \fB–since\-when=\fP\fIROW\fP Specifies a \fIROW\fP from which the history should be obtained. If not given, the 10 youngest transactions are returned. .UNINDENT .SH SEE ALSO .sp -taler\-bank\-manage(1), taler.conf(5), \fI\%https://docs.taler.net/core/api\-wire.html#wire\-transfer\-test\-apis\fP +taler.conf(5), \fI\%https://docs.taler.net/core/api\-wire.html#wire\-transfer\-test\-apis\fP .SH BUGS .sp Report bugs by using \fI\%https://bugs.taler.net/\fP or by sending electronic @@ -141,6 +141,6 @@ mail to <\fI\%taler@gnu.org\fP> .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-exchange-wirewatch.1 b/man/taler-exchange-wirewatch.1 index ef19315f..414cfb86 100644 --- a/man/taler-exchange-wirewatch.1 +++ b/man/taler-exchange-wirewatch.1 @@ -27,21 +27,21 @@ 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-EXCHANGE-WIREWATCH" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-WIREWATCH" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-wirewatch \- watch for incoming wire transfers .SH SYNOPSIS .sp \fBtaler\-exchange\-wirewatch\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-I**_|_\fP\-\-ignore\-not\-found**] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-r\fP\ |\ \fB\-\-reset\fP] -[\fB\-T\fP\ |\ \fB\-\-test\fP] -[\fB\-t\fP\ \fIPLUGINNAME\fP\ |\ \fB\-\-type=\fP\fIPLUGINNAME\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-I**_|_\fP–ignore\-not\-found**] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-r\fP\ |\ \fB–reset\fP] +[\fB\-T\fP\ |\ \fB–test\fP] +[\fB\-t\fP\ \fIPLUGINNAME\fP\ |\ \fB–type=\fP\fIPLUGINNAME\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-wirewatch\fP is a command\-line tool to import wire @@ -50,40 +50,40 @@ transactions into the Taler exchange database. Its options are as follows: .INDENT 0.0 .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 exchange to operate from \fIFILENAME\fP\&. .TP -\fB\-f\fP \fIDELAY\fP| \fB\-\-longpoll\-timeout=\fP\fIDELAY\fP +\fB\-f\fP \fIDELAY\fP| \fB–longpoll\-timeout=\fP\fIDELAY\fP How long do we wait for a response for bank transactions from the bank. This is both the timeout for the long polling as well as the maximum frequency at which we would query the bank. Specified with unit (e.g. 30s, 1d, 2w), if no unit is given the number is interpreted in microseconds. Default is 60s. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-I\fP | \fB\-\-ignore\-not\-found\fP +\fB\-I\fP | \fB–ignore\-not\-found\fP Do not fail if the bank says that the exchange bank account does not (yet) exist. Keep trying. .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\-r\fP | \fB\-\-reset\fP +\fB\-r\fP | \fB–reset\fP Ignore our own database and start with transactions from the beginning of time. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode and exit when idle. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -96,6 +96,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-fakebank-run.1 b/man/taler-fakebank-run.1 index 9a767d3c..d10e2245 100644 --- a/man/taler-fakebank-run.1 +++ b/man/taler-fakebank-run.1 @@ -27,53 +27,53 @@ 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-FAKEBANK-RUN" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-FAKEBANK-RUN" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-fakebank-run \- run in-memory bank service for testing and benchmarking .SH SYNOPSIS .sp \fBtaler\-fakebank\-run\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\-n\fP\ \fIN\fP\ |\ \fB\-\-num\-threads=\fP\fIN\fP] -[\fB\-s\fP\ \fIAMOUNT\fP\ |\ \fB\-\-signup\-bonus=\fP\fIAMOUNT\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-n\fP\ \fIN\fP\ |\ \fB–num\-threads=\fP\fIN\fP] +[\fB\-s\fP\ \fIAMOUNT\fP\ |\ \fB–signup\-bonus=\fP\fIAMOUNT\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp -\fBtaler\-fakebank\-run\fP is a command\-line tool to run a Taler \(dqbank\(dq API (HTTP REST service). The program is useful to provide the bank functionality for benchmarking or testing when LibEuFin is unavailable or otherwise unsuitable. +\fBtaler\-fakebank\-run\fP is a command\-line tool to run a Taler “bank” API (HTTP REST service). The program is useful to provide the bank functionality for benchmarking or testing when LibEuFin is unavailable or otherwise unsuitable. .sp It should be noted that the fakebank will keep a configured number of transactions in memory. If the number of transactions exceeds the configured memory limit, the fakebank will simply discard and overwrite the old entries. At that point, any requests involving such overwritten transactions will fail. Users of the fakebank are responsible for ensuring that the transaction history kept in memory is long enough for the purpose the bank is used for. The default limit is 128k entries. .sp Its options are as follows: .INDENT 0.0 .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 \fB\-f\fP 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\-n\fP \fIN\fP | \fB\-\-num\-threads=\fP\fIN\fP +\fB\-n\fP \fIN\fP | \fB–num\-threads=\fP\fIN\fP Use \fIN\fP threads in the thread pool. .TP -\fB\-s\fP \fIAMOUNT\fP | \fB\-\-signup\-bonus=\fP\fIAMOUNT\fP +\fB\-s\fP \fIAMOUNT\fP | \fB–signup\-bonus=\fP\fIAMOUNT\fP Credit newly registered accounts with a balance of \fIAMOUNT\fP\&. Unlike other banks, this initial balance will be created out of thin air and not via a wire transfer from some bank\-internal account. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -86,6 +86,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-helper-auditor-aggregation.1 b/man/taler-helper-auditor-aggregation.1 index 558dc77b..f27b2c2a 100644 --- a/man/taler-helper-auditor-aggregation.1 +++ b/man/taler-helper-auditor-aggregation.1 @@ -27,20 +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-HELPER-AUDITOR-AGGREGATION" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-AGGREGATION" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-aggregation \- audit Taler exchange aggregation activity .SH SYNOPSIS .sp \fBtaler\-helper\-auditor\-aggregation\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fBi\fP\ |\ \fB\-\-internal\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIKEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fBi\fP\ |\ \fB–internal\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP\fIKEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-helper\-auditor\-aggregation\fP is a command\-line tool to @@ -51,32 +51,32 @@ FIXME: More detail. Its options are as follows: .INDENT 0.0 .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 auditor to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Perform checks only applicable for exchange\-internal audits. .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\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Use \fIKEY\fP (Crockford base32 encoded) as the public key of the exchange. .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 SEE ALSO @@ -89,6 +89,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-helper-auditor-coins.1 b/man/taler-helper-auditor-coins.1 index 8b06c487..1257b69d 100644 --- a/man/taler-helper-auditor-coins.1 +++ b/man/taler-helper-auditor-coins.1 @@ -27,20 +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-HELPER-AUDITOR-COINS" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-COINS" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-coins \- audit Taler coin processing .SH SYNOPSIS .sp \fBtaler\-helper\-auditor\-coins\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fBi\fP\ |\ \fB\-\-internal\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIKEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fBi\fP\ |\ \fB–internal\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP\fIKEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-helper\-auditor\-coins\fP is a command\-line tool to @@ -51,32 +51,32 @@ FIXME: More detail. Its options are as follows: .INDENT 0.0 .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 auditor to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Perform checks only applicable for exchange\-internal audits. .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\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Use \fIKEY\fP (Crockford base32 encoded) as the public key of the exchange. .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 SEE ALSO @@ -89,6 +89,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-helper-auditor-deposits.1 b/man/taler-helper-auditor-deposits.1 index e0cc2aa9..4922077f 100644 --- a/man/taler-helper-auditor-deposits.1 +++ b/man/taler-helper-auditor-deposits.1 @@ -27,20 +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-HELPER-AUDITOR-DEPOSITS" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-DEPOSITS" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-deposits \- audit Taler exchange database for deposit confirmation consistency .SH SYNOPSIS .sp \fBtaler\-helper\-auditor\-deposits\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fBi\fP\ |\ \fB\-\-internal\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIKEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fBi\fP\ |\ \fB–internal\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP\fIKEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-helper\-auditor\-deposits\fP is a command\-line tool to @@ -51,32 +51,32 @@ FIXME: More detail. Its options are as follows: .INDENT 0.0 .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 auditor to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Perform checks only applicable for exchange\-internal audits. .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\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Use \fIKEY\fP (Crockford base32 encoded) as the public key of the exchange. .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 SEE ALSO @@ -89,6 +89,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-helper-auditor-purses.1 b/man/taler-helper-auditor-purses.1 index b5753eda..d97ec893 100644 --- a/man/taler-helper-auditor-purses.1 +++ b/man/taler-helper-auditor-purses.1 @@ -27,20 +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-HELPER-AUDITOR-PURSES" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-PURSES" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-purses \- audit Taler exchange purse handling .SH SYNOPSIS .sp \fBtaler\-helper\-auditor\-purses\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fBi\fP\ |\ \fB\-\-internal\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIKEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fBi\fP\ |\ \fB–internal\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP\fIKEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-helper\-auditor\-purses\fP is a command\-line tool to @@ -51,32 +51,32 @@ FIXME: More detail. Its options are as follows: .INDENT 0.0 .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 auditor to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Perform checks only applicable for exchange\-internal audits. .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\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Use \fIKEY\fP (Crockford base32 encoded) as the public key of the exchange. .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 SEE ALSO @@ -89,6 +89,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-helper-auditor-reserves.1 b/man/taler-helper-auditor-reserves.1 index 14d43e12..98c94584 100644 --- a/man/taler-helper-auditor-reserves.1 +++ b/man/taler-helper-auditor-reserves.1 @@ -27,20 +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-HELPER-AUDITOR-RESERVES" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-RESERVES" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-reserves \- audit Taler exchange reserve handling .SH SYNOPSIS .sp \fBtaler\-helper\-auditor\-reserves\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fBi\fP\ |\ \fB\-\-internal\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIKEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fBi\fP\ |\ \fB–internal\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP\fIKEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-helper\-auditor\-reserves\fP is a command\-line tool to @@ -51,32 +51,32 @@ FIXME: More detail. Its options are as follows: .INDENT 0.0 .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 auditor to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Perform checks only applicable for exchange\-internal audits. .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\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Use \fIKEY\fP (Crockford base32 encoded) as the public key of the exchange. .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 SEE ALSO @@ -89,6 +89,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-helper-auditor-wire.1 b/man/taler-helper-auditor-wire.1 index c081ee79..d90d3279 100644 --- a/man/taler-helper-auditor-wire.1 +++ b/man/taler-helper-auditor-wire.1 @@ -27,56 +27,56 @@ 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-HELPER-AUDITOR-WIRE" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-WIRE" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-wire \- audit exchange database for consistency with the bank's wire transfers .SH SYNOPSIS .sp \fBtaler\-helper\-auditor\-wire\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fBi\fP\ |\ \fB\-\-internal\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIKEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fBi\fP\ |\ \fB–internal\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP\fIKEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-helper\-auditor\-wire\fP is a command\-line tool to -audit exchange database for consistency with the bank\(aqs wire transfers. +audit exchange database for consistency with the bank’s wire transfers. .sp FIXME: More detail. .sp Its options are as follows: .INDENT 0.0 .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 auditor to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Perform checks only applicable for exchange\-internal audits. .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\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Use \fIKEY\fP (Crockford base32 encoded) as the public key of the exchange. .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 SEE ALSO @@ -89,6 +89,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-mdb.1 b/man/taler-mdb.1 index 93fbdac3..91b7cb4c 100644 --- a/man/taler-mdb.1 +++ b/man/taler-mdb.1 @@ -27,21 +27,21 @@ 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-MDB" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MDB" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-mdb \- operate multi drop bus (MDB) based vending machines with Taler payments .SH SYNOPSIS .sp \fBtaler\-mdb\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-d\fP\ |\ \fB\-\-disable\-mdb\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-i\fP\ |\ \fB\-\-backlight\-invert\fP] -[\fB\-L\fP _*LOGLEVEL*\ |\ \fB\-\-log=\fP\fILOGLEVEL\fP] -[\fB\-l\fP _*FILENAME*\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-s\fP\ |\ \fB\-\-enable\-soldout\fP] -[\fB\-t\fP\ |\ \fB\-\-disable\-tty\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-d\fP\ |\ \fB–disable\-mdb\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-i\fP\ |\ \fB–backlight\-invert\fP] +[\fB\-L\fP _*LOGLEVEL*\ |\ \fB–log=\fP\fILOGLEVEL\fP] +[\fB\-l\fP _*FILENAME*\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-s\fP\ |\ \fB–enable\-soldout\fP] +[\fB\-t\fP\ |\ \fB–disable\-tty\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-mdb\fP is a command\-line tool to operate a vending machine using GNU Taler for payments. @@ -49,29 +49,29 @@ taler-mdb \- operate multi drop bus (MDB) based vending machines with Taler paym Its options are as follows: .INDENT 0.0 .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 Sync commands to operate from \fIFILENAME\fP\&. .TP -\fB\-d\fP | \fB\-\-disable\-mdb\fP +\fB\-d\fP | \fB–disable\-mdb\fP Disable interaction with the MDB bus (for testing). .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-backlight\-invert\fP +\fB\-i\fP | \fB–backlight\-invert\fP Invert the bit for turning on/off the backlight. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-log=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–log=\fP\fILOGLEVEL\fP Configure logging to use \fILOGLEVEL\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Configure logging to write logs to \fIFILENAME\fP\&. .TP -\fB\-s\fP | \fB\-\-enable\-soldout\fP -When the machine fails to dispense a product, internally set the product to \(dqsold out\(dq and refuse future orders until restarted. +\fB\-s\fP | \fB–enable\-soldout\fP +When the machine fails to dispense a product, internally set the product to “sold out” and refuse future orders until restarted. .TP -\fB\-t\fP | \fB\-\-disable\-tty\fP +\fB\-t\fP | \fB–disable\-tty\fP Disable interactive command\-line use. .TP \fB\-v\fP | \fB–version\fP @@ -87,6 +87,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-benchmark.1 b/man/taler-merchant-benchmark.1 index 88afaa92..a43632f8 100644 --- a/man/taler-merchant-benchmark.1 +++ b/man/taler-merchant-benchmark.1 @@ -27,7 +27,7 @@ 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-BENCHMARK" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-BENCHMARK" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-benchmark \- generate Taler-style benchmarking payments .SH SYNOPSIS @@ -46,7 +46,7 @@ default instance) and aggregated by the exchange. Takes the following option: .INDENT 7.0 .TP -\fB\-p\fP \fIPN\fP | \fB\-\-payments\-number=\fP\fIPN\fP +\fB\-p\fP \fIPN\fP | \fB–payments\-number=\fP\fIPN\fP Perform PN many payments, defaults to 1. .UNINDENT .TP @@ -56,11 +56,11 @@ leaving payments unaggregated, or using a non\-default merchant instance. Takes the following options: .INDENT 7.0 .TP -\fB\-t\fP \fITC\fP | \fB\-\-two\-coins=\fP\fITC\fP +\fB\-t\fP \fITC\fP | \fB–two\-coins=\fP\fITC\fP Perform TC many payments that use two coins (normally, all the payments use only one coin). TC defaults to 1. .TP -\fB\-u\fP \fIUN\fP | \fB\-\-unaggregated\-number=\fP\fIUN\fP +\fB\-u\fP \fIUN\fP | \fB–unaggregated\-number=\fP\fIUN\fP Generate UN payments that will be left unaggregated. Note that subsequent invocations of the generator may pick those unaggregated payments and actually aggregated them. @@ -69,27 +69,27 @@ unaggregated payments and actually aggregated them. .SH COMMON OPTIONS .INDENT 0.0 .TP -\fB\-a\fP \fIAPIKEY\fP | \fB\-\-apikey=\fP\fIAPIKEY\fP -HTTP \(aqAuthorization\(aq header to send to the merchant. +\fB\-a\fP \fIAPIKEY\fP | \fB–apikey=\fP\fIAPIKEY\fP +HTTP ‘Authorization’ header to send to the merchant. .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\-u\fP \fISECTION\fP | \fB\-\-exchange\-account\-section=\fP\fISECTION\fP +\fB\-u\fP \fISECTION\fP | \fB–exchange\-account\-section=\fP\fISECTION\fP Configuration \fISECTION\fP specifying the exchange account to use. .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\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO @@ -102,6 +102,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-dbconfig.1 b/man/taler-merchant-dbconfig.1 index a7b641e8..82d7dc2c 100644 --- a/man/taler-merchant-dbconfig.1 +++ b/man/taler-merchant-dbconfig.1 @@ -27,7 +27,7 @@ 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-DBCONFIG" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-DBCONFIG" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-dbconfig \- configure Taler merchant database .SH SYNOPSIS @@ -78,6 +78,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-dbinit.1 b/man/taler-merchant-dbinit.1 index 2a2d16c9..c2897053 100644 --- a/man/taler-merchant-dbinit.1 +++ b/man/taler-merchant-dbinit.1 @@ -27,18 +27,18 @@ 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-DBINIT" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-DBINIT" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-dbinit \- initialize Taler merchant database .SH SYNOPSIS .sp \fBtaler\-merchant\-dbinit\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\-r\fP\ |\ \fB\-\-reset\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-r\fP\ |\ \fB–reset\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-dbinit\fP is a command\-line tool to initialize the Taler @@ -48,21 +48,21 @@ Taler merchant to operate. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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\-r\fP | \fB\-\-reset\fP +\fB\-r\fP | \fB–reset\fP Drop tables. Dangerous, will delete all existing data in the database before creating the tables. .TP @@ -79,6 +79,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-depositcheck.1 b/man/taler-merchant-depositcheck.1 index 7fb5fd27..46d2ae10 100644 --- a/man/taler-merchant-depositcheck.1 +++ b/man/taler-merchant-depositcheck.1 @@ -27,20 +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-DEPOSITCHECK" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-DEPOSITCHECK" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-depositcheck \- check status of deposits with exchange .SH SYNOPSIS .sp \fBtaler\-merchant\-depositcheck\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-e\fP \fIBASE_URL\fP\ |\ \fB\-\-exchange=\fP\fIBASE_URL\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-e\fP \fIBASE_URL\fP\ |\ \fB–exchange=\fP\fIBASE_URL\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-depositcheck\fP is a command\-line tool to inquire with exchanges about whether they completed @@ -51,34 +51,34 @@ a wire transfer. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .TP -\fB\-e\fP \fIBASE_URL\fP | \fB\-\-exchange=\fP\fIBASE_URL\fP -Base URL of the exchange to monitor. If not given, a worker process will be spawned for each exchange in the configuration (\(dqmerchant\-exchange\-\(dq sections). +\fB\-e\fP \fIBASE_URL\fP | \fB–exchange=\fP\fIBASE_URL\fP +Base URL of the exchange to monitor. If not given, a worker process will be spawned for each exchange in the configuration (“merchant\-exchange\-” sections). .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\-s\fP \fISECTION\fP | \fB\-\-section=\fP\fISECTION\fP +\fB\-s\fP \fISECTION\fP | \fB–section=\fP\fISECTION\fP Configuration section to use. Default is taler\-merchant\-depositcheck. Needed if different processes are used to watch multiple bank accounts (for the same instance or different instances). .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode. Only runs until the current list of bank transactions are all imported. .TP @@ -95,6 +95,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-exchange.1 b/man/taler-merchant-exchange.1 index 818a21dd..ab138da0 100644 --- a/man/taler-merchant-exchange.1 +++ b/man/taler-merchant-exchange.1 @@ -27,23 +27,23 @@ 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-EXCHANGE" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-EXCHANGE" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-exchange \- ask exchange which deposits were aggregated for a particular wire transfer that credited a merchant account .SH SYNOPSIS .sp \fBtaler\-merchant\-exchange\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-exchange\fP is a background job that reconciles -wire transfers that credit the merchant\(aqs bank account with +wire transfers that credit the merchant’s bank account with the respective contracts that have been paid by asking the exchange to provide a list of all deposits that were aggregated into a wire transfer. @@ -54,26 +54,26 @@ validate that the exchange paid the merchant correctly. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode. Only runs until the current list of bank transactions have all been checked. .TP @@ -90,6 +90,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-httpd.1 b/man/taler-merchant-httpd.1 index 1a34057c..34865889 100644 --- a/man/taler-merchant-httpd.1 +++ b/man/taler-merchant-httpd.1 @@ -27,20 +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" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-HTTPD" "1" "Apr 12, 2024" "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 \(dqsecret\-token:\(dq 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. \(dqAuthorization: Bearer TOKEN\(dq 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 \(dqpchar\(dq 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 \(dq\-a\(dq 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 @@ -113,6 +113,6 @@ electronic mail to <\fI\%taler@gnu.org\fP> .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-passwd.1 b/man/taler-merchant-passwd.1 index 4ecccf95..7772cf9e 100644 --- a/man/taler-merchant-passwd.1 +++ b/man/taler-merchant-passwd.1 @@ -27,18 +27,18 @@ 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-PASSWD" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-PASSWD" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-passwd \- change Taler merchant instance password .SH SYNOPSIS .sp \fBtaler\-merchant\-passwd\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\-i**_*NAME*\ |\ **\-\-instance\fP\fINAME\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-i**_*NAME*\ |\ **–instance\fP\fINAME\fP] +[\fB\-v\fP\ |\ \fB–version\fP] [PASSWORD] .SH DESCRIPTION .sp @@ -50,22 +50,22 @@ environment variable. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP \fINAME\fP | \fB\-\-instance\fP\fINAME\fP +\fB\-i\fP \fINAME\fP | \fB–instance\fP\fINAME\fP Specifies the name of the instance for which the password should be -updated. If not given, the \(dqdefault\(dq instance is modified. +updated. If not given, the “default” instance is modified. .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\-v\fP | \fB–version\fP @@ -81,6 +81,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-webhook.1 b/man/taler-merchant-webhook.1 index 7e132b61..4fe1ba92 100644 --- a/man/taler-merchant-webhook.1 +++ b/man/taler-merchant-webhook.1 @@ -27,19 +27,19 @@ 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-WEBHOOK" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-WEBHOOK" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-webhook \- execute webhooks of the Taler merchant backend (optional service) .SH SYNOPSIS .sp \fBtaler\-merchant\-webhook\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\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-webhook\fP is a command\-line tool to trigger webhooks @@ -49,26 +49,26 @@ requests and updates the Taler merchant database accordingly. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode. Only runs until there are no more webhooks to be executed. .TP @@ -85,6 +85,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-merchant-wirewatch.1 b/man/taler-merchant-wirewatch.1 index 8905de9e..434061ba 100644 --- a/man/taler-merchant-wirewatch.1 +++ b/man/taler-merchant-wirewatch.1 @@ -27,20 +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-WIREWATCH" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-WIREWATCH" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-wirewatch \- import credit transactions from a merchant bank account into merchant backend (optional) .SH SYNOPSIS .sp \fBtaler\-merchant\-wirewatch\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\-p\fP\ |\ \fB\-\-persist\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel\fP\fIUSEC\fP] -[\fB\-t\fP\ |\ \fB\-\-test\fP] -[\fB\-v\fP\ |\ \fB\-\-version\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\-p\fP\ |\ \fB–persist\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel\fP\fIUSEC\fP] +[\fB\-t\fP\ |\ \fB–test\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-wirewatch\fP is a command\-line tool to import @@ -51,34 +51,34 @@ the exchange paid the merchant correctly. Its options are as follows: .INDENT 0.0 .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 \fIFILENAME\fP\&. .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\-p\fP | \fB\-\-persist\fP +\fB\-p\fP | \fB–persist\fP Run in persist mode. Does not exit when the account configuration changes. Useful when not running under systemd. .TP -\fB\-s\fP \fISECTION\fP | \fB\-\-section=\fP\fISECTION\fP +\fB\-s\fP \fISECTION\fP | \fB–section=\fP\fISECTION\fP Configuration section to use. Default is taler\-merchant\-wirewatch. Needed if different processes are used to watch multiple bank accounts (for the same instance or different instances). .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\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode. Only runs until the current list of bank transactions are all imported. .TP @@ -95,6 +95,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-terms-generator.1 b/man/taler-terms-generator.1 index b630aa7d..1fa588b1 100644 --- a/man/taler-terms-generator.1 +++ b/man/taler-terms-generator.1 @@ -27,7 +27,7 @@ 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-TERMS-GENERATOR" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-TERMS-GENERATOR" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-terms-generator \- create legal policy documents for services .SH SYNOPSIS @@ -46,7 +46,7 @@ taler-terms-generator \- create legal policy documents for services .TP \fBtaler\-terms\-generator\fP is a command\-line tool to create terms of service and privacy policy files in various file formats and languages from a -reStructuredText (\(dq.rst\(dq) input. It can be used to generate the responses +reStructuredText (“.rst”) input. It can be used to generate the responses various GNU Taler services serve under the \fB/terms\fP and \fB/pp\fP endpoints. .TP \fB\-a\fP \fIAUTHOR\fP @@ -55,26 +55,26 @@ set the author information to the given AUTHOR in the meta\-data of various gene \fB\-C\fP \fICOPYRIGHT\fP set the copyright information to the given COPYRIGHT in the meta\-data of various generated outputs. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Prints a compiled\-in help text. .TP \fB\-i\fP \fIINPUT\fP Name of the input (.rst) file with the terms of service or privacy policy to convert. .TP \fB\-l\fP \fILANGUAGE\fP -Add the given \fILANGUAGE\fP to the list of translations for the current \fIINPUT\fP\&. \fILANGUAGE\fP must be a two\-letter language code (like \(dqde\(dq or \(dqit\(dq). This will generate or update the respective \(dq.po\(dq files to translate the \fIINPUT\fP terms to this \fILANGUAGE\fP\&. +Add the given \fILANGUAGE\fP to the list of translations for the current \fIINPUT\fP\&. \fILANGUAGE\fP must be a two\-letter language code (like “de” or “it”). This will generate or update the respective “.po” files to translate the \fIINPUT\fP terms to this \fILANGUAGE\fP\&. .TP \fB\-L\fP \fILOCALE_DIR\fP -Specify locale/ directory where GNU gettext resources for translating the input are located. If \(dq\-l\(dq is given, this directory is where fresh or updated \(dq.po\(dq files will be placed, and otherwise this directory will be scanned for translations of the \(dq.rst\(dq input file. +Specify locale/ directory where GNU gettext resources for translating the input are located. If “\-l” is given, this directory is where fresh or updated “.po” files will be placed, and otherwise this directory will be scanned for translations of the “.rst” input file. .TP \fB\-o\fP \fIOUTPUT\fP Specifies where to write the output. This should be the directory where the service expects to find the generated resources. Unless you changed the default configuration, you probably do not have to specify this value. .TP \fB\-p\fP \fIPAPER\fP -Specifies the paper format for generated PDF documents. Can be \(dqa4\(dq or \(dqletter\(dq. +Specifies the paper format for generated PDF documents. Can be “a4” or “letter”. .TP \fB\-t\fP \fITITLE\fP -Overrides the document title. By default, the title will be set to the contents of the first line of the \fIINPUT\fP \(dq.rst\(dq file. +Overrides the document title. By default, the title will be set to the contents of the first line of the \fIINPUT\fP “.rst” file. .UNINDENT .SH SEE ALSO .sp @@ -86,6 +86,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler-unified-setup.1 b/man/taler-unified-setup.1 index b535e794..ff6f7d77 100644 --- a/man/taler-unified-setup.1 +++ b/man/taler-unified-setup.1 @@ -27,7 +27,7 @@ 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-UNIFIED-SETUP" "1" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER-UNIFIED-SETUP" "1" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler-unified-setup \- conveniently start and stop various GNU Taler services .SH SYNOPSIS @@ -68,7 +68,7 @@ Start backup/sync service (Mandatory) Use CONFIG_FILENAME. .TP \fB\-d\fP \fIMETHOD\fP -use the given wire method. Default is \(aqx\-taler\-bank\(aq. +use the given wire method. Default is ‘x\-taler\-bank’. .TP \fB\-e\fP Start exchange @@ -79,7 +79,7 @@ Start fakebank \fB\-g\fP Start aggregator .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Prints a compiled\-in help text. .TP \fB\-k\fP @@ -124,6 +124,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/man/taler.conf.5 b/man/taler.conf.5 index 3ca1d3c4..85856dd4 100644 --- a/man/taler.conf.5 +++ b/man/taler.conf.5 @@ -27,7 +27,7 @@ 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.CONF" "5" "Mar 07, 2024" "0.9" "GNU Taler" +.TH "TALER.CONF" "5" "Apr 12, 2024" "0.9" "GNU Taler" .SH NAME taler.conf \- Taler configuration file .SH DESCRIPTION @@ -130,7 +130,7 @@ Name of the currency, e.g.\ “EUR” for Euro. .TP .B CURRENCY_ROUND_UNIT Smallest amount in this currency that can be transferred using the -underlying RTGS. For example: \(dqEUR:0.01\(dq or \(dqJPY:1\(dq. +underlying RTGS. For example: “EUR:0.01” or “JPY:1”. .UNINDENT .sp The “[PATHS]” section is special in that it contains paths that can be @@ -160,7 +160,7 @@ sockets). Usually “${TMP}/taler\-system\-runtime”. .UNINDENT .SS CURRENCY SPECIFICATIONS .sp -Sections with a name of the form “[currency\-$NAME]” (where \(dq$NAME\(dq could +Sections with a name of the form “[currency\-$NAME]” (where “$NAME” could be any unique string) are used to specify details about how currencies should be handled (and in particularly rendered) by the user interface. A detailed motivation for this section can be found in DD51. @@ -206,10 +206,10 @@ JSON map determining how to encode very large or very tiny amounts in this currency. Maps a base10 logarithm to the respective currency symbol. Must include at least an entry for 0 (currency unit). For example, use -{\(dq0\(dq:\(dq€\(dq} for Euros or \(dq{\(dq0\(dq:\(dq$\(dq} for Dollars. You could -additionally use {\(dq0\(dq:\(dq€\(dq,\(dq3\(dq:\(dqk€\(dq} to render 3000 EUR +{“0”:”€”} for Euros or “{“0”:”$”} for Dollars. You could +additionally use {“0”:”€”,”3”:”k€”} to render 3000 EUR as 3k€. For BTC a typical map would be -{\(dq0\(dq:\(dqBTC\(dq,\(dq\-3\(dq:\(dqmBTC\(dq}, informing the UI to render small +{“0”:”BTC”,”\-3”:”mBTC”}, informing the UI to render small amounts in milli\-Bitcoin (mBTC). .UNINDENT .SS EXCHANGE OPTIONS @@ -222,29 +222,29 @@ exchange tools. Plugin to use for the database, e.g.\ “postgres”. .TP .B SERVE -Should the HTTP server listen on a UNIX domain socket (set option to \(dqunix\(dq) or on a TCP socket (set option to \(dqtcp\(dq)? +Should the HTTP server listen on a UNIX domain socket (set option to “unix”) or on a TCP socket (set option to “tcp”)? .TP .B UNIXPATH -Path to listen on if we \(dqSERVE\(dq is set to \(dqunix\(dq. +Path to listen on if we “SERVE” is set to “unix”. .TP .B UNIXPATH_MODE -Access permission mask to use for the \(dqUNIXPATH\(dq. +Access permission mask to use for the “UNIXPATH”. .TP .B PORT Port on which the HTTP server listens, e.g.\ 8080. .TP .B BIND_TO -Hostname to which the exchange HTTP server should be bound to, e.g. \(dqlocalhost\(dq. +Hostname to which the exchange HTTP server should be bound to, e.g. “localhost”. .TP .B MASTER_PUBLIC_KEY Crockford Base32\-encoded master public key, public version of the -exchange\(aqs long\-time offline signing key. This configuration option +exchange’s long\-time offline signing key. This configuration option is also used by the \fBauditor\fP to determine the public key of the exchange which it is auditing. .TP .B AML_THRESHOLD Largest amount in this currency that can be transferred per month without -an AML staff member doing a (manual) AML check. For example: \(dqUSD:1000000\(dq. +an AML staff member doing a (manual) AML check. For example: “USD:1000000”. .TP .B KYC_AML_TRIGGER Program to run on KYC attribute data to decide whether we should immediately flag an account for AML review. Program must return 0 if a manual AML review is not needed, and non\-zero to trigger an AML review. The KYC attribute data of the new user will be passed on standard\-input. @@ -271,9 +271,9 @@ Used by the KYC logic when interacting with OAuth 2.0. .TP .B TOPLEVEL_REDIRECT_URL Where to redirect visitors that access the top\-level -\(dq/\(dq endpoint of the exchange. Should point users to +“/” endpoint of the exchange. Should point users to information about the exchange operator. -Optional setting, defaults to \(dq/terms\(dq. +Optional setting, defaults to “/terms”. .TP .B AGGREGATOR_IDLE_SLEEP_INTERVAL For how long should the taler\-exchange\-aggregator sleep when it is idle @@ -292,7 +292,7 @@ For how long should the taler\-exchange\-wirewatch sleep when it is idle before trying to look for more work? Default is 60 seconds. .TP .B AGGREGATOR_SHARD_SIZE -Which share of the range from [0,..2147483648] should be processed by one of the shards of the aggregator. Useful only for Taler exchanges with ultra high\-performance needs. When changing this value, you must stop all aggregators and run \(dqtaler\-exchange\-dbinit \-s\(dq before resuming. Default is 2147483648 (no sharding). +Which share of the range from [0,..2147483648] should be processed by one of the shards of the aggregator. Useful only for Taler exchanges with ultra high\-performance needs. When changing this value, you must stop all aggregators and run “taler\-exchange\-dbinit \-s” before resuming. Default is 2147483648 (no sharding). .TP .B SIGNKEY_LEGAL_DURATION For how long are signatures with signing keys legally valid? @@ -306,12 +306,12 @@ How many requests should the HTTP server process at most before committing suici .B TERMS_DIR Directory where the terms of service of the exchange operator can be fund. The directory must contain sub\-directories for every supported language, -using the two\-character language code in lower case, e.g. \(dqen/\(dq or \(dqfr/\(dq. +using the two\-character language code in lower case, e.g. “en/” or “fr/”. Each subdirectory must then contain files with the terms of service in various formats. The basename of the file of the current policy must be specified under \fBTERMS_ETAG\fP\&. The extension defines the mime type. -Supported extensions include \(dqhtml\(dq, \(dqhtm\(dq, \(dqtxt\(dq, \(dqpdf\(dq, \(dqjpg\(dq, \(dqjpeg\(dq, -\(dqpng\(dq and \(dqgif\(dq. For example, using a \fBTERMS_ETAG\fP of \(dq0\(dq, the structure +Supported extensions include “html”, “htm”, “txt”, “pdf”, “jpg”, “jpeg”, +“png” and “gif”. For example, using a \fBTERMS_ETAG\fP of “0”, the structure could be the following: .INDENT 7.0 .IP \(bu 2 @@ -330,7 +330,7 @@ $TERMS_DIR/de/0.txt .TP .B TERMS_ETAG Basename of the file(s) in the \fBTERMS_DIR\fP with the current terms of service. -The value is also used for the \(dqEtag\(dq in the HTTP request to control +The value is also used for the “Etag” in the HTTP request to control caching. Whenever the terms of service change, the \fBTERMS_ETAG\fP MUST also change, and old values MUST NOT be repeated. For example, the date or version number of the terms of service SHOULD be used for the Etag. If @@ -346,7 +346,7 @@ Works the same as \fBTERMS_ETAG\fP, just for the privacy policy. .UNINDENT .SS EXCHANGE KYC PROVIDER OPTIONS .sp -The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections. +The following options must be in the section “[kyc\-provider\-XXX]” sections. .INDENT 0.0 .TP .B COST @@ -363,20 +363,20 @@ List of checks performed by this provider. Space\-separated names of checks, mus .UNINDENT .SS EXCHANGE KYC OAUTH2 OPTIONS .sp -The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections with \(dqLOGIC = oauth2\(dq. +The following options must be in the section “[kyc\-provider\-XXX]” sections with “LOGIC = oauth2”. .INDENT 0.0 .TP .B KYC_OAUTH2_VALIDITY -Duration (e.g. \(dq12 months\(dq) of the validity of the performed KYC check. Can be \(dqforever\(dq. +Duration (e.g. “12 months”) of the validity of the performed KYC check. Can be “forever”. .TP .B KYC_OAUTH2_AUTHORIZE_URL -URL of the OAuth2 endpoint to be used for KYC checks. The authorize URL is where the exchange will redirect the client to begin the authorization process. Example: \(dq\fI\%http://localhost:8888/oauth/v2/authorize\fP\(dq. To use the plugin in combination with the Challenger service\(aqs \fB/setup\fP step, append \(dq#setup\(dq, thus \(dq\fI\%https://challenger.example.com/authorize#setup\fP\(dq. Here, \(dq#setup\(dq is not a fragment but merely a hint to the logic to determine the full authorization URL via the \fB/setup/$CLIENT_ID\fP handler. +URL of the OAuth2 endpoint to be used for KYC checks. The authorize URL is where the exchange will redirect the client to begin the authorization process. Example: “\fI\%http://localhost:8888/oauth/v2/authorize\fP”. To use the plugin in combination with the Challenger service’s \fB/setup\fP step, append “#setup”, thus “\fI\%https://challenger.example.com/authorize#setup\fP”. Here, “#setup” is not a fragment but merely a hint to the logic to determine the full authorization URL via the \fB/setup/$CLIENT_ID\fP handler. .TP .B KYC_OAUTH2_TOKEN_URL -URL of the OAuth2 endpoint to be used for KYC checks. This is where the server will ultimately send the authorization token from the client and obtain its access token (which currently must be a \(dqbearer\(dq token). Example: \(dq\fI\%http://localhost:8888/oauth/v2/token\fP\(dq (or just \(dq/token\(dq) +URL of the OAuth2 endpoint to be used for KYC checks. This is where the server will ultimately send the authorization token from the client and obtain its access token (which currently must be a “bearer” token). Example: “\fI\%http://localhost:8888/oauth/v2/token\fP” (or just “/token”) .TP .B KYC_OAUTH2_INFO_URL -URL of the OAuth2\-protected resource endpoint, where the OAuth 2.0 token can be used to download information about the user that has undergone the KYC process. The exchange will use the access token obtained from the KYC_AUTH2_AUTH_URL to show that it is authorized to obtain the details. Example: \(dq\fI\%http://localhost:8888/api/user/me\fP\(dq or \(dq\fI\%http://localhost:8888/oauth/v2/info\fP\(dq +URL of the OAuth2\-protected resource endpoint, where the OAuth 2.0 token can be used to download information about the user that has undergone the KYC process. The exchange will use the access token obtained from the KYC_AUTH2_AUTH_URL to show that it is authorized to obtain the details. Example: “\fI\%http://localhost:8888/api/user/me\fP” or “\fI\%http://localhost:8888/oauth/v2/info\fP” .TP .B KYC_OAUTH2_CLIENT_ID Client ID of the exchange when it talks to the KYC OAuth2 endpoint. @@ -385,7 +385,7 @@ Client ID of the exchange when it talks to the KYC OAuth2 endpoint. Client secret of the exchange to use when talking to the KYC Oauth2 endpoint. .TP .B KYC_OAUTH2_POST_URL -URL to which the exchange will redirect the client\(aqs browser after successful authorization/login for the KYC process. Example: \(dq\fI\%http://example.com/thank\-you\fP\(dq +URL to which the exchange will redirect the client’s browser after successful authorization/login for the KYC process. Example: “\fI\%http://example.com/thank\-you\fP” .TP .B KYC_OAUTH2_CONVERTER_HELPER Helper to convert JSON with KYC data returned by the OAuth2.0 info endpoint into GNU Taler internal format. Specific to the OAuth 2.0 provider. @@ -394,15 +394,15 @@ Helper to convert JSON with KYC data returned by the OAuth2.0 info endpoint into Set to YES to allow error responses to include potentially sensitive private information (such as full responses from the OAuth 2.0 server) that might aid in debugging -problems. Should be set to \(dqNO\(dq in production. +problems. Should be set to “NO” in production. .UNINDENT .SS EXCHANGE KYC KYCAID OPTIONS .sp -The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections with \(dqLOGIC = kycaid\(dq. +The following options must be in the section “[kyc\-provider\-XXX]” sections with “LOGIC = kycaid”. .INDENT 0.0 .TP .B KYC_KYCAID_VALIDITY -Duration (e.g. \(dq12 months\(dq) of the validity of the performed KYC check. Can be \(dqforever\(dq. +Duration (e.g. “12 months”) of the validity of the performed KYC check. Can be “forever”. .TP .B KYC_KYCAID_AUTH_TOKEN Authentication token to access the KYC service. @@ -411,15 +411,15 @@ Authentication token to access the KYC service. ID that specifies the form to use for the KYC process. .TP .B KYC_KYCAID_POST_URL -URL to which the exchange will redirect the client\(aqs browser after successful authorization/login for the KYC process. +URL to which the exchange will redirect the client’s browser after successful authorization/login for the KYC process. .UNINDENT .SS EXCHANGE KYC PERSONA OPTIONS .sp -The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections with \(dqLOGIC = persona\(dq. +The following options must be in the section “[kyc\-provider\-XXX]” sections with “LOGIC = persona”. .INDENT 0.0 .TP .B KYC_PERSONA_VALIDITY -Duration (e.g. \(dq12 months\(dq) of the validity of the performed KYC check. Can be \(dqforever\(dq. +Duration (e.g. “12 months”) of the validity of the performed KYC check. Can be “forever”. .TP .B KYC_PERSONA_AUTH_TOKEN Authentication token to access the KYC service. @@ -431,17 +431,17 @@ Salt value to use for request idempotency. Optional, generated at random per pro Subdomain to use under Persona. .TP .B KYC_PERSONA_CONVERTER_HELPER -Helper to convert JSON with KYC data returned by Persona into GNU Taler internal format. Should probably always be set to \(dqtaler\-exchange\-kyc\-persona\-converter.sh\(dq. +Helper to convert JSON with KYC data returned by Persona into GNU Taler internal format. Should probably always be set to “taler\-exchange\-kyc\-persona\-converter.sh”. .TP .B KYC_PERSONA_POST_URL -URL to which the exchange will redirect the client\(aqs browser after successful authorization/login for the KYC process. +URL to which the exchange will redirect the client’s browser after successful authorization/login for the KYC process. .TP .B KYC_PERSONA_TEMPLATE_ID ID of the Persona template to use. .UNINDENT .SS EXCHANGE KYC PERSONA GLOBAL OPTIONS .sp -The following option must be in the section \(dq[kyclogic\-persona]\(dq. +The following option must be in the section “[kyclogic\-persona]”. .INDENT 0.0 .TP .B WEBHOOK_AUTH_TOKEN @@ -453,7 +453,7 @@ The functionality of the exchange can be extended by extensions. Those are shared libraries which implement the extension\-API of the exchange and are located under \fB$LIBDIR\fP, starting with prefix \fBlibtaler_extension_\fP\&. Each extension can be enabled by adding a dedicated section -\(dq[exchange\-extension\-<extensionname>]\(dq and the following option: +“[exchange\-extension\-<extensionname>]” and the following option: .INDENT 0.0 .TP .B ENABLED @@ -463,7 +463,7 @@ options might be set in the same section. .SS EXCHANGE EXTENSION FOR AGE RESTRICTION .sp The extension for age restriction support can be enabled by adding a section -\(dq[exchange\-extension\-age_restriction]\(dq with the following options: +“[exchange\-extension\-age_restriction]” with the following options: .INDENT 0.0 .TP .B ENABLE @@ -472,8 +472,8 @@ Must be set to \fBYES\fP in order to activate the extension. .B AGE_GROUPS A colon\-seperated string of increasing non\-negative integers, defining the buckets of age groups supported by the exchange. Each integer marks the -beginning of the next age group. The zero\(aqth age group implicitly starts -with 0. For example, the string \(dq10:18\(dq would define three age groups: +beginning of the next age group. The zero’th age group implicitly starts +with 0. For example, the string “10:18” would define three age groups: .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 @@ -487,7 +487,7 @@ Group 2: ages 18 and above .UNINDENT .UNINDENT .sp -If not provided, the default value is \(dq8:10:12:14:16:18:21\(dq. +If not provided, the default value is “8:10:12:14:16:18:21”. .UNINDENT .sp \fBNote\fP: Age restriction is bound to specific denominations and must be @@ -496,7 +496,7 @@ the option \fBAGE_RESTRICTED = YES\fP, see \fI\%EXCHANGE COIN OPTIONS\fP\&. Howe age groups are defined globally for all denominations. .SS EXCHANGE OFFLINE SIGNING OPTIONS .sp -The following options must be in the section \(dq[exchange\-offline]\(dq. +The following options must be in the section “[exchange\-offline]”. .INDENT 0.0 .TP .B MASTER_PRIV_FILE @@ -523,7 +523,7 @@ this option will also be ignored. .UNINDENT .SS EXCHANGE RSA CRYPTO HELPER OPTIONS .sp -The following options must be in the section \(dq[taler\-exchange\-secmod\-rsa]\(dq. +The following options must be in the section “[taler\-exchange\-secmod\-rsa]”. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -550,7 +550,7 @@ Note that the \fBtaler\-exchange\-secmod\-rsa\fP also evaluates the \fB[coin_*]\ configuration sections described below. .SS EXCHANGE CS CRYPTO HELPER OPTIONS .sp -The following options must be in the section \(dq[taler\-exchange\-secmod\-cs]\(dq. +The following options must be in the section “[taler\-exchange\-secmod\-cs]”. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -577,7 +577,7 @@ Note that the \fBtaler\-exchange\-secmod\-cs\fP also evaluates the \fB[coin_*]\f configuration sections described below. .SS EXCHANGE EDDSA CRYPTO HELPER OPTIONS .sp -The following options must be in the section \(dq[taler\-exchange\-secmod\-eddsa]\(dq. +The following options must be in the section “[taler\-exchange\-secmod\-eddsa]”. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -604,7 +604,7 @@ On which path should the security module listen for signing requests? .UNINDENT .SS EXCHANGE DATABASE OPTIONS .sp -The following options must be in the section \(dq[exchangedb]\(dq. +The following options must be in the section “[exchangedb]”. .INDENT 0.0 .TP .B IDLE_RESERVE_EXPIRATION_TIME @@ -665,7 +665,7 @@ URL of the wire gateway. Typically of the form \fBhttps://$HOSTNAME[:$PORT]/taler\-wire\-gateway/$USERNAME/\fP where $HOSTNAME is the hostname of the system running the bank (such as the Taler Python bank or the Nexus) and \fB$USERNAME\fP is -the username of the exchange\(aqs bank account (usually matching +the username of the exchange’s bank account (usually matching the \fBUSERNAME\fP option used for authentication). Example: \fBhttps://bank.demo.taler.net/taler\-wire\-gateway/Exchange/\fP\&. .TP @@ -720,12 +720,12 @@ What fee is charged for refunds? When a coin is refunded, the deposit fee is returned. Instead, the refund fee is charged to the customer. .TP .B CIPHER -What cryptosystem should be used? Must be set to either \(dqCS\(dq or \(dqRSA\(dq. +What cryptosystem should be used? Must be set to either “CS” or “RSA”. The respective crypto\-helper will then generate the keys for this denomination. .TP .B RSA_KEYSIZE -What is the RSA keysize modulos (in bits)? Only used if \(dqCIPHER=RSA\(dq. +What is the RSA keysize modulos (in bits)? Only used if “CIPHER=RSA”. .TP .B AGE_RESTRICTED Setting this option to \fBYES\fP marks the denomination as age restricted @@ -742,22 +742,22 @@ merchant backend. Plugin to use for the database, e.g._“postgres”. .TP .B SERVE -Should the HTTP server listen on a UNIX domain socket (set option to \(dqunix\(dq) or on a TCP socket (set option to \(dqtcp\(dq)? +Should the HTTP server listen on a UNIX domain socket (set option to “unix”) or on a TCP socket (set option to “tcp”)? .TP .B BASE_URL Which base URL should the merchant backend assume for itself in the protocol. Optional. If not given, the base URL will be constructed from X\-Forwarded\-Host, X\-Forwarded\-Port and X\-Forwarded\-Prefix headers that a reverse\-proxy should be setting. .TP .B UNIXPATH -Path to listen on if we \(dqSERVE\(dq is set to \(dqunix\(dq. +Path to listen on if we “SERVE” is set to “unix”. .TP .B UNIXPATH_MODE -Access permission mask to use for the \(dqUNIXPATH\(dq. +Access permission mask to use for the “UNIXPATH”. .TP .B PORT Port on which the HTTP server listens, e.g.\ 8080. .TP .B BIND_TO -Hostname to which the merchant HTTP server should be bound to, e.g. \(dqlocalhost\(dq. +Hostname to which the merchant HTTP server should be bound to, e.g. “localhost”. .TP .B LEGAL_PRESERVATION How long do we keep data in the database for tax audits after the @@ -792,7 +792,7 @@ Base URL of the exchange, e.g.\ “\fI\%https://exchange.demo.taler.net/\fP” .TP .B MASTER_KEY Crockford Base32 encoded master public key, public version of the -exchange\(aqs long\-time offline signing key. Can be omitted, in that +exchange’s long\-time offline signing key. Can be omitted, in that case the exchange will NOT be trusted unless it is audited by a known auditor. Omitting \fBMASTER_KEY\fP can be useful if we do not trust the exchange @@ -828,19 +828,19 @@ processes that do not have access to the (offline) auditor private key file. Base URL of the auditor, e.g.\ “\fI\%https://auditor.demo.taler.net/\fP” .TP .B SERVE -Should the HTTP server listen on a UNIX domain socket (set option to \(dqunix\(dq) or on a TCP socket (set option to \(dqtcp\(dq)? +Should the HTTP server listen on a UNIX domain socket (set option to “unix”) or on a TCP socket (set option to “tcp”)? .TP .B UNIXPATH -Path to listen on if we \(dqSERVE\(dq is set to \(dqunix\(dq. +Path to listen on if we “SERVE” is set to “unix”. .TP .B UNIXPATH_MODE -Access permission mask to use for the \(dqUNIXPATH\(dq. +Access permission mask to use for the “UNIXPATH”. .TP .B PORT Port on which the HTTP server listens, e.g.\ 8080. .TP .B BIND_TO -Hostname to which the merchant HTTP server should be bound to, e.g. \(dqlocalhost\(dq. +Hostname to which the merchant HTTP server should be bound to, e.g. “localhost”. .UNINDENT .SS AUDITOR POSTGRES BACKEND DATABASE OPTIONS .sp @@ -849,12 +849,12 @@ The following options must be in section “[auditordb\-postgres]” if the .INDENT 0.0 .TP .B CONFIG -How to access the database, e.g.\ \(dqpostgres:///taler\(dq to use the -\(dqtaler\(dq database. Testcases use “talercheck”. +How to access the database, e.g.\ “postgres:///taler” to use the +“taler” database. Testcases use “talercheck”. .UNINDENT .SS Bank Options .sp -The following options must be in section \(dq[bank]\(dq for the taler\-fakebank\-run(1) command. They are not used by the exchange or LibEuFin! +The following options must be in section “[bank]” for the taler\-fakebank\-run(1) command. They are not used by the exchange or LibEuFin! .INDENT 0.0 .TP .B HTTP_PORT @@ -878,28 +878,28 @@ Program to run while not vending, possibly useful to show advertisements on the ESSID to advertise to wallets for use as an open WiFi to make payments (optional). .TP .B FULFILLMENT_MSG -Message shown to users by their wallets upon successful payment. If \(dq${PRODUCT_DESCRIPTION}\(dq appears in the message, it will be replaced with the description of the product that was sold. +Message shown to users by their wallets upon successful payment. If “${PRODUCT_DESCRIPTION}” appears in the message, it will be replaced with the description of the product that was sold. .TP .B BACKEND_BASE_URL Base URL (possibly including instance) for the Taler merchant backend used to process payments. .TP .B BACKEND_AUTHORIZATION -Full HTTP \(dqAuthorization\(dq header (usually with a Bearer token) to be send to the merchant backend for authorization of requests. Mandatory. +Full HTTP “Authorization” header (usually with a Bearer token) to be send to the merchant backend for authorization of requests. Mandatory. .TP .B FRAMEBUFFER_BACKLIGHT -Name of the file used to control brightness of the display. Optional. Defaults to \(dq/sys/class/backlight/soc:backlight/brightness\(dq if not given. +Name of the file used to control brightness of the display. Optional. Defaults to “/sys/class/backlight/soc:backlight/brightness” if not given. .TP .B FRAMEBUFFER_DEVICE -Name of the framebuffer device to use. Defaults to \(dq/dev/fb1\(dq if not given. +Name of the framebuffer device to use. Defaults to “/dev/fb1” if not given. .TP .B UART_DEVICE -Name of the UART device to use. Defaults to \(dq/dev/ttyAMA0\(dq if not given. +Name of the UART device to use. Defaults to “/dev/ttyAMA0” if not given. .TP .B FAIL_COMMAND Command to run to display a failure to the user. If not given, errors will not be properly shown. .UNINDENT .sp -Each products being sold must be configured in a section where the name starts with \(dqproduct\-\(dq. +Each products being sold must be configured in a section where the name starts with “product\-“. In these sections, the options that must be provided are: .INDENT 0.0 .TP @@ -907,22 +907,22 @@ In these sections, the options that must be provided are: Number identifying the slot in the vending machine that corresponds to this product. .TP .B INSTANCE -Instance to use for the payment. Optional. If not given, the BACKEND_BASE_URL from \(dq[taler\-mdb]\(dq will be used. +Instance to use for the payment. Optional. If not given, the BACKEND_BASE_URL from “[taler\-mdb]” will be used. .TP .B BACKEND_AUTHORIZATION -Full HTTP \(dqAuthorization\(dq header (usually with a Bearer token) to be send to the merchant backend for authorization of requests. Optional, will use global BACKEND_AUTHORIZATION setting from \(dq[taler\-mdb]\(dq if missing. +Full HTTP “Authorization” header (usually with a Bearer token) to be send to the merchant backend for authorization of requests. Optional, will use global BACKEND_AUTHORIZATION setting from “[taler\-mdb]” if missing. .TP .B DESCRIPTION -Human\-readable description of the product. Use \(dqempty\(dq if the product is known to be sold out (only effective if selling out is enabled via command\-line). +Human\-readable description of the product. Use “empty” if the product is known to be sold out (only effective if selling out is enabled via command\-line). .TP .B PRICE -Actual price of the product, as a Taler amount (\(dq$CURRENCY:$VALUE.$FRACTION\(dq). +Actual price of the product, as a Taler amount (“$CURRENCY:$VALUE.$FRACTION”). .TP .B KEY Key used to select the product from the console during testing. Optional. .TP .B THUMBNAIL -Name of a filename with a preview image of the product to be given to the wallet. Optional. Only \(dq.png\(dq, \(dq.jpg\(dq, \(dq.jpeg\(dq and \(dq.svg\(dq are supported at this time. +Name of a filename with a preview image of the product to be given to the wallet. Optional. Only “.png”, “.jpg”, “.jpeg” and “.svg” are supported at this time. .UNINDENT .SH SEE ALSO .sp @@ -935,6 +935,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2022 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2024 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . diff --git a/texinfo/challenger.texi b/texinfo/challenger.texi index 53f57e43..75e90760 100644 --- a/texinfo/challenger.texi +++ b/texinfo/challenger.texi @@ -19,7 +19,7 @@ @copying @quotation -GNU Taler 0.9.4, Mar 07, 2024 +GNU Taler 0.9.4, Apr 12, 2024 GNU Taler team @@ -447,10 +447,10 @@ would look like this for Ubuntu Lunar: deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ lunar taler-lunar @end example -For Ubuntu Jammy use this instead: +For Ubuntu Mantic use this instead: @example -deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ jammy taler-jammy +deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ mantic taler-mantic @end example The last line is crucial, as it adds the GNU Taler packages. diff --git a/texinfo/taler-auditor.texi b/texinfo/taler-auditor.texi index 82ead846..92fee90d 100644 --- a/texinfo/taler-auditor.texi +++ b/texinfo/taler-auditor.texi @@ -19,7 +19,7 @@ @copying @quotation -GNU Taler 0.9.4, Mar 07, 2024 +GNU Taler 0.9.4, Apr 12, 2024 GNU Taler team @@ -581,10 +581,10 @@ would look like this for Ubuntu Lunar: deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ lunar taler-lunar @end example -For Ubuntu Jammy use this instead: +For Ubuntu Mantic use this instead: @example -deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ jammy taler-jammy +deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ mantic taler-mantic @end example The last line is crucial, as it adds the GNU Taler packages. diff --git a/texinfo/taler-developer-manual.texi b/texinfo/taler-developer-manual.texi index a71c9399..1d333657 100644 --- a/texinfo/taler-developer-manual.texi +++ b/texinfo/taler-developer-manual.texi @@ -19,7 +19,7 @@ @copying @quotation -GNU Taler 0.9.4, Mar 07, 2024 +GNU Taler 0.9.4, Apr 12, 2024 GNU Taler team diff --git a/texinfo/taler-exchange.texi b/texinfo/taler-exchange.texi index 9cf2dac9..16f3a2d9 100644 --- a/texinfo/taler-exchange.texi +++ b/texinfo/taler-exchange.texi @@ -19,7 +19,7 @@ @copying @quotation -GNU Taler 0.9.4, Mar 07, 2024 +GNU Taler 0.9.4, Apr 12, 2024 GNU Taler team @@ -315,7 +315,7 @@ subsystem. Such intermediary system abstracts the native banking protocol by exposing the `Taler Wire Gateway API'; this way, the exchange can conduct its banking operations in a simplified and JSON-based style. -When customers wire money to the exchange’s bank account, the Taler Wire +When customers wire money to the exchange's bank account, the Taler Wire Gateway API must notify the exchange about the incoming wire transfers. The exchange then creates a `reserve' based on the subject of the wire transfer. The wallet which knows the secret key matching the wire transfer @@ -352,7 +352,7 @@ binary is the @code{taler-exchange-httpd}. `Crypto-Helpers': The @code{taler-exchange-secmod-rsa}, @code{taler-exchange-secmod-cs} and @code{taler-exchange-secmod-eddsa} -are three programs that are responsible for managing the exchange’s +are three programs that are responsible for managing the exchange's online signing keys. They must run on the same machine as the @code{taler-exchange-httpd} as the HTTP frontend communicates with the crypto helpers using UNIX Domain Sockets. @@ -371,7 +371,7 @@ excessively frequent transfers. The binary is the The @code{taler-exchange-closer} tool check that reserves are properly closed. If a customer wires funds to an exchange and then fails to withdraw them, the closer will (eventually) trigger a wire -transfer that sends the customer’s funds back to the originating +transfer that sends the customer's funds back to the originating wire account. @item @@ -411,7 +411,7 @@ process using libtalerfakebank. Note that this adapter is only useful for tests, as all transaction data is kept in memory. @item -For production, `libeufin'’s @code{libeufin-nexus} component +For production, `libeufin''s @code{libeufin-nexus} component implements a wire adapter towards the traditional SEPA banking system with IBAN accounts using the EBICS protocol. @@ -444,7 +444,7 @@ computes the expected bank balance, revenue and risk exposure of the exchange operator. The main binary is the @code{taler-auditor}. Aside from the key setup procedures, the most critical setup for deploying an auditor is providing the auditor with an up-to-date -copy of the exchange’s database. +copy of the exchange's database. @end itemize @node Key Types,Offline keys,Architecture overview,Introduction @@ -470,14 +470,14 @@ denomination keys (signs digital coins) security module keys (signs online message signing keys and denomination keys) @end itemize -Additionally, the exchange is sometimes concerned with the auditor’s public +Additionally, the exchange is sometimes concerned with the auditor's public key (to verify messages signed by auditors approved by the exchange operator) -and the merchant’s public key (to verify refunds are authorized by the +and the merchant's public key (to verify refunds are authorized by the merchant). Most of the keys are managed fully automatically or configured as part of the denomination configuration. Some configuration settings must be manually -set with regards to the exchange’s master key. +set with regards to the exchange's master key. @node Offline keys,Online signing key security,Key Types,Introduction @anchor{taler-exchange-manual offline-keys}@anchor{9} @@ -486,7 +486,7 @@ set with regards to the exchange’s master key. The exchange (and ideally also its auditor(s)) uses a long-term offline master siging key that identifies the operator and is used to authenticate critical -information, such as the exchange’s bank account and the actual keys the +information, such as the exchange's bank account and the actual keys the exchange uses online. Interactions with the offline system are performed using the @@ -547,7 +547,7 @@ expires or if they are informed about a key having been revoked. From a security point of view, the helpers are designed to `only' make it -harder for an attacker who took control of the HTTP daemon’s account to +harder for an attacker who took control of the HTTP daemon's account to extract the private keys, limiting the attackers ability to creating signatures to the duration of their control of that account. @@ -567,7 +567,7 @@ The helper processes should be run under a user ID that is separate from that of the user running the main @code{taler-exchange-httpd} service. To get any security benefit from this, it is important that helpers run under a different user ID than the main HTTP frontend. In fact, ideally, each helper should run -under its own user ID. The @code{taler-exchange-httpd} service’s will securely +under its own user ID. The @code{taler-exchange-httpd} service's will securely communicate with the helpers using UNIX domain sockets. @node Configuration,,Setup,Online signing key security @@ -594,7 +594,7 @@ try to mitigate against. We recommend the setup of offline signing keys to be done on a second machine that does not have Internet access. -In this guide’s shell-session fragments, the command prompt shows two pieces +In this guide's shell-session fragments, the command prompt shows two pieces of information: @@ -705,7 +705,7 @@ backend: @itemize - @item -“Sphinx RTD Theme” Python package aka @code{python3-sphinx-rtd-theme} +"Sphinx RTD Theme" Python package aka @code{python3-sphinx-rtd-theme} on Debian-based systems (for GNUnet documentation support, can be omitted if GNUnet is configured with @code{--disable-documentation}) @@ -802,7 +802,7 @@ In any case, if @code{make check} fails, please consider filing a bug report with the Taler bug tracker@footnote{https://bugs.taler.net}. There is no need to actually run a GNUnet peer to use the Taler merchant -backend – all the merchant needs from GNUnet is a number of headers and +backend -- all the merchant needs from GNUnet is a number of headers and libraries! After installing GNUnet, unpack the GNU Taler exchange tarball, @@ -910,10 +910,10 @@ would look like this for Ubuntu Lunar: deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ lunar taler-lunar @end example -For Ubuntu Jammy use this instead: +For Ubuntu Mantic use this instead: @example -deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ jammy taler-jammy +deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ mantic taler-mantic @end example The last line is crucial, as it adds the GNU Taler packages. @@ -1216,7 +1216,7 @@ for generating configuration files under @code{deployment/netzbon/}. @chapter Exchange Database Setup -The access credentials for the exchange’s database are configured in +The access credentials for the exchange's database are configured in @code{/etc/taler/secrets/exchange-db.secret.conf}. Currently, only PostgreSQL is supported as a database backend. @@ -1401,7 +1401,7 @@ must then have the following options: @item @code{VALUE}: How much is the coin worth, the format is -CURRENCY:VALUE.FRACTION. For example, a 10 cent piece is “EUR:0.10”. +CURRENCY:VALUE.FRACTION. For example, a 10 cent piece is "EUR:0.10". @item @code{DURATION_WITHDRAW}: How long can a coin of this type be withdrawn? @@ -1561,10 +1561,10 @@ this offline signing machine are: @itemize * @item -Generation of the exchange’s offline master signing key. +Generation of the exchange's offline master signing key. @item -Secure storage of the exchange’s offline master signing key. +Secure storage of the exchange's offline master signing key. @item Generation of certificates (signed with the offline master signing key) that will be imported by the exchange. @@ -1660,7 +1660,7 @@ have two key pieces of information from that setup: @itemize * @item -The username and password to access the exchange’s account in the system. +The username and password to access the exchange's account in the system. @item The @code{payto://} URI of that account (see RFC 8905@footnote{https://www.rfc-editor.org/rfc/rfc8905}). @@ -1785,7 +1785,7 @@ Such a wire gateway configuration can be tested with the following commands: --section exchange-accountcredentials-1 --credit-history @end example -On success, you will see some of your account’s transaction history (or an +On success, you will see some of your account's transaction history (or an empty history), while on failure you should see an error message. @node Legal Setup,KYC Configuration,Wire Gateway Setup,Top @@ -1839,7 +1839,7 @@ setup and configure the legal conditions. @section Terms of Service -The service has an endpoint “/terms” to return the terms of service (in legal +The service has an endpoint "/terms" to return the terms of service (in legal language) of the service operator. Client software show these terms of service to the user when the user is first interacting with the service. Terms of service are optional for experimental deployments, if none are @@ -1853,7 +1853,7 @@ in the configuration file for the service: @itemize - @item -@code{TERMS_ETAG}: The current “Etag” to return for the terms of service. +@code{TERMS_ETAG}: The current "Etag" to return for the terms of service. This value must be changed whenever the terms of service are updated. A common value to use would be a version number. Note that if you change the @code{TERMS_ETAG}, you MUST also provide @@ -1870,7 +1870,7 @@ process. @section Privacy Policy -The service has an endpoint “/pp” to return the terms privacy policy (in legal +The service has an endpoint "/pp" to return the terms privacy policy (in legal language) of the service operator. Clients should show the privacy policy to the user when the user explicitly asks for it, but it should not be shown by default. Privacy policies are optional for experimental deployments, if none @@ -1884,7 +1884,7 @@ in the configuration file for the service: @itemize - @item -@code{PRIVACY_ETAG}: The current “Etag” to return for the privacy policy. +@code{PRIVACY_ETAG}: The current "Etag" to return for the privacy policy. This value must be changed whenever the privacy policy is updated. A common value to use would be a version number. Note that if you change the @code{PRIVACY_ETAG}, you MUST also provide @@ -1905,7 +1905,7 @@ The @code{TERMS_DIR} and @code{PRIVACY_DIR} directory structures must follow a particular layout. You may use the same directory for both the terms of service and the privacy policy, as long as you use different ETAGs. Inside of the directory, there should be sub-directories using two-letter language codes -like “en”, “de”, or “jp”. Each of these directories would then hold +like "en", "de", or "jp". Each of these directories would then hold translations of the current terms of service into the respective language. Empty directories are permitted in case translations are not available. @@ -1913,7 +1913,7 @@ Then, inside each language directory, files with the name of the value set as the @code{TERMS_ETAG} or @code{PRIVACY_ETAG} must be provided. The extension of each of the files should be typical for the respective mime type. The set of supported mime types is currently hard-coded in the service, and includes -“.epub”, “.html”, “.md”, “.pdf” and “.txt” files. If other files are present, +".epub", ".html", ".md", ".pdf" and ".txt" files. If other files are present, the service may show a warning on startup. @menu @@ -1926,7 +1926,7 @@ the service may show a warning on startup. @subsection Example -A sample file structure for a @code{TERMS_ETAG} of “tos-v0” would be: +A sample file structure for a @code{TERMS_ETAG} of "tos-v0" would be: @itemize - @@ -1962,8 +1962,8 @@ TERMS_DIR/de/tos-v0.epub TERMS_DIR/de/tos-v0.md @end itemize -If the user requests an HTML format with language preferences “fr” followed by -“en”, the service would return @code{TERMS_DIR/en/tos-v0.html} lacking a version in +If the user requests an HTML format with language preferences "fr" followed by +"en", the service would return @code{TERMS_DIR/en/tos-v0.html} lacking a version in French. @node Generating the Legal Terms,Adding translations,Legal policies directory layout,Legal Setup @@ -2076,7 +2076,7 @@ Wallet receives money via P2P payments over a threshold Merchant receives money over a threshold @item -Reserve is “opened” for invoicing (`planned feature') +Reserve is "opened" for invoicing (`planned feature') @end itemize @end quotation @@ -2275,7 +2275,7 @@ specific backend. The Challenger service for address validation supports OAuth2.0, but does not have a static AUTHORIZE_URL. Instead, the AUTHORIZE_URL must be enabled by the client -using a special authenticated request to the Challenger’s @code{/setup} endpoint. +using a special authenticated request to the Challenger's @code{/setup} endpoint. The exchange supports this by appending @code{#setup} to the AUTHORIZE_URL (note that fragments are illegal in OAuth2.0 URLs). Be careful to quote the URL, as @code{#} is otherwise interpreted as the beginning of a comment by the @@ -2640,7 +2640,7 @@ via a management HTTP API. @item The offline signing system validates this request and signs it. Additionally, the offline signing system signs policy messages -to configure the exchange’s bank accounts and associated fees. +to configure the exchange's bank accounts and associated fees. @item The messages generated by the offline signing system are uploaded @@ -2799,7 +2799,7 @@ provision it with auditor signatures. This is also done using the @code{taler-exchange-offline} tool on the offline system. First, the auditor must be configured and provide the exchange operator with its public key (using @code{taler-auditor-offline setup}) and the -URL of it’s REST API. The exchange operator also needs a human-readable name +URL of it's REST API. The exchange operator also needs a human-readable name that may be shown to users to identify the auditor. For more information on how to setup and operate an auditor, see manpages/taler-auditor-offline.1 and taler-auditor-manual. @@ -2886,11 +2886,11 @@ which staff has access to the AML operations: upload < aml.json @end example -The above commands would add an AML officer with the given “Legal Name” with -read-write (rw) access to the AML officer database. Using “ro” instead of -“rw” would grant read-only access to the data, leaving out the ability to +The above commands would add an AML officer with the given "Legal Name" with +read-write (rw) access to the AML officer database. Using "ro" instead of +"rw" would grant read-only access to the data, leaving out the ability to actually make AML decisions. Once AML access has been granted, the AML -officer can use the SPA to review cases and (with “rw” access) take AML +officer can use the SPA to review cases and (with "rw" access) take AML decisions. Access rights can be revoked at any time using: @@ -2951,8 +2951,8 @@ KYC_AML_TRIGGER = taler-exchange-kyc-aml-pep-trigger.sh The given program will be given the KYC attributes in JSON format on standard input, and must return 0 to continue without AML and non-zero to flag the account for manual review. To disable this trigger, simply leave the option to -its default value of ‘[/usr/bin/]true’. To flag all new users for manual -review, simply set the program to ‘[/usr/bin/]false’. +its default value of '[/usr/bin/]true'. To flag all new users for manual +review, simply set the program to '[/usr/bin/]false'. @node AML Forms,,AML Triggers,AML Configuration @anchor{taler-exchange-manual aml-forms}@anchor{4a} @@ -2987,7 +2987,7 @@ See DD 54 dynamic forms. @cartouche @quotation Attention do not remove a form the list if it has been used. Otherwise you -won’t be able to see the information save in the exchange database. +won't be able to see the information save in the exchange database. @end quotation @end cartouche @@ -3040,7 +3040,7 @@ Show the status of the manual withdrawal operation. $ taler-wallet-cli transactions @end example -At this point, a bank transfer to the exchange’s bank account +At this point, a bank transfer to the exchange's bank account needs to be made with the correct subject / remittance information as instructed by the wallet after the first step. With the above configuration, it should take about 5 minutes after the @@ -3088,10 +3088,10 @@ $ taler-wallet-cli transactions @end example If the transaction failed, fix any open issue(s) with the exchange and -run the “run-pending” command. +run the "run-pending" command. The wallet can also track if the exchange wired the money to the merchant -account. The “deposit group id” can be found in the output of the +account. The "deposit group id" can be found in the output of the transactions list. @example @@ -3198,7 +3198,7 @@ disks of the system. While an exchange should use an external auditor to attest to regulators that -it is operating correctly, an exchange operator can also use the auditor’s +it is operating correctly, an exchange operator can also use the auditor's logic to perform internal checks. For this, an exchange operator can generally follow the auditor guide. However, instead of using @code{taler-auditor-sync}, an internal audit can and likely should be performed either directly against @@ -3480,7 +3480,7 @@ user to understand the error debug: Bool; true if we are running in debug mode and are allowed to return HTML with potentially sensitive information @item -server_response: Object; could be NULL; this includes the (malformed) OAuth2 server response, it should be shown to the use if “debug” is true +server_response: Object; could be NULL; this includes the (malformed) OAuth2 server response, it should be shown to the use if "debug" is true @end itemize @end quotation @@ -3516,7 +3516,7 @@ message: String; additional error message elaborating on what was bad about the @section oauth2-conversion-failure -Converting the KYC data into the exchange’s internal +Converting the KYC data into the exchange's internal format failed (HTTP 502 Bad Gateway). This template is instantiated using the following information: @@ -3723,7 +3723,7 @@ user to understand the error debug: Bool; true if we are running in debug mode and are allowed to return HTML with potentially sensitive information @item -server_response: Object; could be NULL; this includes the (malformed) OAuth2 server response, it should be shown to the use if “debug” is true +server_response: Object; could be NULL; this includes the (malformed) OAuth2 server response, it should be shown to the use if "debug" is true @end itemize @end quotation @@ -3873,12 +3873,12 @@ $ dropdb talercheck; createdb talercheck $ taler-unified-setup.sh -emwt -c $CONF -f -u exchange-account-1 @end example -libeufin is GNU Taler’s adapter to the core banking system using the EBICS +libeufin is GNU Taler's adapter to the core banking system using the EBICS banking protocol standard. It uses a Postgres database to persist data and is thus much slower than fakebank. If your GNU Taler deployment uses libeufin in production, it likely makes sense to benchmark with libeufin. When using the fakebank, @code{taler-unified-setup.sh} must be started with the @code{-ns} options -(starting libeufin-nexus and libeufin-sandbox) and be told to use the right +(starting libeufin-nexus and libeufin-bank) and be told to use the right exchange bank account from the configuration files via @code{-u exchange-account-2}. Note that @code{taler-unified-setup.sh} currently cannot reset a libeufin database, and also will not run if the database is already @@ -3913,8 +3913,8 @@ $ time taler-bank-benchmark -c "$CONF" -r 40 -p 1 -P1 -u exchange-account-2 @end example For each `parallel' (@code{-p}) client, a number of `reserves' (@code{-r}) is first -established by `transferring' money from a “user” account (42) to the -Exchange’s account with the respective reserve public key as wire subject. +established by `transferring' money from a "user" account (42) to the +Exchange's account with the respective reserve public key as wire subject. Processing is then handled by `parallel' (@code{-P}) service workers. @node taler-exchange-benchmark,taler-aggregator-benchmark,taler-bank-benchmark,Benchmarking @@ -3943,8 +3943,8 @@ $ taler-exchange-benchmark -c "$CONF".edited -u exchange-account-2 -L WARNING -n @end example For each `parallel' (@code{-p}) client, a number of `reserves' (@code{-r}) is first -established by `transferring' money from a “user” account (42) to the -Exchange’s account with the respective reserve public key as wire subject. +established by `transferring' money from a "user" account (42) to the +Exchange's account with the respective reserve public key as wire subject. Next, the client will `withdraw' a `number of coins' (@code{-n}) from the reserve and `deposit' them. Additionally, a `fraction' (@code{-R}) of the dirty coins will then be subject to `refreshing'. For some deposits, the auditor @@ -3988,11 +3988,11 @@ as soon as there is no more pending work). @item We should have some summary with the inventory of services that should be -running. Systemd by default doesn’t show this nicely. Maybe suggest running -“systemd list-dependencies taler-exchange.target”? +running. Systemd by default doesn't show this nicely. Maybe suggest running +"systemd list-dependencies taler-exchange.target"? @item -What happens when the TWG doesn’t like one particular outgoing transaction? +What happens when the TWG doesn't like one particular outgoing transaction? How to recover from that as a sysadmin when it happens in practice? @end itemize diff --git a/texinfo/taler-merchant-api-tutorial.texi b/texinfo/taler-merchant-api-tutorial.texi index adca56f5..28b57ecc 100644 --- a/texinfo/taler-merchant-api-tutorial.texi +++ b/texinfo/taler-merchant-api-tutorial.texi @@ -19,7 +19,7 @@ @copying @quotation -GNU Taler 0.9.4, Mar 07, 2024 +GNU Taler 0.9.4, Apr 12, 2024 GNU Taler team diff --git a/texinfo/taler-merchant.texi b/texinfo/taler-merchant.texi index aee6ee73..8e7582b9 100644 --- a/texinfo/taler-merchant.texi +++ b/texinfo/taler-merchant.texi @@ -19,7 +19,7 @@ @copying @quotation -GNU Taler 0.9.4, Mar 07, 2024 +GNU Taler 0.9.4, Apr 12, 2024 GNU Taler team @@ -673,10 +673,10 @@ would look like this for Ubuntu Lunar: deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ lunar taler-lunar @end example -For Ubuntu Jammy use this instead: +For Ubuntu Mantic use this instead: @example -deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ jammy taler-jammy +deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/ubuntu/ mantic taler-mantic @end example The last line is crucial, as it adds the GNU Taler packages. @@ -1195,12 +1195,12 @@ For the @code{postgres} backend, you need to specify: @example [merchantdb-postgres] -CONFIG = "postgres:///taler-merchant" +CONFIG = "postgres:///talermerchant" @end example This option specifies a PostgreSQL access path, typically using the format @code{postgres:///$DBNAME}, where @code{$DBNAME} is the name of the PostgreSQL -database you want to use (here, @code{taler-merchant} on the local machine). +database you want to use (here, @code{talermerchant} on the local machine). Suppose @code{$USER} is the name of the user who will run the backend process (usually @code{taler-merchant-httpd}). Then, you need to first run: |