diff options
author | Christian Grothoff <christian@grothoff.org> | 2024-01-06 14:07:18 +0100 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2024-01-06 14:07:18 +0100 |
commit | 5e7026c5cef101c90b6dc58096e0a0946ef11b08 (patch) | |
tree | ae6f9c7bb10d7b92a6ebd6ca7b38ab1762e9b8cc /man | |
parent | 5e47a72e8a2b5086dfdae4078f695155f5ed7af8 (diff) | |
download | docs-5e7026c5cef101c90b6dc58096e0a0946ef11b08.tar.gz docs-5e7026c5cef101c90b6dc58096e0a0946ef11b08.tar.bz2 docs-5e7026c5cef101c90b6dc58096e0a0946ef11b08.zip |
-update man pages
Diffstat (limited to 'man')
61 files changed, 1229 insertions, 996 deletions
diff --git a/man/challenger-admin.1 b/man/challenger-admin.1 index 899c7cc6..8aca04bd 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "CHALLENGER-ADMIN" "1" "Jan 06, 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 diff --git a/man/challenger-config.1 b/man/challenger-config.1 index 1d3d442e..7e1ac9de 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "CHALLENGER-CONFIG" "1" "Jan 06, 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. “namestore_postgres” for -the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is +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 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 “OPTION = VALUE”. +format \(dqOPTION = VALUE\(dq. .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 diff --git a/man/challenger-dbconfig.1 b/man/challenger-dbconfig.1 index 6cba91b0..b3c13fdb 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "CHALLENGER-DBCONFIG" "1" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME challenger-dbconfig \- configure challenger database .SH SYNOPSIS diff --git a/man/challenger-dbinit.1 b/man/challenger-dbinit.1 index a03a92e9..f181c39d 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "CHALLENGER-DBINIT" "1" "Jan 06, 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 diff --git a/man/challenger-httpd.1 b/man/challenger-httpd.1 index fcf4a099..a12581d8 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "CHALLENGER-HTTPD" "1" "Jan 06, 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 diff --git a/man/challenger.conf.5 b/man/challenger.conf.5 index fb3e9562..38b715e4 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "CHALLENGER.CONF" "5" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME challenger.conf \- Challenger configuration file .SH DESCRIPTION @@ -44,7 +44,7 @@ whitespace around the \fB=\fP (equal sign). Section names and options are .sp The values, however, are \fIcase\-sensitive\fP\&. In particular, boolean values are one of \fBYES\fP or \fBNO\fP\&. Values can include whitespace by surrounding the -entire value with \fB"\fP (double quote). Note, however, that there are no +entire value with \fB\(dq\fP (double quote). Note, however, that there are no escape characters in such strings; all characters between the double quotes (including other double quotes) are taken verbatim. .sp diff --git a/man/libeufin-nexus.1 b/man/libeufin-nexus.1 index 1203126a..bbe69e74 100644 --- a/man/libeufin-nexus.1 +++ b/man/libeufin-nexus.1 @@ -27,17 +27,17 @@ 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "LIBEUFIN-NEXUS" "1" "Jan 06, 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 +Subcommands: \fBdbinit\fP, \fBebics\-setup\fP, \fBebics\-submit\fP, \fBebics\-fetch\fP, \fBconfig\fP .SH DESCRIPTION .sp \fBlibeufin\-nexus\fP is a program that provides a service to interface to @@ -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’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. +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. .sp Its options are as follows: .INDENT 0.0 .TP -\fB\-h\fP | \fB–help\fP +\fB\-h\fP | \fB\-\-help\fP Prints 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–check\-full\-config\fP +\fB\-\-check\-full\-config\fP Checks the configuration of all the three subcommands and returns. .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’s 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\(aqs useful in case the PDF went lost after the first submission and the user needs a new PDF. .UNINDENT .SS dbinit .sp @@ -90,13 +90,13 @@ 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\-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 @@ -106,19 +106,19 @@ 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–transient\fP +\fB\-\-transient\fP This flag, enabled by default, causes the command to check the database and submit only once, and then return. .TP -\fB–debug\fP +\fB\-\-debug\fP With this flag, it is possible to pass via STDIN a raw pain.001 document to be submitted to the bank. This method turns ebics\-submit to run in transient mode and it does NOT affect the database. .TP -\fB–ebics\-extra\-log\fP +\fB\-\-ebics\-extra\-log\fP Enables (verbose) logging of EBICS 3 messages to STDERR. It logs only EBICS 3 messages from the initialisation phase of an upload order. .UNINDENT .SS ebics\-fetch @@ -126,32 +126,85 @@ Enables (verbose) logging of EBICS 3 messages to STDERR. It logs only EBICS 3 m This subcommand downloads banking records via EBICS and stores them into the database. By default, it downloads \fBcamt.054\fP notifications. Along the download, ebics\-fetch would bounce incoming payments that do not have a valid Taler subject, or as well those with an already existing valid subject. Valid incoming payments are then stored in the database so that they can trigger Taler withdrawals. Along this process, ebics\-submit would as well reconcile initiated outgoing payments with any outgoing transactions that shows up in the downloaded records. Any option starting with \fB\-\-only\fP would only be useful with a defined log directory (STATEMENTS_LOG_DIRECTORY) in 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–transient\fP +\fB\-\-transient\fP This flag, enabled by default, causes the command to perform one download and return. .TP -\fB–only\-statements\fP +\fB\-\-only\-statements\fP It downloads statements (instead of notifications) in the form of camt.053 documents. It does NOT affect the database. .TP -\fB–only\-ack\fP +\fB\-\-only\-ack\fP It downloads payment submissions acknowledgements (instead of notifications) in the form of pain.002 documents. It MAY affect the database by setting the state of submitted payments. .TP -\fB–only\-reports\fP +\fB\-\-only\-reports\fP It downloads only intraday reports (instead of notifications) in the form of camt.052 documents. It does NOT affect the database. .TP -\fB–only\-logs\fP +\fB\-\-only\-logs\fP It downloads the subscriber activity via EBICS HAC in the form of pain.002 documents. It does NOT affect the database. .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. .TP -\fB–debug\fP -With this flag, ebics\-fetch accepts XML documents from STDIN. In this case, it prints on the console the result and exits, without affecting the database. The results are the stringified objects that the application itself uses to represent the business details. +\fB\-\-parse\fP +Reads one ISO20022 document from STDIN. It prints on the console the result and exits without affecting the database +.TP +\fB\-\-import\fP +Reads one ISO20022 document from STDIN. It prints the result on the console \fBand\fP also ingests the input content into the database. NOTE: if used in a debug scenario, consider to destroy the database before going to production for the following reasons; (1) the database likely ends up having phony transactions that do not belong to the bank account associated with the EBICS subscriber, and (2) whose timestamps will alter the way ebics\-fetch will request new records to the bank. (3) This flags skips the check on the bank keys, so the database could receive records even though hte bank keys were not accepted / downloaded. +.UNINDENT +.SS config +.sp +This command inspect or change the configuration. +.INDENT 0.0 +.TP +\fB\-h\fP | \fB\-\-help\fP +Print short help on options. +.UNINDENT +.sp +Subcommands: \fBget\fP, \fBdump\fP, \fBpathsub\fP +.SS config get +.sp +This command lookup config value. +.sp +It takes two arguments, the section name and the option name +.INDENT 0.0 +.TP +\fB\-h\fP | \fB\-\-help\fP +Print short help on options. +.TP +\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +Specifies the configuration file. +.TP +\fB\-f\fP | \fB\-\-filename\fP +Interpret value as path with dollar\-expansion. +.UNINDENT +.SS config dump +.sp +This command dump the configuration. +.INDENT 0.0 +.TP +\fB\-h\fP | \fB\-\-help\fP +Print short help on options. +.TP +\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +Specifies the configuration file. +.UNINDENT +.SS config pathsub +.sp +This command substitute variables in a path. +.sp +It takes one argument, a path expresion. +.INDENT 0.0 +.TP +\fB\-h\fP | \fB\-\-help\fP +Print short help on options. +.TP +\fB\-c\fP | \fB\-\-config\fP \fIFILENAME\fP +Specifies the configuration file. .UNINDENT .SH SEE ALSO .sp diff --git a/man/libeufin-nexus.conf.5 b/man/libeufin-nexus.conf.5 index 954fee77..a3de048f 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "LIBEUFIN-NEXUS.CONF" "5" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME libeufin-nexus.conf \- LibEuFin Nexus configuration file .SH DESCRIPTION @@ -44,7 +44,7 @@ whitespace around the \fB=\fP (equal sign). Section names and options are .sp The values, however, are \fIcase\-sensitive\fP\&. In particular, boolean values are one of \fBYES\fP or \fBNO\fP\&. Values can include whitespace by surrounding the -entire value with \fB"\fP (double quote). Note, however, that there are no +entire value with \fB\(dq\fP (double quote). Note, however, that there are no escape characters in such strings; all characters between the double quotes (including other double quotes) are taken verbatim. .sp @@ -215,11 +215,6 @@ would be overridden, \fBebics\-fetch\fP fails without overriding it. 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$downloadTimestampMicroseconds_HAC_response.pain.002.xml\fP -.TP -.B MINIMUM_AMOUNT -Optional value to indicate the minumum amount that users should wire to the watched -bank account. It takes only the number part \fIwithout the currency\fP, where at most two -fractional digits are allowed. .UNINDENT .SH SEE ALSO .sp diff --git a/man/libeufin-sandbox.1 b/man/libeufin-sandbox.1 index fc572b10..c56e7ee9 100644 --- a/man/libeufin-sandbox.1 +++ b/man/libeufin-sandbox.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-SANDBOX" "1" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "LIBEUFIN-SANDBOX" "1" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME libeufin-sandbox \- simulate core banking system with EBICS access to bank accounts .SH SYNOPSIS .sp \fBlibeufin\-sandbox\fP -[\fB\-h\fP\ |\ \fB–help\fP] -[\fB–version\fP] -COMMAND [ARGS…] +[\fB\-h\fP\ |\ \fB\-\-help\fP] +[\fB\-\-version\fP] +COMMAND [ARGS...] .sp Commands: serve, reset\-tables, config, make\-transaction, camt053tick default\-exchange @@ -49,12 +49,12 @@ requests either over the network or via a Unix domain socket. Related program \fBlibeufin\-cli\fP is the preferred front end for that mode of operation. There is also a mode where \fBlibeufin\-sandbox\fP accepts commands directly, -useful for configuring one or more “demobank” (simulated bank) instances. +useful for configuring one or more \(dqdemobank\(dq (simulated bank) instances. .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–version\fP @@ -88,10 +88,10 @@ Option \fB\-\-captcha\-url $URL\fP specifies where the wallet user is going to be redirected to confirm the withdrawal operation. This $URL should point to the bank frontend. More precisely to the UI that let the user finish a withdrawal operation that needs to be confirmed. Example of -this value may be “\fI\%https://bank.domain/#/operation\fP/{wopid}” where -“\fI\%https://bank.domain\fP” returns the demobank SPA and the demobank view under -the route “/operation/{wopid}” will show the status of the operation id {wopid}. -Note that “{wopid}” is literally in the –captcha\-url config and replaced at +this value may be \(dq\fI\%https://bank.domain/#/operation\fP/{wopid}\(dq where +\(dq\fI\%https://bank.domain\fP\(dq returns the demobank SPA and the demobank view under +the route \(dq/operation/{wopid}\(dq will show the status of the operation id {wopid}. +Note that \(dq{wopid}\(dq is literally in the \-\-captcha\-url config and replaced at runtime by the sandbox server. Option \fB\-\-bank\-debt\-limit N\fP (default: 1000000) specifies that the bank debt limit should be N (units of currency). @@ -141,7 +141,7 @@ This sets the default exchange for demobank \fBbank01\fP\&. It is an error if the demobank does not exist. .SS make\-transaction .sp -This is a “legacy” command, useful in a previous iteration of LibEuFin +This is a \(dqlegacy\(dq command, useful in a previous iteration of LibEuFin and for internal testing. It creates and records a wire transfer transaction in the database. .sp diff --git a/man/sync-config.1 b/man/sync-config.1 index 348663aa..6e32096c 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "SYNC-CONFIG" "1" "Jan 06, 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. “namestore_postgres” for -the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is +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 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 “OPTION = VALUE”. +format \(dqOPTION = VALUE\(dq. .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 diff --git a/man/sync-dbconfig.1 b/man/sync-dbconfig.1 index 39c687b3..dd294154 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "SYNC-DBCONFIG" "1" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME sync-dbconfig \- configure sync database .SH SYNOPSIS diff --git a/man/sync-dbinit.1 b/man/sync-dbinit.1 index 5b638458..347d158e 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "SYNC-DBINIT" "1" "Jan 06, 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 diff --git a/man/sync-httpd.1 b/man/sync-httpd.1 index cbac0b2e..658fbfab 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "SYNC-HTTPD" "1" "Jan 06, 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 diff --git a/man/sync.conf.5 b/man/sync.conf.5 index 29c1ac4e..012ae456 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "SYNC.CONF" "5" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME sync.conf \- Sync configuration file .SH DESCRIPTION @@ -44,7 +44,7 @@ whitespace around the \fB=\fP (equal sign). Section names and options are .sp The values, however, are \fIcase\-sensitive\fP\&. In particular, boolean values are one of \fBYES\fP or \fBNO\fP\&. Values can include whitespace by surrounding the -entire value with \fB"\fP (double quote). Note, however, that there are no +entire value with \fB\(dq\fP (double quote). Note, however, that there are no escape characters in such strings; all characters between the double quotes (including other double quotes) are taken verbatim. .sp diff --git a/man/taler-aggregator-benchmark.1 b/man/taler-aggregator-benchmark.1 index 9a17c0c1..f75b0939 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AGGREGATOR-BENCHMARK" "1" "Jan 06, 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 diff --git a/man/taler-auditor-dbconfig.1 b/man/taler-auditor-dbconfig.1 index 819bcc35..85d94e85 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-DBCONFIG" "1" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME taler-auditor-dbconfig \- configure Taler auditor database .SH SYNOPSIS diff --git a/man/taler-auditor-dbinit.1 b/man/taler-auditor-dbinit.1 index dd4d9fbf..bc6647db 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-DBINIT" "1" "Jan 06, 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 diff --git a/man/taler-auditor-exchange.1 b/man/taler-auditor-exchange.1 index 3bb53f0e..4821bce3 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-EXCHANGE" "1" "Jan 06, 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 diff --git a/man/taler-auditor-httpd.1 b/man/taler-auditor-httpd.1 index 4c1d0e17..8ff8aa2e 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-HTTPD" "1" "Jan 06, 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 diff --git a/man/taler-auditor-offline.1 b/man/taler-auditor-offline.1 index de445c4a..37ce6eab 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-OFFLINE" "1" "Jan 06, 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’s +The tool includes two subcommands to interact \fIonline\fP with the exchange\(aqs 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 “online” and do not -require access to the auditor’s private key, which should be kept offline. +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. .sp -All other subcommands are intended to be run “offline”. However, especially +All other subcommands are intended to be run \(dqoffline\(dq. 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’s public key, such that they can validate messages signed -by the auditor. To obtain the auditor’s public key, use: +the auditor\(aqs public key, such that they can validate messages signed +by the auditor. To obtain the auditor\(aqs 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 “\-“) +the existing key. Passing additional arguments after setup (including \(dq\-\(dq) 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 diff --git a/man/taler-auditor-sync.1 b/man/taler-auditor-sync.1 index fd928473..27cc1652 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-SYNC" "1" "Jan 06, 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’s database in a safe way from a Taler exchange +Taler auditor\(aqs 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 diff --git a/man/taler-auditor.1 b/man/taler-auditor.1 index 28f608cd..14657b47 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-AUDITOR" "1" "Jan 06, 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 “safe” replicated database at the auditor. +database and not the \(dqsafe\(dq 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 diff --git a/man/taler-bank-benchmark.1 b/man/taler-bank-benchmark.1 index b1a89c48..34dfcf18 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-BANK-BENCHMARK" "1" "Jan 06, 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 “bank” +\fBtaler\-bank\-benchmark\fP is a command\-line tool to benchmark only the \(dqbank\(dq 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 diff --git a/man/taler-config.1 b/man/taler-config.1 index b10c95c1..01efb970 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-CONFIG" "1" "Jan 06, 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. “namestore_postgres” for -the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is +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 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 “OPTION = VALUE”. +format \(dqOPTION = VALUE\(dq. .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 @@ -103,9 +103,10 @@ Must only be given together with \fB\-s\fP and \fB\-o\fP options. .B Note: Changing the configuration file with \fB\-V\fP will remove comments 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 diff --git a/man/taler-exchange-aggregator.1 b/man/taler-exchange-aggregator.1 index e173224c..5d6eed11 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-AGGREGATOR" "1" "Jan 06, 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 “taler\-exchange\-dbinit \-s” 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 \(dqtaler\-exchange\-dbinit \-s\(dq 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 diff --git a/man/taler-exchange-benchmark.1 b/man/taler-exchange-benchmark.1 index 5af844da..4c75a461 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-BENCHMARK" "1" "Jan 06, 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 diff --git a/man/taler-exchange-closer.1 b/man/taler-exchange-closer.1 index 9eaa265f..ee668d9a 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-CLOSER" "1" "Jan 06, 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 diff --git a/man/taler-exchange-dbconfig.1 b/man/taler-exchange-dbconfig.1 index 381fad24..56c1bf8c 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-DBCONFIG" "1" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME taler-exchange-dbconfig \- configure Taler exchange database .SH SYNOPSIS diff --git a/man/taler-exchange-dbinit.1 b/man/taler-exchange-dbinit.1 index aaf7ed96..a447167f 100644 --- a/man/taler-exchange-dbinit.1 +++ b/man/taler-exchange-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-EXCHANGE-DBINIT" "1" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-DBINIT" "1" "Jan 06, 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\-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 +50,29 @@ 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 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 diff --git a/man/taler-exchange-drain.1 b/man/taler-exchange-drain.1 index def0f870..97519e02 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-DRAIN" "1" "Jan 06, 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’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 +\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 balance changes arising from an exchange making profits from fees. .sp -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\&. +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\&. .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 diff --git a/man/taler-exchange-expire.1 b/man/taler-exchange-expire.1 index 647b06a0..bed02281 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-EXPIRE" "1" "Jan 06, 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 diff --git a/man/taler-exchange-httpd.1 b/man/taler-exchange-httpd.1 index 1d0dfc71..ac9418f0 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-HTTPD" "1" "Jan 06, 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 diff --git a/man/taler-exchange-kyc-aml-pep-trigger.1 b/man/taler-exchange-kyc-aml-pep-trigger.1 index bfe110ae..fd1fa5af 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-KYC-AML-PEP-TRIGGER" "1" "Jan 06, 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 “PEP” 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 \(dqPEP\(dq 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 diff --git a/man/taler-exchange-kyc-tester.1 b/man/taler-exchange-kyc-tester.1 index 9d27d461..15d8786a 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-KYC-TESTER" "1" "Jan 06, 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 “pass” (or “fail”) 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 \(dqpass\(dq (or \(dqfail\(dq) 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 “individual” or “business”. +\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. .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 diff --git a/man/taler-exchange-offline.1 b/man/taler-exchange-offline.1 index 51230354..10a7d6c6 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-OFFLINE" "1" "Jan 06, 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’s master private key. Most operations of this tool require access to +exchange\(aqs 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’s +The tool includes two subcommands to interact \fIonline\fP with the exchange\(aqs 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 “online” and do not require +\fBupload\fP subcommands must naturally be run \(dqonline\(dq and do not require access to the offline key. .sp -All other subcommands are intended to be run “offline”. However, especially +All other subcommands are intended to be run \(dqoffline\(dq. 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 “\-“) +the existing key. Passing additional arguments after setup (including \(dq\-\(dq) 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’s configurations has been signed by the offline tool with +\fIafter\fP the extension\(aqs 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’s \fBtaler\-auditor\-offline\fP +exchange will accept inputs from that auditor\(aqs \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’s database will need to be provided to the auditor. This subcommand +exchange\(aqs 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’s public key must be given in the usual base32\-encoding as the +The auditor\(aqs public key must be given in the usual base32\-encoding as the first argument. .sp -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 +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 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’s business entity. If +be shown to users and should identify the auditor\(aqs 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’s \fBtaler\-auditor\-offline\fP +exchange will refuse inputs from that auditor\(aqs \fBtaler\-auditor\-offline\fP tool. .sp -The auditor’s public key must be given in the usual base32\-encoding as the +The auditor\(aqs 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. @@ -248,7 +248,7 @@ in a format suitable for the \fBupload\fP subcommand. .SS enable\-account .sp This subcommand informs an exchange that it should advertise a bank account as -belonging to the exchange on its \fB/wire\fP endpoint. Note that this does +belonging to the exchange on its \fB/keys\fP endpoint. Note that this does \fInot\fP ensure that the exchange will use this bank account for incoming or outgoing wire transfers! For this, the \fBtaler\-exchange\-transfer\fP and \fBtaler\-exchange\-wirewatch\fP tools must be configured. Furthermore, the bank @@ -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’s bank account must be given +The \fBpayto://\fP URI (RFC 8905) of the exchange\(aqs bank account must be given as the first argument to the subcommand. .sp Afterwards, optional arguments can be given: @@ -294,7 +294,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’s +\fBregex\fP $EXPR $HINT $JSON: A $TYPE of \fBregex\fP means that the partner\(aqs 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 @@ -315,9 +315,9 @@ in a format suitable for the \fBupload\fP subcommand. .sp This subcommand informs an exchange that it should stop advertising a bank account as -belonging to the exchange on its \fB/wire\fP endpoint. +belonging to the exchange on its \fB/keys\fP endpoint. .sp -The \fBpayto://\fP URI (RFC 8905) of the exchange’s (former) bank account must be +The \fBpayto://\fP URI (RFC 8905) of the exchange\(aqs (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 +371,11 @@ Partner exchange base URL. .IP 2. 3 Partner exchange master public key. .IP 3. 3 -Calendar year for which the fee applies, ‘now’ for the current year. +Calendar year for which the fee applies, \(aqnow\(aq for the current year. .IP 4. 3 -Wad frequency, in minutes (for example, ‘30’). +Wad frequency, in minutes (for example, \(aq30\(aq). .IP 5. 3 -Wad fee (for example, ‘KUDOS:0.1’). +Wad fee (for example, \(aqKUDOS:0.1\(aq). .UNINDENT .UNINDENT .UNINDENT @@ -388,7 +388,7 @@ The arguments provided must include: .INDENT 3.5 .INDENT 0.0 .IP 1. 3 -Calendar year for which the fee applies, ‘now’ for the current year. +Calendar year for which the fee applies, \(aqnow\(aq 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 +410,8 @@ History fee charged when inquiring about non\-recent account history. .UNINDENT .SS aml\-enable .sp -Enable AML officer’s account, granting them access to AML data and, -if ‘rw’ is given, the power to make AML decisions. +Enable AML officer\(aqs account, granting them access to AML data and, +if \(aqrw\(aq is given, the power to make AML decisions. .sp The arguments provided must include: .INDENT 0.0 @@ -422,13 +422,13 @@ AML staff member public key (in base32 encoding) .IP 2. 3 AML staff member legal name .IP 3. 3 -‘ro’ or ‘rw’ to set access to read\-only or read\-write +\(aqro\(aq or \(aqrw\(aq to set access to read\-only or read\-write .UNINDENT .UNINDENT .UNINDENT .SS aml\-disable .sp -Disable AML officer’s account. Also updates the legal name. +Disable AML officer\(aqs account. Also updates the legal name. .sp The arguments provided must include: .INDENT 0.0 @@ -459,7 +459,7 @@ Wad fee to charge. .IP 4. 3 Wad transfer frequency. .IP 5. 3 -Year for which the above options are to be configured, ‘now’ for the current year. +Year for which the above options are to be configured, \(aqnow\(aq for the current year. .UNINDENT .UNINDENT .UNINDENT @@ -522,7 +522,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 “offline” key onto a system that is actually +as this requires putting the \(dqoffline\(dq key onto a system that is actually online! .INDENT 0.0 .INDENT 3.5 @@ -587,8 +587,8 @@ $ taler\-exchange\-offline \e regex \e \(aqpayto://iban/.*/CH.*?receiver\-name=.*\(aq \e \(aqSwiss only\(aq \e - \(aq{ "de" : "nur Schweiz", \e - "fr" : "Suisse uniquement" }\(aq + \(aq{ \(dqde\(dq : \(dqnur Schweiz\(dq, \e + \(dqfr\(dq : \(dqSuisse uniquement\(dq }\(aq .ft P .fi .UNINDENT @@ -658,7 +658,7 @@ $ taler\-exchange\-offline \e .UNINDENT .UNINDENT .sp -The outputs (“revoke.json”, “mix.json”) must be uploaded using the \fBupload\fP +The outputs (\(dqrevoke.json\(dq, \(dqmix.json\(dq) must be uploaded using the \fBupload\fP subcommand to the exchange to actually revoke the keys. .SH SECURITY CONSIDERATIONS .sp @@ -667,8 +667,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 “enable” (or “disable”) message after a more recent “disable” (or -“enable”) message has been provided to the exchange. Thus, there is no need +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 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 +678,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’s public signing key and \fItrusts it +automatically learns the security module\(aqs 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. diff --git a/man/taler-exchange-router.1 b/man/taler-exchange-router.1 index 0f1d4352..1ea8c284 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-ROUTER" "1" "Jan 06, 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 diff --git a/man/taler-exchange-secmod-cs.1 b/man/taler-exchange-secmod-cs.1 index 90495ec9..be7138cb 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-CS" "1" "Jan 06, 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 diff --git a/man/taler-exchange-secmod-eddsa.1 b/man/taler-exchange-secmod-eddsa.1 index 6a9ae413..8ed26917 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-EDDSA" "1" "Jan 06, 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 diff --git a/man/taler-exchange-secmod-rsa.1 b/man/taler-exchange-secmod-rsa.1 index 61942149..10a44e41 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-RSA" "1" "Jan 06, 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 diff --git a/man/taler-exchange-transfer.1 b/man/taler-exchange-transfer.1 index c8b584f2..f493cb34 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-TRANSFER" "1" "Jan 06, 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 diff --git a/man/taler-exchange-wire-gateway-client.1 b/man/taler-exchange-wire-gateway-client.1 index 59a5e9d6..b8b59d0c 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-WIRE-GATEWAY-CLIENT" "1" "Jan 06, 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,58 +77,58 @@ 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 diff --git a/man/taler-exchange-wirewatch.1 b/man/taler-exchange-wirewatch.1 index a4328b94..ff7fe581 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-WIREWATCH" "1" "Jan 06, 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 diff --git a/man/taler-helper-auditor-aggregation.1 b/man/taler-helper-auditor-aggregation.1 index 2e5dc3a8..32ef2f28 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-AGGREGATION" "1" "Jan 06, 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 diff --git a/man/taler-helper-auditor-coins.1 b/man/taler-helper-auditor-coins.1 index 6beebd66..90db510b 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-COINS" "1" "Jan 06, 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 diff --git a/man/taler-helper-auditor-deposits.1 b/man/taler-helper-auditor-deposits.1 index ba06bccb..44994587 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-DEPOSITS" "1" "Jan 06, 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 diff --git a/man/taler-helper-auditor-purses.1 b/man/taler-helper-auditor-purses.1 index d34884a5..2d70bf23 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-PURSES" "1" "Jan 06, 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 diff --git a/man/taler-helper-auditor-reserves.1 b/man/taler-helper-auditor-reserves.1 index 0e5db288..8255ed93 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-RESERVES" "1" "Jan 06, 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 diff --git a/man/taler-helper-auditor-wire.1 b/man/taler-helper-auditor-wire.1 index e4b41759..c7843c26 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-WIRE" "1" "Jan 06, 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’s wire transfers. +audit exchange database for consistency with the bank\(aqs 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 diff --git a/man/taler-merchant-benchmark.1 b/man/taler-merchant-benchmark.1 index 440b63ad..abb4cd57 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-BENCHMARK" "1" "Jan 06, 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 ‘Authorization’ header to send to the merchant. +\fB\-a\fP \fIAPIKEY\fP | \fB\-\-apikey=\fP\fIAPIKEY\fP +HTTP \(aqAuthorization\(aq 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 diff --git a/man/taler-merchant-dbconfig.1 b/man/taler-merchant-dbconfig.1 index cbc9005a..a244bbcf 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-DBCONFIG" "1" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-dbconfig \- configure Taler merchant database .SH SYNOPSIS diff --git a/man/taler-merchant-dbinit.1 b/man/taler-merchant-dbinit.1 index 65c2dded..59551d01 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-DBINIT" "1" "Jan 06, 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 diff --git a/man/taler-merchant-depositcheck.1 b/man/taler-merchant-depositcheck.1 new file mode 100644 index 00000000..1bd2373a --- /dev/null +++ b/man/taler-merchant-depositcheck.1 @@ -0,0 +1,94 @@ +.\" Man page generated from reStructuredText. +. +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.TH "TALER-MERCHANT-DEPOSITCHECK" "1" "Jan 06, 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\ |\ \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 +bank transfers in response to deposits made by the +merchant backend. This will allow the merchant backend to detect deposit issues, for example if a KYC is blocking +a wire transfer. +.sp +Its options are as follows: +.INDENT 0.0 +.TP +\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). +.TP +\fB\-h\fP | \fB\-\-help\fP +Print short help on options. +.TP +\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 +Send logging output to \fIFILENAME\fP\&. +.TP +\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 | \fB\-\-test\fP +Run in test mode. Only runs until the current list of bank +transactions are all imported. +.TP +\fB\-v\fP | \fB–version\fP +Print version information. +.UNINDENT +.SH SEE ALSO +.sp +taler\-merchant\-httpd(1), taler.conf(5). +.SH BUGS +.sp +Report bugs by using \fI\%https://bugs.taler.net\fP or by sending 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+) +.\" Generated by docutils manpage writer. +. diff --git a/man/taler-merchant-httpd.1 b/man/taler-merchant-httpd.1 index d5e4a156..289829c7 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-HTTPD" "1" "Jan 06, 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 “secret\-token:” prefix, as per RFC 8959. The value +\fB\-a\fP \fITOKEN\fP | \fB\-\-auth=\fP\fITOKEN\fP +Use TOKEN for initial access control to the merchant backend. TOKEN must start with the \(dqsecret\-token:\(dq prefix, as per RFC 8959. The value given in TOKEN must appear in backoffice requests to the default instance -of the merchant, i.e. “Authorization: Bearer TOKEN” to obtain +of the merchant, i.e. \(dqAuthorization: Bearer TOKEN\(dq to obtain access to the merchant backend. Note that setting a passphrase for the default instance by any means will block future access via TOKEN. This is basically a way to reset the passphrase protecting access. TOKEN -should be a “pchar” as per RFC 8959, but this is NOT checked. Note that -TOKEN will only grant access to the ‘default’ instance, not other instances. +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. Instead of using the command\-line, which exposes TOKEN to users on the system, you may want to consider setting the TALER_MERCHANT_TOKEN environment variable instead. .TP -\fB\-C\fP | \fB–connection\-close\fP +\fB\-C\fP | \fB\-\-connection\-close\fP Force each HTTP connection to be closed after each request (useful in combination with \-f to avoid having to wait for nc to time out). .TP -\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP Use the configuration and other resources for the merchant to operate from FILENAME. .TP -\fB\-h\fP | \fB–help\fP +\fB\-h\fP | \fB\-\-help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-T\fP \fIUSEC\fP | \fB–timetravel=\fP\fIUSEC\fP +\fB\-T\fP \fIUSEC\fP | \fB\-\-timetravel=\fP\fIUSEC\fP Modify the system time by \fIUSEC\fP microseconds. \fIUSEC\fP may be prefixed with \fB+\fP or \fB\-\fP (e.g. \fB\-T +300\fP). This option is intended for debugging/testing only. .TP -\fB\-v\fP | \fB–version\fP +\fB\-v\fP | \fB\-\-version\fP Print version information. .UNINDENT .SH SIGNALS @@ -100,7 +100,7 @@ cleanly. .INDENT 0.0 .TP .B TALER_MERCHANT_TOKEN -Like the “\-a” option, resets the access token for the default +Like the \(dq\-a\(dq option, resets the access token for the default instance to the given value. .UNINDENT .SH SEE ALSO diff --git a/man/taler-merchant-passwd.1 b/man/taler-merchant-passwd.1 index acd8071b..49f88e7b 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-PASSWD" "1" "Jan 06, 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 “default” instance is modified. +updated. If not given, the \(dqdefault\(dq 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 diff --git a/man/taler-merchant-setup-reserve.1 b/man/taler-merchant-setup-reserve.1 index 29185ae1..7a6bff47 100644 --- a/man/taler-merchant-setup-reserve.1 +++ b/man/taler-merchant-setup-reserve.1 @@ -27,26 +27,26 @@ 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-SETUP-RESERVE" "1" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-SETUP-RESERVE" "1" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME taler-merchant-setup-reserve \- setup reserve for rewards at a Taler merchant backend .SH SYNOPSIS .sp \fBtaler\-merchant\-setup\-reserve\fP -[\fB\-A\fP\ \fIUSERNAME:PASSWORD\fP\ |\ \fB–auth=\fP\fIUSERNAME:PASSWORD\fP] -[\fB\-a\fP\ \fIVALUE\fP\ |\ \fB–amount=\fP\fIVALUE\fP] -[\fB\-C\fP\ \fICERTFILE\fP\ |\ \fB–cert=\fP\fICERTFILE\fP] -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] -[\fB\-e\fP\ \fIURL\fP\ |\ \fB–exchange\-url=\fP\fIURL\fP] -[\fB\-h\fP\ |\ \fB–help\fP] -[\fB\-k\fP\ \fIKEYFILE\fP\ |\ \fB–key=\fP\fIKEYFILE\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIURL\fP\ |\ \fB–merchant\-url=\fP\fIURL\fP] -[\fB\-p\fP\ \fIKEYFILEPASSPHRASE\fP\ |\ \fB–pass=\fP\fIKEYFILEPASSPHRASE\fP] -[\fB\-t\fP\ \fICERTTYPE\fP\ |\ \fB–type=\fP\fICERTTYPE\fP] -[\fB\-w\fP\ \fIMETHOD\fP\ |\ \fB–wire\-method=\fP\fIMETHOD\fP] -[\fB\-v\fP\ |\ \fB–version\fP] +[\fB\-A\fP\ \fIUSERNAME:PASSWORD\fP\ |\ \fB\-\-auth=\fP\fIUSERNAME:PASSWORD\fP] +[\fB\-a\fP\ \fIVALUE\fP\ |\ \fB\-\-amount=\fP\fIVALUE\fP] +[\fB\-C\fP\ \fICERTFILE\fP\ |\ \fB\-\-cert=\fP\fICERTFILE\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] +[\fB\-e\fP\ \fIURL\fP\ |\ \fB\-\-exchange\-url=\fP\fIURL\fP] +[\fB\-h\fP\ |\ \fB\-\-help\fP] +[\fB\-k\fP\ \fIKEYFILE\fP\ |\ \fB\-\-key=\fP\fIKEYFILE\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIURL\fP\ |\ \fB\-\-merchant\-url=\fP\fIURL\fP] +[\fB\-p\fP\ \fIKEYFILEPASSPHRASE\fP\ |\ \fB\-\-pass=\fP\fIKEYFILEPASSPHRASE\fP] +[\fB\-t\fP\ \fICERTTYPE\fP\ |\ \fB\-\-type=\fP\fICERTTYPE\fP] +[\fB\-w\fP\ \fIMETHOD\fP\ |\ \fB\-\-wire\-method=\fP\fIMETHOD\fP] +[\fB\-v\fP\ |\ \fB\-\-version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-setup\-reserve\fP is a command\-line tool to setup a reserve @@ -55,68 +55,68 @@ from the exchange needed to fill the reserve. .SH OPTIONS .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 \fBUSERNAME\fP and \fBPASSWORD\fP for HTTP client authentication. -The “:” must be present as a separator. +The \(dq:\(dq must be present as a separator. Note that this form of authentication has nothing to do with the TLS client certificate authentication supported with the \fB\-C\fP, \fB\-k\fP and \fB\-p\fP options. The \fBPASSWORD\fP given to this option is given to the server! .TP -\fB\-a\fP \fIVALUE\fP | \fB–amount=\fP\fIVALUE\fP +\fB\-a\fP \fIVALUE\fP | \fB\-\-amount=\fP\fIVALUE\fP Mandatory. Amount to be transferred to the reserve. .TP -\fB\-C\fP \fICERTFILE\fP | \fB–cert=\fP\fICERTFILE\fP +\fB\-C\fP \fICERTFILE\fP | \fB\-\-cert=\fP\fICERTFILE\fP The specified \fBCERTFILE\fP contains a TLS client certificate to be used to authenticate the client. See also \fB\-t\fP\&. .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 \fBFILENAME\fP\&. .TP -\fB\-e\fP \fIURL\fP | \fB–exchange\-url=\fP\fIURL\fP +\fB\-e\fP \fIURL\fP | \fB\-\-exchange\-url=\fP\fIURL\fP Mandatory. Use \fBURL\fP for the exchange base URL. This is the exchange where the reserve will be created. The currency used in the amount specification must be offered by this exchange. .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 The specified \fBKEYFILE\fP contains a TLS client private key to be used to authenticate the client. See also \fB\-p\fP and \fB\-C\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\-m\fP \fIURL\fP | \fB–merchant\-url=\fP\fIURL\fP +\fB\-m\fP \fIURL\fP | \fB\-\-merchant\-url=\fP\fIURL\fP Mandatory. Use \fBURL\fP as the merchant base URL. Should include the path to the instance if the reserve is to be created for a non\-default instance. .TP -\fB\-p\fP \fIKEYFILEPASSPHRASE\fP | \fB–pass=\fP\fIKEYFILEPASSPHRASE\fP +\fB\-p\fP \fIKEYFILEPASSPHRASE\fP | \fB\-\-pass=\fP\fIKEYFILEPASSPHRASE\fP The specified \fBKEYFILEPASSPHRASE\fP is to be used to decrypt the KEYFILE. See also \fB\-k\fP\&. Not to be confused with \fB\-A\fP\&. The \fBKEYFILEPASSPHRASE\fP given here is only used locally to decrypt the KEYFILE. .TP -\fB\-t\fP \fICERTTYPE\fP | \fB–type=\fP\fICERTTYPE\fP +\fB\-t\fP \fICERTTYPE\fP | \fB\-\-type=\fP\fICERTTYPE\fP The specified CERTFILE contains a TLS client certificate of \fBCERTTYPE\fP\&. Default is \fBPEM\fP\&. See also \fB\-C\fP\&. .TP -\fB\-w\fP \fIMETHOD\fP | \fB–wire\-method=\fP\fIMETHOD\fP +\fB\-w\fP \fIMETHOD\fP | \fB\-\-wire\-method=\fP\fIMETHOD\fP Mandatory. Which wire method should be used. Needed to select the wire transfer method of the exchange. The method must be supported by the exchange. Typical values would be \fBiban\fP or \fBx\-taler\-bank\fP\&. .TP -\fB\-v\fP | \fB–version\fP +\fB\-v\fP | \fB\-\-version\fP Print version information. .UNINDENT .SH SEE ALSO diff --git a/man/taler-merchant-webhook.1 b/man/taler-merchant-webhook.1 index 8a3f12a2..083fc25b 100644 --- a/man/taler-merchant-webhook.1 +++ b/man/taler-merchant-webhook.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-WEBHOOK" "1" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-WEBHOOK" "1" "Jan 06, 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\ |\ \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\ |\ \fB\-\-test\fP] +[\fB\-v\fP\ |\ \fB\-\-version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-webhook\fP is a command\-line tool to trigger webhooks @@ -48,21 +48,21 @@ 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 | \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 diff --git a/man/taler-merchant-wirewatch.1 b/man/taler-merchant-wirewatch.1 index 32aa4fbd..ee51c667 100644 --- a/man/taler-merchant-wirewatch.1 +++ b/man/taler-merchant-wirewatch.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-WIREWATCH" "1" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-WIREWATCH" "1" "Jan 06, 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\-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\ |\ \fB\-\-test\fP] +[\fB\-v\fP\ |\ \fB\-\-version\fP] .SH DESCRIPTION .sp \fBtaler\-merchant\-wirewatch\fP is a command\-line tool to import @@ -49,26 +49,26 @@ 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\-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 | \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 diff --git a/man/taler-merchant-wirewatchx.1 b/man/taler-merchant-wirewatchx.1 new file mode 100644 index 00000000..3b84a40f --- /dev/null +++ b/man/taler-merchant-wirewatchx.1 @@ -0,0 +1,90 @@ +.\" Man page generated from reStructuredText. +. +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.TH "TALER-MERCHANT-WIREWATCHX" "1" "Jan 06, 2024" "0.9" "GNU Taler" +.SH NAME +taler-merchant-wirewatchx \- 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\-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 +information about incoming bank transfers into a Taler merchant +backend. This will allow the merchant backend to validate that +the exchange paid the merchant correctly. +.sp +Its options are as follows: +.INDENT 0.0 +.TP +\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 +Print short help on options. +.TP +\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 +Send logging output to \fIFILENAME\fP\&. +.TP +\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 | \fB\-\-test\fP +Run in test mode. Only runs until the current list of bank +transactions are all imported. +.TP +\fB\-v\fP | \fB–version\fP +Print version information. +.UNINDENT +.SH SEE ALSO +.sp +taler\-merchant\-httpd(1), taler.conf(5). +.SH BUGS +.sp +Report bugs by using \fI\%https://bugs.taler.net\fP or by sending 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+) +.\" Generated by docutils manpage writer. +. diff --git a/man/taler-terms-generator.1 b/man/taler-terms-generator.1 index 759e6710..8aebe8e2 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-TERMS-GENERATOR" "1" "Jan 06, 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 (“.rst”) input. It can be used to generate the responses +reStructuredText (\(dq.rst\(dq) 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 “de” or “it”). This will generate or update the respective “.po” 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 \(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\&. .TP \fB\-L\fP \fILOCALE_DIR\fP -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. +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. .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 “a4” or “letter”. +Specifies the paper format for generated PDF documents. Can be \(dqa4\(dq or \(dqletter\(dq. .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 “.rst” file. +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. .UNINDENT .SH SEE ALSO .sp diff --git a/man/taler-unified-setup.1 b/man/taler-unified-setup.1 index 91f8a841..27389517 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER-UNIFIED-SETUP" "1" "Jan 06, 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 ‘x\-taler\-bank’. +use the given wire method. Default is \(aqx\-taler\-bank\(aq. .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 diff --git a/man/taler.conf.5 b/man/taler.conf.5 index 12a4e553..352d9fcc 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" "Nov 27, 2023" "0.9" "GNU Taler" +.TH "TALER.CONF" "5" "Jan 06, 2024" "0.9" "GNU Taler" .SH NAME taler.conf \- Taler configuration file .SH DESCRIPTION @@ -44,7 +44,7 @@ whitespace around the \fB=\fP (equal sign). Section names and options are .sp The values, however, are \fIcase\-sensitive\fP\&. In particular, boolean values are one of \fBYES\fP or \fBNO\fP\&. Values can include whitespace by surrounding the -entire value with \fB"\fP (double quote). Note, however, that there are no +entire value with \fB\(dq\fP (double quote). Note, however, that there are no escape characters in such strings; all characters between the double quotes (including other double quotes) are taken verbatim. .sp @@ -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: “EUR:0.01” or “JPY:1”. +underlying RTGS. For example: \(dqEUR:0.01\(dq or \(dqJPY:1\(dq. .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 “$NAME” could +Sections with a name of the form “[currency\-$NAME]” (where \(dq$NAME\(dq 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 -{“0”:”€”} for Euros or “{“0”:”$”} for Dollars. You could -additionally use {“0”:”€”,”3”:”k€”} to render 3000 EUR +{\(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 as 3k€. For BTC a typical map would be -{“0”:”BTC”,”\-3”:”mBTC”}, informing the UI to render small +{\(dq0\(dq:\(dqBTC\(dq,\(dq\-3\(dq:\(dqmBTC\(dq}, informing the UI to render small amounts in milli\-Bitcoin (mBTC). .UNINDENT .SS EXCHANGE OPTIONS @@ -222,27 +222,27 @@ 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 “unix”) or on a TCP socket (set option to “tcp”)? +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)? .TP .B UNIXPATH -Path to listen on if we “SERVE” is set to “unix”. +Path to listen on if we \(dqSERVE\(dq is set to \(dqunix\(dq. .TP .B UNIXPATH_MODE -Access permission mask to use for the “UNIXPATH”. +Access permission mask to use for the \(dqUNIXPATH\(dq. .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. “localhost”. +Hostname to which the exchange HTTP server should be bound to, e.g. \(dqlocalhost\(dq. .TP .B MASTER_PUBLIC_KEY Crockford Base32\-encoded master public key, public version of the -exchange’s long\-time offline signing key. +exchange\(aqs long\-time offline signing key. .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: “USD:1000000”. +an AML staff member doing a (manual) AML check. For example: \(dqUSD:1000000\(dq. .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. @@ -291,7 +291,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 “taler\-exchange\-dbinit \-s” 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 \(dqtaler\-exchange\-dbinit \-s\(dq before resuming. Default is 2147483648 (no sharding). .TP .B SIGNKEY_LEGAL_DURATION For how long are signatures with signing keys legally valid? @@ -305,12 +305,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. “en/” or “fr/”. +using the two\-character language code in lower case, e.g. \(dqen/\(dq or \(dqfr/\(dq. 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 “html”, “htm”, “txt”, “pdf”, “jpg”, “jpeg”, -“png” and “gif”. For example, using a \fBTERMS_ETAG\fP of “0”, the structure +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 could be the following: .INDENT 7.0 .IP \(bu 2 @@ -329,7 +329,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 “Etag” in the HTTP request to control +The value is also used for the \(dqEtag\(dq 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 @@ -345,7 +345,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 “[kyc\-provider\-XXX]” sections. +The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections. .INDENT 0.0 .TP .B COST @@ -362,20 +362,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 “[kyc\-provider\-XXX]” sections with “LOGIC = oauth2”. +The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections with \(dqLOGIC = oauth2\(dq. .INDENT 0.0 .TP .B KYC_OAUTH2_VALIDITY -Duration (e.g. “12 months”) of the validity of the performed KYC check. Can be “forever”. +Duration (e.g. \(dq12 months\(dq) of the validity of the performed KYC check. Can be \(dqforever\(dq. .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: “\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. +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. .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 “bearer” token). Example: “\fI\%http://localhost:8888/oauth/v2/token\fP” (or just “/token”) +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) .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: “\fI\%http://localhost:8888/api/user/me\fP” or “\fI\%http://localhost:8888/oauth/v2/info\fP” +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 .TP .B KYC_OAUTH2_CLIENT_ID Client ID of the exchange when it talks to the KYC OAuth2 endpoint. @@ -384,18 +384,18 @@ 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’s browser after successful authorization/login for the KYC process. Example: “\fI\%http://example.com/thank\-you\fP” +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 .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. .UNINDENT .SS EXCHANGE KYC KYCAID OPTIONS .sp -The following options must be in the section “[kyc\-provider\-XXX]” sections with “LOGIC = kycaid”. +The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections with \(dqLOGIC = kycaid\(dq. .INDENT 0.0 .TP .B KYC_KYCAID_VALIDITY -Duration (e.g. “12 months”) of the validity of the performed KYC check. Can be “forever”. +Duration (e.g. \(dq12 months\(dq) of the validity of the performed KYC check. Can be \(dqforever\(dq. .TP .B KYC_KYCAID_AUTH_TOKEN Authentication token to access the KYC service. @@ -404,15 +404,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’s browser after successful authorization/login for the KYC process. +URL to which the exchange will redirect the client\(aqs browser after successful authorization/login for the KYC process. .UNINDENT .SS EXCHANGE KYC PERSONA OPTIONS .sp -The following options must be in the section “[kyc\-provider\-XXX]” sections with “LOGIC = persona”. +The following options must be in the section \(dq[kyc\-provider\-XXX]\(dq sections with \(dqLOGIC = persona\(dq. .INDENT 0.0 .TP .B KYC_PERSONA_VALIDITY -Duration (e.g. “12 months”) of the validity of the performed KYC check. Can be “forever”. +Duration (e.g. \(dq12 months\(dq) of the validity of the performed KYC check. Can be \(dqforever\(dq. .TP .B KYC_PERSONA_AUTH_TOKEN Authentication token to access the KYC service. @@ -424,17 +424,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 “taler\-exchange\-kyc\-persona\-converter.sh”. +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. .TP .B KYC_PERSONA_POST_URL -URL to which the exchange will redirect the client’s browser after successful authorization/login for the KYC process. +URL to which the exchange will redirect the client\(aqs 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 “[kyclogic\-persona]”. +The following option must be in the section \(dq[kyclogic\-persona]\(dq. .INDENT 0.0 .TP .B WEBHOOK_AUTH_TOKEN @@ -446,7 +446,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 -“[exchange\-extension\-<extensionname>]” and the following option: +\(dq[exchange\-extension\-<extensionname>]\(dq and the following option: .INDENT 0.0 .TP .B ENABLED @@ -456,7 +456,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 -“[exchange\-extension\-age_restriction]” with the following options: +\(dq[exchange\-extension\-age_restriction]\(dq with the following options: .INDENT 0.0 .TP .B ENABLE @@ -465,8 +465,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’th age group implicitly starts -with 0. For example, the string “10:18” would define three age groups: +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: .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 @@ -480,7 +480,7 @@ Group 2: ages 18 and above .UNINDENT .UNINDENT .sp -If not provided, the default value is “8:10:12:14:16:18:21”. +If not provided, the default value is \(dq8:10:12:14:16:18:21\(dq. .UNINDENT .sp \fBNote\fP: Age restriction is bound to specific denominations and must be @@ -489,7 +489,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 “[exchange\-offline]”. +The following options must be in the section \(dq[exchange\-offline]\(dq. .INDENT 0.0 .TP .B MASTER_PRIV_FILE @@ -516,7 +516,7 @@ this option will also be ignored. .UNINDENT .SS EXCHANGE RSA CRYPTO HELPER OPTIONS .sp -The following options must be in the section “[taler\-exchange\-secmod\-rsa]”. +The following options must be in the section \(dq[taler\-exchange\-secmod\-rsa]\(dq. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -543,7 +543,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 “[taler\-exchange\-secmod\-cs]”. +The following options must be in the section \(dq[taler\-exchange\-secmod\-cs]\(dq. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -570,7 +570,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 “[taler\-exchange\-secmod\-eddsa]”. +The following options must be in the section \(dq[taler\-exchange\-secmod\-eddsa]\(dq. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -597,7 +597,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 “[exchangedb]”. +The following options must be in the section \(dq[exchangedb]\(dq. .INDENT 0.0 .TP .B IDLE_RESERVE_EXPIRATION_TIME @@ -658,7 +658,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’s bank account (usually matching +the username of the exchange\(aqs bank account (usually matching the \fBUSERNAME\fP option used for authentication). Example: \fBhttps://bank.demo.taler.net/taler\-wire\-gateway/Exchange/\fP\&. .TP @@ -674,7 +674,7 @@ Password for \fBbasic\fP authentication with the wire gateway. .UNINDENT .SS EXCHANGE COIN OPTIONS .sp -The following options must be in sections starting with \fB"[coin_]"\fP and are +The following options must be in sections starting with \fB\(dq[coin_]\(dq\fP and are largely used by \fBtaler\-exchange\-httpd\fP to determine the meta data for the denomination keys. Some of the options are used by the \fBtaler\-exchange\-secmod\-rsa\fP to determine which RSA keys to create (and of @@ -713,12 +713,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 “CS” or “RSA”. +What cryptosystem should be used? Must be set to either \(dqCS\(dq or \(dqRSA\(dq. 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 “CIPHER=RSA”. +What is the RSA keysize modulos (in bits)? Only used if \(dqCIPHER=RSA\(dq. .TP .B AGE_RESTRICTED Setting this option to \fBYES\fP marks the denomination as age restricted @@ -735,22 +735,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 “unix”) or on a TCP socket (set option to “tcp”)? +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)? .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 “SERVE” is set to “unix”. +Path to listen on if we \(dqSERVE\(dq is set to \(dqunix\(dq. .TP .B UNIXPATH_MODE -Access permission mask to use for the “UNIXPATH”. +Access permission mask to use for the \(dqUNIXPATH\(dq. .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. “localhost”. +Hostname to which the merchant HTTP server should be bound to, e.g. \(dqlocalhost\(dq. .TP .B LEGAL_PRESERVATION How long do we keep data in the database for tax audits after the @@ -785,7 +785,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’s long\-time offline signing key. Can be omitted, in that +exchange\(aqs 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 @@ -821,19 +821,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 “unix”) or on a TCP socket (set option to “tcp”)? +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)? .TP .B UNIXPATH -Path to listen on if we “SERVE” is set to “unix”. +Path to listen on if we \(dqSERVE\(dq is set to \(dqunix\(dq. .TP .B UNIXPATH_MODE -Access permission mask to use for the “UNIXPATH”. +Access permission mask to use for the \(dqUNIXPATH\(dq. .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. “localhost”. +Hostname to which the merchant HTTP server should be bound to, e.g. \(dqlocalhost\(dq. .UNINDENT .SS AUDITOR POSTGRES BACKEND DATABASE OPTIONS .sp @@ -842,12 +842,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.\ “postgres:///taler” to use the -“taler” database. Testcases use “talercheck”. +How to access the database, e.g.\ \(dqpostgres:///taler\(dq to use the +\(dqtaler\(dq database. Testcases use “talercheck”. .UNINDENT .SS Bank Options .sp -The following options must be in section “[bank]” for the taler\-fakebank\-run(1) command. They are not used by the exchange or LibEuFin! +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! .INDENT 0.0 .TP .B HTTP_PORT |