diff options
Diffstat (limited to 'man')
37 files changed, 703 insertions, 687 deletions
diff --git a/man/libeufin-nexus.1 b/man/libeufin-nexus.1 index b3f25871..ae91147a 100644 --- a/man/libeufin-nexus.1 +++ b/man/libeufin-nexus.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "LIBEUFIN-NEXUS" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "LIBEUFIN-NEXUS" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME libeufin-nexus \- sevice to interface to various bank access APIs . @@ -33,9 +33,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 Commands: serve, superuser, parse\-camt, reset\-tables .SH DESCRIPTION @@ -53,7 +53,7 @@ useful for doing administrative tasks. 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 diff --git a/man/libeufin-sandbox.1 b/man/libeufin-sandbox.1 index ed149189..452739a6 100644 --- a/man/libeufin-sandbox.1 +++ b/man/libeufin-sandbox.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "LIBEUFIN-SANDBOX" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "LIBEUFIN-SANDBOX" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME libeufin-sandbox \- simulate core banking system with EBICS access to bank accounts . @@ -33,9 +33,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 “demobank” (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 @@ -132,7 +132,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 “legacy” 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 d2788937..e3097a12 100644 --- a/man/sync-config.1 +++ b/man/sync-config.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNC-CONFIG" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "SYNC-CONFIG" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME sync-config \- manipulate Sync configuration files . @@ -33,69 +33,69 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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. “namestore_postgres” for +the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is supported, sync\-config will return a status code of 0 (success), otherwise 77 (unsupported). When this option is specified, no other options may be specified. Specifying this option together with other options will cause sync\-config to return a status code of 1 (error). .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration file \fIFILENAME\fP\&. .TP -\fB\-f\fP | \fB\-\-filename\fP +\fB\-f\fP | \fB–filename\fP Try to perform expansions as if the option values represent filenames (will also be applied even if the option is not really a filename). .TP -\fB\-F\fP | \fB\-\-full\fP +\fB\-F\fP | \fB–full\fP Write the full configuration file, not just the differences to the defaults. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Use \fILOGLEVEL\fP for logging. Valid values are \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, and \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-o\fP \fIOPTION\fP | \fB\-\-option=\fP\fIOPTION\fP +\fB\-o\fP \fIOPTION\fP | \fB–option=\fP\fIOPTION\fP Which configuration option should be accessed or edited. Required to set a value. If not given, all values of a given section will be printed in the -format "OPTION = VALUE". +format “OPTION = VALUE”. .TP -\fB\-r\fP | \fB\-\-rewrite\fP +\fB\-r\fP | \fB–rewrite\fP Write the configuration file even if nothing changed. Will remove all comments! .TP -\fB\-S\fP | \fB\-\-list\-sections\fP +\fB\-S\fP | \fB–list\-sections\fP List available configuration sections for use with \fB\-\-section\fP\&. .TP -\fB\-s\fP \fISECTION\fP | \fB\-\-section=\fP\fISECTION\fP +\fB\-s\fP \fISECTION\fP | \fB–section=\fP\fISECTION\fP Which configuration section should be accessed or edited. Required option. .TP -\fB\-V\fP \fIVALUE\fP | \fB\-\-value=\fP\fIVALUE\fP +\fB\-V\fP \fIVALUE\fP | \fB–value=\fP\fIVALUE\fP Configuration value to store in the given section under the given option. Must only be given together with \fB\-s\fP and \fB\-o\fP options. .INDENT 7.0 @@ -105,7 +105,7 @@ Changing the configuration file with \fB\-V\fP will remove comments and may reorder sections and remove \fB@INLINE@\fP directives. .UNINDENT .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print GNU Taler version number. .UNINDENT .SH SEE ALSO diff --git a/man/sync-dbinit.1 b/man/sync-dbinit.1 index 37394eb1..ab5f53ce 100644 --- a/man/sync-dbinit.1 +++ b/man/sync-dbinit.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNC-DBINIT" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "SYNC-DBINIT" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME sync-dbinit \- initialize the Sync database . @@ -33,13 +33,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] 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 68192db1..1ed1844f 100644 --- a/man/sync-httpd.1 +++ b/man/sync-httpd.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNC-HTTPD" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "SYNC-HTTPD" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME sync-httpd \- provide the Sync HTTP interface . @@ -33,16 +33,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] 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 ea9dd093..f7086469 100644 --- a/man/sync.conf.5 +++ b/man/sync.conf.5 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNC.CONF" "5" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "SYNC.CONF" "5" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME sync.conf \- Sync configuration file . diff --git a/man/taler-auditor-dbinit.1 b/man/taler-auditor-dbinit.1 index 6a91ecfe..c9ca739a 100644 --- a/man/taler-auditor-dbinit.1 +++ b/man/taler-auditor-dbinit.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-AUDITOR-DBINIT" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-DBINIT" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-auditor-dbinit \- setup auditor database . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 295158a3..44a84bdd 100644 --- a/man/taler-auditor-exchange.1 +++ b/man/taler-auditor-exchange.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-AUDITOR-EXCHANGE" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-EXCHANGE" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-auditor-exchange \- add or remove exchange from auditor’s list . @@ -33,12 +33,12 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 3bcbdfaa..61cffcd0 100644 --- a/man/taler-auditor-httpd.1 +++ b/man/taler-auditor-httpd.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-AUDITOR-HTTPD" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-HTTPD" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-auditor-httpd \- HTTP server providing a RESTful API to access a Taler auditor . @@ -33,13 +33,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 ef1c81f3..7993f4f8 100644 --- a/man/taler-auditor-offline.1 +++ b/man/taler-auditor-offline.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-AUDITOR-OFFLINE" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-OFFLINE" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-auditor-offline \- Taler auditor certifies that it audits a Taler exchange . @@ -33,12 +33,12 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .SH SYNOPSIS .sp \fBtaler\-auditor\-offline\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[subcommand ...] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[subcommand …] .SH DESCRIPTION .sp \fBtaler\-auditor\-offline\fP is a command\-line tool to be used by an auditor to @@ -47,7 +47,7 @@ signature, the auditor affirms that he will verify that the exchange is properly accounting for coins of those denominations. The tool takes a list of subcommands as arguments which are then processed sequentially. .sp -The tool includes two subcommands to interact \fIonline\fP with the exchange\(aqs +The tool includes two subcommands to interact \fIonline\fP with the exchange’s REST APIs. The \fBdownload\fP subcommand downloads current public keys from the running exchange. Note that this only includes keys that the exchange operator has previously validated using the \fBtaler\-exchange\-offline\fP tool. @@ -55,10 +55,10 @@ The resulting data serves as input to the \fBsign\fP and \fBshow\fP subcommands. .sp The \fBupload\fP subcommand uploads the signatures created with the private key to the exchange. It handles the output of all subcommands (except \fBdownload\fP). -The \fBdownload\fP and \fBupload\fP subcommands must naturally be run "online" and do not -require access to the auditor\(aqs private key, which should be kept offline. +The \fBdownload\fP and \fBupload\fP subcommands must naturally be run “online” and do not +require access to the auditor’s private key, which should be kept offline. .sp -All other subcommands are intended to be run "offline". However, especially +All other subcommands are intended to be run “offline”. However, especially when testing, it is of course possible to run the subcommands online as well. Generally, subcommands read inputs (beyond command\-line arguments) from \fBstdin\fP\&. However, they may also consume outputs of previous @@ -68,28 +68,28 @@ and if not consumed the final output is printed to \fBstdout\fP\&. The general options for \fBtaler\-auditor\-offline\fP are: .INDENT 0.0 .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the merchant to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH CONFIGURATION .sp The exchange and the \fBtaler\-auditor\-httpd\fP must both be provided with -the auditor\(aqs public key, such that they can validate messages signed -by the auditor. To obtain the auditor\(aqs public key, use: +the auditor’s public key, such that they can validate messages signed +by the auditor. To obtain the auditor’s public key, use: .INDENT 0.0 .INDENT 3.5 .sp @@ -102,13 +102,13 @@ $ taler\-auditor\-offline setup .UNINDENT .sp Note that if the private key file already exists, the above will simply output -the existing key. Passing additional arguments after setup (including "\-") +the existing key. Passing additional arguments after setup (including “\-“) will cause the output to be encapsulated in JSON. .sp Relevant configuration options for \fBtaler\-auditor\-offline\fP are: .INDENT 0.0 .IP \(bu 2 -\fB[auditor/AUDITOR_PRIV_FILE]\fP \-\-\- where to store the private key +\fB[auditor/AUDITOR_PRIV_FILE]\fP — where to store the private key .UNINDENT .SH SUBCOMMANDS .SS setup diff --git a/man/taler-auditor-sync.1 b/man/taler-auditor-sync.1 index f8eb8928..6ba28d4f 100644 --- a/man/taler-auditor-sync.1 +++ b/man/taler-auditor-sync.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-AUDITOR-SYNC" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-AUDITOR-SYNC" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-auditor-sync \- tool to safely synchronize auditor database . @@ -33,17 +33,17 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .SH SYNOPSIS .sp \fBtaler\-auditor\-sync\fP -[\fB\-s\fP\ \fIFILENAME\fP\ |\ \fB\-\-source\-configuration=\fP\fIFILENAME\fP] -[\fB\-d\fP\ \fIFILENAME\fP\ |\ \fB\-\-destination\-configuration=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-b\fP\ \fISIZE\fP\ |\ \fB\-\-batch=\fP\fISIZE\fP] -[\fB\-t\fP\ |\ \fB\-\-terminate\-when\-synchronized\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] +[\fB\-s\fP\ \fIFILENAME\fP\ |\ \fB–source\-configuration=\fP\fIFILENAME\fP] +[\fB\-d\fP\ \fIFILENAME\fP\ |\ \fB–destination\-configuration=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-b\fP\ \fISIZE\fP\ |\ \fB–batch=\fP\fISIZE\fP] +[\fB\-t\fP\ |\ \fB–terminate\-when\-synchronized\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] .SH DESCRIPTION .sp \fBtaler\-auditor\-sync\fP is a command\-line tool to synchronize the -Taler auditor\(aqs database in a safe way from a Taler exchange +Taler auditor’s database in a safe way from a Taler exchange database. If the exchange database violates the assumed database invariants (as expressed by database constraints) or attempts to DELETE or UPDATE tables (at least those that the auditor relies @@ -53,31 +53,31 @@ and instead halt with an error. Its options are as follows: .INDENT 0.0 .TP -\fB\-s\fP \fIFILENAME\fP | \fB\-\-source\-configuration=\fP\fIFILENAME\fP +\fB\-s\fP \fIFILENAME\fP | \fB–source\-configuration=\fP\fIFILENAME\fP Use the configuration in \fIFILENAME\fP to access the original (source) exchange database to copy records from. .TP -\fB\-d\fP \fIFILENAME\fP | \fB\-\-destination\-configuration=\fP\fIFILENAME\fP +\fB\-d\fP \fIFILENAME\fP | \fB–destination\-configuration=\fP\fIFILENAME\fP Use the configuration in \fIFILENAME\fP to access the target (destination) exchange database to copy records to. .TP -\fB\-t\fP | \fB\-\-terminate\-when\-synchronized\fP +\fB\-t\fP | \fB–terminate\-when\-synchronized\fP The program should exit once the two databases are in sync, instead of continuously copying more records when the source database is updated. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-b\fP \fISIZE\fP | \fB\-\-batch=\fP\fISIZE\fP +\fB\-b\fP \fISIZE\fP | \fB–batch=\fP\fISIZE\fP Target number of records to copy in one transaction. Once the databases are in sync, the batch size is used to determine how long the process sleeps before trying to again synchronize the two databases. Not useful if \fB\-t\fP is used. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO diff --git a/man/taler-auditor.1 b/man/taler-auditor.1 index b76b818b..9c1b596e 100644 --- a/man/taler-auditor.1 +++ b/man/taler-auditor.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-AUDITOR" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-AUDITOR" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-auditor \- audit exchange . @@ -33,15 +33,15 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 “safe” replicated database at the auditor. .TP -\fB\-I\fP | \fB\-\-ignore\-not\-found\fP +\fB\-I\fP | \fB–ignore\-not\-found\fP Do not fail if the bank says that the exchange bank account does not (yet) exist. Keep trying. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Public master key of the exchange in Crockford base32 encoding, for example as generated by \fBtaler\-auditor\-offline setup\fP\&. If this option is missing, taler\-auditor will use the MASTER_PUBLIC_KEY value from the “exchange” section of the configuration. .TP -\fB\-T\fP \fIUSEC\fP | \fB\-\-timetravel=\fP\fIUSEC\fP +\fB\-T\fP \fIUSEC\fP | \fB–timetravel=\fP\fIUSEC\fP Modify the system time by \fIUSEC\fP microseconds. \fIUSEC\fP may be prefixed with \fB+\fP or \fB\-\fP (e.g. \fB\-T +300\fP). This option is intended for debugging/testing only. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO diff --git a/man/taler-config.1 b/man/taler-config.1 index 8026c363..20efb4f1 100644 --- a/man/taler-config.1 +++ b/man/taler-config.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-CONFIG" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-CONFIG" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-config \- Taler configuration inspection and editing . @@ -33,69 +33,69 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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. “namestore_postgres” for +the PostgreSQL database backend of the “NAMESTORE” service. If \fIBACKEND\fP is supported, taler\-config will return a status code of 0 (success), otherwise 77 (unsupported). When this option is specified, no other options may be specified. Specifying this option together with other options will cause taler\-config to return a status code of 1 (error). .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration file \fIFILENAME\fP\&. .TP -\fB\-f\fP | \fB\-\-filename\fP +\fB\-f\fP | \fB–filename\fP Try to perform expansions as if the option values represent filenames (will also be applied even if the option is not really a filename). .TP -\fB\-F\fP | \fB\-\-full\fP +\fB\-F\fP | \fB–full\fP Write the full configuration file, not just the differences to the defaults. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Use \fILOGLEVEL\fP for logging. Valid values are \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, and \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-o\fP \fIOPTION\fP | \fB\-\-option=\fP\fIOPTION\fP +\fB\-o\fP \fIOPTION\fP | \fB–option=\fP\fIOPTION\fP Which configuration option should be accessed or edited. Required to set a value. If not given, all values of a given section will be printed in the -format "OPTION = VALUE". +format “OPTION = VALUE”. .TP -\fB\-r\fP | \fB\-\-rewrite\fP +\fB\-r\fP | \fB–rewrite\fP Write the configuration file even if nothing changed. Will remove all comments! .TP -\fB\-S\fP | \fB\-\-list\-sections\fP +\fB\-S\fP | \fB–list\-sections\fP List available configuration sections for use with \fB\-\-section\fP\&. .TP -\fB\-s\fP \fISECTION\fP | \fB\-\-section=\fP\fISECTION\fP +\fB\-s\fP \fISECTION\fP | \fB–section=\fP\fISECTION\fP Which configuration section should be accessed or edited. Required option. .TP -\fB\-V\fP \fIVALUE\fP | \fB\-\-value=\fP\fIVALUE\fP +\fB\-V\fP \fIVALUE\fP | \fB–value=\fP\fIVALUE\fP Configuration value to store in the given section under the given option. Must only be given together with \fB\-s\fP and \fB\-o\fP options. .INDENT 7.0 @@ -105,7 +105,7 @@ Changing the configuration file with \fB\-V\fP will remove comments and may reorder sections and remove \fB@INLINE@\fP directives. .UNINDENT .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print GNU Taler version number. .UNINDENT .SH SEE ALSO diff --git a/man/taler-exchange-aggregator.1 b/man/taler-exchange-aggregator.1 index 5d9900da..a60f55f4 100644 --- a/man/taler-exchange-aggregator.1 +++ b/man/taler-exchange-aggregator.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-AGGREGATOR" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-AGGREGATOR" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-aggregator \- aggregate deposits into wire transfers . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 “taler\-exchange\-dbinit \-s” to release the shard locks before restarting the aggregator. .INDENT 0.0 .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the exchange to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-T\fP \fIUSEC\fP | \fB\-\-timetravel=\fP\fIUSEC\fP +\fB\-T\fP \fIUSEC\fP | \fB–timetravel=\fP\fIUSEC\fP Modify the system time by \fIUSEC\fP microseconds. \fIUSEC\fP may be prefixed with \fB+\fP or \fB\-\fP (e.g. \fB\-T +300\fP). This option is intended for debugging/testing only. .TP -\fB\-t\fP | \fB\-\-test\fP +\fB\-t\fP | \fB–test\fP Run in test mode and exit when idle. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .TP -\fB\-y\fP | \fB\-\-kyc\-off\fP +\fB\-y\fP | \fB–kyc\-off\fP Run without KYC checks. Talk with your regulator before using this option. .UNINDENT .SH SEE ALSO diff --git a/man/taler-exchange-benchmark.1 b/man/taler-exchange-benchmark.1 index aa3a2722..50ab5721 100644 --- a/man/taler-exchange-benchmark.1 +++ b/man/taler-exchange-benchmark.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-BENCHMARK" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-BENCHMARK" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-benchmark \- measure exchange performance . @@ -33,19 +33,19 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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\-K\fP\ |\ \fB\-\-linger\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\ \fIMODE\fP\ |\ \fB\-\-mode=\fP\fIMODE\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\-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\-K\fP\ |\ \fB–linger\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\ \fIMODE\fP\ |\ \fB–mode=\fP\fIMODE\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\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-exchange\-benchmark\fP is a command\-line tool to measure the time @@ -56,50 +56,50 @@ Nginx. Moreover, the benchmark runs on a “volatile” database, that means that table are always erased during a single benchmark run. .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 Launch a fakebank instead of the Python bank. Only meaningful if the mode is to launch more than just a client. Note that using the fakebank will cause the benchmark application to reset all databases as the fakebank is stateless and thus previous database state would inherently cause trouble. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Prints a compiled\-in help text. .TP -\fB\-K\fP | \fB\-\-linger\fP +\fB\-K\fP | \fB–linger\fP Linger around until keypress after the benchmark is done. .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 \fIMODE\fP | \fB\-\-mode=\fP\fIMODE\fP +\fB\-m\fP \fIMODE\fP | \fB–mode=\fP\fIMODE\fP Mode of operation. Accepted values are: \fBexchange\fP, \fBclients\fP, \fBboth\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\-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 677947f9..9eab2dd8 100644 --- a/man/taler-exchange-closer.1 +++ b/man/taler-exchange-closer.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-CLOSER" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-CLOSER" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-closer \- close idle reserves . @@ -33,13 +33,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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-dbinit.1 b/man/taler-exchange-dbinit.1 index cf5b6da6..824a133c 100644 --- a/man/taler-exchange-dbinit.1 +++ b/man/taler-exchange-dbinit.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-DBINIT" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-DBINIT" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-dbinit \- initialize Taler exchange database . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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-expire.1 b/man/taler-exchange-expire.1 index 44460688..ced311f0 100644 --- a/man/taler-exchange-expire.1 +++ b/man/taler-exchange-expire.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-EXPIRE" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-EXPIRE" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-expire \- refund expired purses . @@ -33,13 +33,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 dafab016..90c04e71 100644 --- a/man/taler-exchange-httpd.1 +++ b/man/taler-exchange-httpd.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-HTTPD" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-HTTPD" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-httpd \- run Taler exchange (with RESTful API) . @@ -33,18 +33,18 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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-offline.1 b/man/taler-exchange-offline.1 index 104e54ee..da91e9d8 100644 --- a/man/taler-exchange-offline.1 +++ b/man/taler-exchange-offline.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-OFFLINE" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-OFFLINE" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-offline \- operations using the offline key of a Taler exchange . @@ -33,21 +33,21 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .SH SYNOPSIS .sp \fBtaler\-exchange\-offline\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] -[subcommand ...] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-v\fP\ |\ \fB–version\fP] +[subcommand …] .SH DESCRIPTION .sp \fBtaler\-exchange\-offline\fP is a command\-line tool to interact with the Taler -exchange\(aqs master private key. Most operations of this tool require access to +exchange’s master private key. Most operations of this tool require access to the exchange’s long\-term offline signing key and should be run in a secure (offline) environment under strict controls. The tool takes a list of subcommands as arguments which are then processed sequentially. .sp -The tool includes two subcommands to interact \fIonline\fP with the exchange\(aqs +The tool includes two subcommands to interact \fIonline\fP with the exchange’s REST APIs. To determine how to talk to the exchange, these two subcommands rely on the \fBBASE_URL\fP configuration option from the \fB[exchange]\fP section of the configuration file. The \fBdownload\fP subcommand downloads the future @@ -55,10 +55,10 @@ public keys from the running exchange. The resulting data serves as input to the \fBsign\fP and \fBshow\fP subcommands. The \fBupload\fP subcommand uploads the signatures created with the private master key to the exchange. It handles the output of all subcommands (except \fBdownload\fP). The \fBdownload\fP and -\fBupload\fP subcommands must naturally be run "online" and do not require +\fBupload\fP subcommands must naturally be run “online” and do not require access to the offline key. .sp -All other subcommands are intended to be run "offline". However, especially +All other subcommands are intended to be run “offline”. However, especially when testing, it is of course possible to run the subcommands online as well. Generally, subcommands read inputs (beyond command\-line arguments) from \fBstdin\fP\&. However, they may also consume outputs of previous @@ -68,21 +68,21 @@ and if not consumed the final output is printed to \fBstdout\fP\&. The general options for \fBtaler\-exchange\-offline\fP are: .INDENT 0.0 .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the merchant to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH CONFIGURATION @@ -102,17 +102,17 @@ $ taler\-exchange\-offline setup .UNINDENT .sp Note that if the private key file already exists, the above will simply output -the existing key. Passing additional arguments after setup (including "\-") +the existing key. Passing additional arguments after setup (including “\-“) will cause the output to be encapsulated in JSON. .sp Relevant configuration options for \fBtaler\-exchange\-offline\fP are: .INDENT 0.0 .IP \(bu 2 -\fB[exchange/BASE_URL]\fP \-\-\- how to reach the exchange (for download/upload) +\fB[exchange/BASE_URL]\fP — how to reach the exchange (for download/upload) .IP \(bu 2 -\fB[exchange\-offline/MASTER_PRIV_FILE]\fP \-\-\- where to store the private keys +\fB[exchange\-offline/MASTER_PRIV_FILE]\fP — where to store the private keys .IP \(bu 2 -\fB[exchange\-offline/SECM_TOFU_FILE]\fP \-\-\- where to store TOFU data +\fB[exchange\-offline/SECM_TOFU_FILE]\fP — where to store TOFU data .UNINDENT .SH SUBCOMMANDS .SS setup @@ -150,6 +150,22 @@ directly. .sp It outputs the signatures over \fIall\fP denomination and signing keys present in the input, in a format suitable for the \fBupload\fP subcommand. +.SS extensions +.sp +This subcommand is responsible for the management of available extensions in +the exchange. +.sp +It consumes the output of the \fBdownload\fP subcommand, either from \fBstdin\fP or +directly. +.sp +It provides the sub\-subcommand \fBextensions show\fP to show the configuration +for extensions and the \fBextensions sign\fP command to sign the current +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 +the signing key and the signed configuration been uploaded to the exchange. .SS revoke\-denomination .sp This subcommand signs a revocation message for a denomination key. @@ -172,23 +188,23 @@ in a format suitable for the \fBupload\fP subcommand. .sp This subcommand informs an exchange that an auditor is to be activated. Afterwards, the -exchange will accept inputs from that auditor\(aqs \fBtaler\-auditor\-offline\fP +exchange will accept inputs from that auditor’s \fBtaler\-auditor\-offline\fP tool. Note that the auditor also must add the exchange to the list of exchanges that it audits via \fBtaler\-auditor\-exchange\fP\&. Furthermore, the -exchange\(aqs database will need to be provided to the auditor. This subcommand +exchange’s database will need to be provided to the auditor. This subcommand only informs the exchange about the auditor, but does not perform those additional mandatory steps for a working auditor. .sp -The auditor\(aqs public key must be given in the usual base32\-encoding as the +The auditor’s public key must be given in the usual base32\-encoding as the first argument. .sp -The auditor\(aqs REST API base URL must be given as the second argument. The tool -performs a minimal sanity check, namely that the URL begins with "http" -(this also allows "https"), but as it runs offline does not perform any further +The auditor’s REST API base URL must be given as the second argument. The tool +performs a minimal sanity check, namely that the URL begins with “http” +(this also allows “https”), but as it runs offline does not perform any further validation! .sp The third argument must be a human\-readable name for the auditor. This may -be shown to users and should identify the auditor\(aqs business entity. If +be shown to users and should identify the auditor’s business entity. If the name includes spaces, the argument should be quoted. .sp The subcommand takes no inputs from \fBstdin\fP or other subcommands. @@ -199,10 +215,10 @@ in a format suitable for the \fBupload\fP subcommand. .sp This subcommand informs an exchange that an auditor is to be deactivated. Afterwards, the -exchange will refuse inputs from that auditor\(aqs \fBtaler\-auditor\-offline\fP +exchange will refuse inputs from that auditor’s \fBtaler\-auditor\-offline\fP tool. .sp -The auditor\(aqs public key must be given in the usual base32\-encoding as the +The auditor’s public key must be given in the usual base32\-encoding as the first argument. .sp The subcommand takes no inputs from \fBstdin\fP or other subcommands. @@ -221,7 +237,7 @@ account information advertized could theoretically differ from that which these tool actually use, for example if the public bank account is only a front for the actual internal business accounts. .sp -The \fBpayto://\fP URI (RFC 8905) of the exchange\(aqs bank account must be given +The \fBpayto://\fP URI (RFC 8905) of the exchange’s bank account must be given as the first argument to the subcommand. .sp The subcommand takes no inputs from \fBstdin\fP or other subcommands. @@ -234,7 +250,7 @@ This subcommand informs an exchange that it should stop advertising a bank account as belonging to the exchange on its \fB/wire\fP endpoint. .sp -The \fBpayto://\fP URI (RFC 8905) of the exchange\(aqs (former) bank account must be +The \fBpayto://\fP URI (RFC 8905) of the exchange’s (former) bank account must be given as the first argument to the subcommand. .sp The subcommand takes no inputs from \fBstdin\fP or other subcommands. @@ -288,11 +304,11 @@ Partner exchange base URL. .IP 2. 3 Partner exchange master public key. .IP 3. 3 -Calendar year for which the fee applies, \(aqnow\(aq for the current year. +Calendar year for which the fee applies, ‘now’ for the current year. .IP 4. 3 -Wad frequency, in minutes (for example, \(aq30\(aq). +Wad frequency, in minutes (for example, ‘30’). .IP 5. 3 -Wad fee (for example, \(aqKUDOS:0.1\(aq). +Wad fee (for example, ‘KUDOS:0.1’). .UNINDENT .UNINDENT .UNINDENT @@ -305,7 +321,7 @@ The arguments provided must include: .INDENT 3.5 .INDENT 0.0 .IP 1. 3 -Calendar year for which the fee applies, \(aqnow\(aq for the current year. +Calendar year for which the fee applies, ‘now’ for the current year. .IP 2. 3 KYC timeout. How long does the exchange keep a reserve open that is waiting for the KYC. .IP 3. 3 @@ -465,7 +481,7 @@ $ taler\-exchange\-offline revoke\-signkey $SK revoke\-denomkey $DKH > mix.json .UNINDENT .UNINDENT .sp -The outputs ("revoke.json", "mix.json") must be uploaded using the \fBupload\fP +The outputs (“revoke.json”, “mix.json”) must be uploaded using the \fBupload\fP subcommand to the exchange to actually revoke the keys. .SH SECURITY CONSIDERATIONS .sp @@ -474,8 +490,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 “enable” (or “disable”) message after a more recent “disable” (or +“enable”) message has been provided to the exchange. Thus, there is no need to keep the actual files exchanged with the offline tool secret. .sp The \fBtaler\-exchange\-offline\fP tool tries to make sure that the online signing @@ -485,7 +501,7 @@ but \fInot\fP the security modules from providing attacker\-controlled keys to t offline signing process. .sp For this, the \fBtaler\-exchange\-offline\fP signing subcommand always -automatically learns the security module\(aqs public signing key and \fItrusts it +automatically learns the security module’s public signing key and \fItrusts it on first use\fP (TOFU), but stores it to disk (see the \fBSECM_TOFU_FILE\fP option in the \fB[exchange\-offline]\fP section of the configuration). If the keys change subsequently, the tool will refuse to sign. diff --git a/man/taler-exchange-router.1 b/man/taler-exchange-router.1 index b6bed7d2..e12c4e1d 100644 --- a/man/taler-exchange-router.1 +++ b/man/taler-exchange-router.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-ROUTER" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-ROUTER" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-router \- route payments to partner exchanges . @@ -33,13 +33,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 64a75638..9a0d61e5 100644 --- a/man/taler-exchange-secmod-cs.1 +++ b/man/taler-exchange-secmod-cs.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-SECMOD-CS" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-CS" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-secmod-cs \- handle private CS key operations for a Taler exchange . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 641012c3..555ee99a 100644 --- a/man/taler-exchange-secmod-eddsa.1 +++ b/man/taler-exchange-secmod-eddsa.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-SECMOD-EDDSA" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-EDDSA" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-secmod-eddsa \- handle private EDDSA key operations for a Taler exchange . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 4f8e34ee..9ce7c1ca 100644 --- a/man/taler-exchange-secmod-rsa.1 +++ b/man/taler-exchange-secmod-rsa.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-SECMOD-RSA" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-SECMOD-RSA" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-secmod-rsa \- handle private RSA key operations for a Taler exchange . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 84fb5348..b023dace 100644 --- a/man/taler-exchange-transfer.1 +++ b/man/taler-exchange-transfer.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-TRANSFER" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-TRANSFER" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-transfer \- execute wire transfers . @@ -33,42 +33,42 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 c8f3f2c6..948978ab 100644 --- a/man/taler-exchange-wire-gateway-client.1 +++ b/man/taler-exchange-wire-gateway-client.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-WIRE-GATEWAY-CLIENT" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-WIRE-GATEWAY-CLIENT" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-wire-gateway-client \- trigger a transfer at the bank . @@ -33,22 +33,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 d812f1de..8d3d9ca0 100644 --- a/man/taler-exchange-wirewatch.1 +++ b/man/taler-exchange-wirewatch.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-EXCHANGE-WIREWATCH" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-EXCHANGE-WIREWATCH" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-exchange-wirewatch \- watch for incoming wire transfers . @@ -33,15 +33,15 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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,37 +50,37 @@ 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\-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 c6245404..d6298652 100644 --- a/man/taler-helper-auditor-aggregation.1 +++ b/man/taler-helper-auditor-aggregation.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-HELPER-AUDITOR-AGGREGATION" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-AGGREGATION" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-aggregation \- audit Taler exchange aggregation activity . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 0bc27d65..57cdadcf 100644 --- a/man/taler-helper-auditor-coins.1 +++ b/man/taler-helper-auditor-coins.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-HELPER-AUDITOR-COINS" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-COINS" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-coins \- audit Taler coin processing . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 3fa704e8..0e0a1484 100644 --- a/man/taler-helper-auditor-deposits.1 +++ b/man/taler-helper-auditor-deposits.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-HELPER-AUDITOR-DEPOSITS" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-DEPOSITS" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-deposits \- audit Taler exchange database for deposit confirmation consistency . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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-reserves.1 b/man/taler-helper-auditor-reserves.1 index f843680b..bfa70525 100644 --- a/man/taler-helper-auditor-reserves.1 +++ b/man/taler-helper-auditor-reserves.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-HELPER-AUDITOR-RESERVES" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-RESERVES" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-reserves \- audit Taler exchange reserve handling . @@ -33,14 +33,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 8ad9fd02..675947c9 100644 --- a/man/taler-helper-auditor-wire.1 +++ b/man/taler-helper-auditor-wire.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-HELPER-AUDITOR-WIRE" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-HELPER-AUDITOR-WIRE" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-helper-auditor-wire \- audit exchange database for consistency with the bank's wire transfers . @@ -33,50 +33,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .SH SYNOPSIS .sp \fBtaler\-helper\-auditor\-wire\fP -[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB\-\-config=\fP\fIFILENAME\fP] -[\fB\-h\fP\ |\ \fB\-\-help\fP] -[\fBi\fP\ |\ \fB\-\-internal\fP] -[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB\-\-loglevel=\fP\fILOGLEVEL\fP] -[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB\-\-logfile=\fP\fIFILENAME\fP] -[\fB\-m\fP\ \fIKEY\fP\ |\ \fB\-\-exchange\-key=\fP\fIKEY\fP] -[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB\-\-timetravel=\fP\fIUSEC\fP] -[\fB\-v\fP\ |\ \fB\-\-version\fP] +[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP\fIFILENAME\fP] +[\fB\-h\fP\ |\ \fB–help\fP] +[\fBi\fP\ |\ \fB–internal\fP] +[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP\fILOGLEVEL\fP] +[\fB\-l\fP\ \fIFILENAME\fP\ |\ \fB–logfile=\fP\fIFILENAME\fP] +[\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP\fIKEY\fP] +[\fB\-T\fP\ \fIUSEC\fP\ |\ \fB–timetravel=\fP\fIUSEC\fP] +[\fB\-v\fP\ |\ \fB–version\fP] .SH DESCRIPTION .sp \fBtaler\-helper\-auditor\-wire\fP is a command\-line tool to -audit exchange database for consistency with the bank\(aqs wire transfers. +audit exchange database for consistency with the bank’s wire transfers. .sp FIXME: More detail. .sp Its options are as follows: .INDENT 0.0 .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the auditor to operate from \fIFILENAME\fP\&. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-i\fP | \fB\-\-internal\fP +\fB\-i\fP | \fB–internal\fP Perform checks only applicable for exchange\-internal audits. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-m\fP \fIKEY\fP | \fB\-\-exchange\-key=\fP\fIKEY\fP +\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP\fIKEY\fP Use \fIKEY\fP (Crockford base32 encoded) as the public key of the exchange. .TP -\fB\-T\fP \fIUSEC\fP | \fB\-\-timetravel=\fP\fIUSEC\fP +\fB\-T\fP \fIUSEC\fP | \fB–timetravel=\fP\fIUSEC\fP Modify the system time by \fIUSEC\fP microseconds. \fIUSEC\fP may be prefixed with \fB+\fP or \fB\-\fP (e.g. \fB\-T +300\fP). This option is intended for debugging/testing only. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SEE ALSO diff --git a/man/taler-merchant-benchmark.1 b/man/taler-merchant-benchmark.1 index 5c1d30df..81479950 100644 --- a/man/taler-merchant-benchmark.1 +++ b/man/taler-merchant-benchmark.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-MERCHANT-BENCHMARK" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-BENCHMARK" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-merchant-benchmark \- generate Taler-style benchmarking payments . @@ -46,10 +46,10 @@ default instance) and aggregated by the exchange. Takes the following options. .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. .TP -\fB\-t\fP \fITN\fP | \fB\-\-tracks\-number=\fP\fITN\fP +\fB\-t\fP \fITN\fP | \fB–tracks\-number=\fP\fITN\fP Perform TN many tracking operations, defaults to 1. .UNINDENT .TP @@ -59,11 +59,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. @@ -72,28 +72,28 @@ unaggregated payments and actually aggregated them. .SH COMMON OPTIONS .INDENT 0.0 .TP -\fB\-a\fP \fIAPIKEY\fP | \fB\-\-apikey=\fP\fIAPIKEY\fP -HTTP \(aqAuthorization\(aq header to send to the merchant. +\fB\-a\fP \fIAPIKEY\fP | \fB–apikey=\fP\fIAPIKEY\fP +HTTP ‘Authorization’ header to send to the merchant. .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the merchant to operate from FILENAME. .TP -\fB\-e\fP \fISECTION\fP | \fB\-\-exchange\-account=\fP\fISECTION\fP +\fB\-e\fP \fISECTION\fP | \fB–exchange\-account=\fP\fISECTION\fP Mandatory. 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-dbinit.1 b/man/taler-merchant-dbinit.1 index be9a2ffd..283fc536 100644 --- a/man/taler-merchant-dbinit.1 +++ b/man/taler-merchant-dbinit.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-MERCHANT-DBINIT" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-DBINIT" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-merchant-dbinit \- initialize Taler merchant database . @@ -33,12 +33,12 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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-httpd.1 b/man/taler-merchant-httpd.1 index 9dc08432..92854b5c 100644 --- a/man/taler-merchant-httpd.1 +++ b/man/taler-merchant-httpd.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-MERCHANT-HTTPD" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-HTTPD" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-merchant-httpd \- run Taler merchant backend (with RESTful API) . @@ -33,13 +33,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .SH SYNOPSIS .sp \fBtaler\-merchant\-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\ \fIUSEC\fP\ |\ \fB\-\-timetravel\fP\fIUSEC\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\ \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 @@ -48,44 +48,44 @@ before running this command. .SH OPTIONS .INDENT 0.0 .TP -\fB\-a\fP \fITOKEN\fP | \fB\-\-auth=\fP\fITOKEN\fP +\fB\-a\fP \fITOKEN\fP | \fB–auth=\fP\fITOKEN\fP Use TOKEN for initial access control to the merchant backend. The value given in TOKEN must appear in backoffice requests to the default instance -of the merchant, i.e. "Authorization: Bearer secret\-token:TOKEN" to obtain +of the merchant, i.e. “Authorization: Bearer secret\-token:TOKEN” to obtain access to the merchant backend. Note that setting a passphrase for the default instance by any means will block future access via TOKEN. This is basically a way to reset the passphrase protecting access. TOKEN -should be a "pchar" as per RFC 8959, but this is NOT checked. Note that -TOKEN will only grant access to the \(aqdefault\(aq instance, not other instances. +should be a “pchar” as per RFC 8959, but this is NOT checked. Note that +TOKEN will only grant access to the ‘default’ instance, not other instances. Instead of using the command\-line, which exposes TOKEN to users on the system, you may want to consider setting the TALER_MERCHANT_TOKEN environment variable instead. .TP -\fB\-C\fP | \fB\-\-connection\-close\fP +\fB\-C\fP | \fB–connection\-close\fP Force each HTTP connection to be closed after each request (useful in combination with \-f to avoid having to wait for nc to time out). .TP -\fB\-c\fP \fIFILENAME\fP | \fB\-\-config=\fP\fIFILENAME\fP +\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP\fIFILENAME\fP Use the configuration and other resources for the merchant to operate from FILENAME. .TP -\fB\-h\fP | \fB\-\-help\fP +\fB\-h\fP | \fB–help\fP Print short help on options. .TP -\fB\-L\fP \fILOGLEVEL\fP | \fB\-\-loglevel=\fP\fILOGLEVEL\fP +\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP\fILOGLEVEL\fP Specifies the log level to use. Accepted values are: \fBDEBUG\fP, \fBINFO\fP, \fBWARNING\fP, \fBERROR\fP\&. .TP -\fB\-l\fP \fIFILENAME\fP | \fB\-\-logfile=\fP\fIFILENAME\fP +\fB\-l\fP \fIFILENAME\fP | \fB–logfile=\fP\fIFILENAME\fP Send logging output to \fIFILENAME\fP\&. .TP -\fB\-T\fP \fIUSEC\fP | \fB\-\-timetravel=\fP\fIUSEC\fP +\fB\-T\fP \fIUSEC\fP | \fB–timetravel=\fP\fIUSEC\fP Modify the system time by \fIUSEC\fP microseconds. \fIUSEC\fP may be prefixed with \fB+\fP or \fB\-\fP (e.g. \fB\-T +300\fP). This option is intended for debugging/testing only. .TP -\fB\-v\fP | \fB\-\-version\fP +\fB\-v\fP | \fB–version\fP Print version information. .UNINDENT .SH SIGNALS @@ -99,7 +99,7 @@ cleanly. .INDENT 0.0 .TP .B TALER_MERCHANT_TOKEN -Like the "\-a" option, resets the access token for the default +Like the “\-a” option, resets the access token for the default instance to the given value. .UNINDENT .SH SEE ALSO diff --git a/man/taler-merchant-setup-reserve.1 b/man/taler-merchant-setup-reserve.1 index 0624e567..f80b117c 100644 --- a/man/taler-merchant-setup-reserve.1 +++ b/man/taler-merchant-setup-reserve.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER-MERCHANT-SETUP-RESERVE" "1" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER-MERCHANT-SETUP-RESERVE" "1" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler-merchant-setup-reserve \- setup reserve for tipping at a Taler merchant backend . @@ -33,20 +33,20 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .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 “:” 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.conf.5 b/man/taler.conf.5 index 7fa821a2..f26239ba 100644 --- a/man/taler.conf.5 +++ b/man/taler.conf.5 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER.CONF" "5" "Jun 20, 2022" "0.9" "GNU Taler" +.TH "TALER.CONF" "5" "Jul 06, 2022" "0.9" "GNU Taler" .SH NAME taler.conf \- Taler configuration file . @@ -126,7 +126,7 @@ Port on which the HTTP server listens, e.g.\ 8080. .TP .B MASTER_PUBLIC_KEY Crockford Base32\-encoded master public key, public version of the -exchange\(aqs long\-time offline signing key. +exchange’s long\-time offline signing key. .TP .B MASTER_PRIV_FILE Location of the master private key on disk. Only used by tools that @@ -154,7 +154,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 “taler\-exchange\-dbinit \-s” before resuming. Default is 2147483648 (no sharding). .TP .B SIGNKEY_LEGAL_DURATION For how long are signatures with signing keys legally valid? @@ -168,12 +168,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. “en/” or “fr/”. Each subdirectory must then contain files with the terms of service in various formats. The basename of the file of the current policy must be specified under \fBTERMS_ETAG\fP\&. The extension defines the mime type. -Supported extensions include "html", "htm", "txt", "pdf", "jpg", "jpeg", -"png" and "gif". For example, using a \fBTERMS_ETAG\fP of "0", the structure +Supported extensions include “html”, “htm”, “txt”, “pdf”, “jpg”, “jpeg”, +“png” and “gif”. For example, using a \fBTERMS_ETAG\fP of “0”, the structure could be the following: .INDENT 7.0 .IP \(bu 2 @@ -192,7 +192,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 “Etag” in the HTTP request to control caching. Whenever the terms of service change, the \fBTERMS_ETAG\fP MUST also change, and old values MUST NOT be repeated. For example, the date or version number of the terms of service SHOULD be used for the Etag. If @@ -207,18 +207,18 @@ Works the same as \fBTERMS_DIR\fP, just for the privacy policy. Works the same as \fBTERMS_ETAG\fP, just for the privacy policy. .TP .B KYC_MODE -Set to "NONE" to disable KYC for this exchange (but check with your lawyer first). -Set to "OAUTH2" to use OAuth2 for KYC. +Set to “NONE” to disable KYC for this exchange (but check with your lawyer first). +Set to “OAUTH2” to use OAuth2 for KYC. .TP .B KYC_WITHDRAW_LIMIT Maximum amount that can be withdrawn in KYC_WITHDRAW_PERIOD without needing KYC. -Only used if KYC_MODE is not "NONE". +Only used if KYC_MODE is not “NONE”. .TP .B KYC_WITHDRAW_PERIOD The time period over which transactions are considered for the KYC_WITHDRAW_LIMIT. -Only used if KYC_MODE is not "NONE". +Only used if KYC_MODE is not “NONE”. .TP .B KYC_WALLET_BALANCE_LIMIT Maximum amount that a wallet is allowed to hold without @@ -228,30 +228,30 @@ is no limit. .UNINDENT .SS EXCHANGE KYC OAUTH2 OPTIONS .sp -The following options must be in the section "[exchange\-kyc\-oauth2]". +The following options must be in the section “[exchange\-kyc\-oauth2]”. .INDENT 0.0 .TP .B KYC_OAUTH2_AUTH_URL -URL of the OAuth2 endpoint to be used for KYC checks. Requires KYC_ENABLED to be "OAUTH2". Example: "\fI\%http://localhost:8888/oauth/v2/login\fP" (or "/token") +URL of the OAuth2 endpoint to be used for KYC checks. Requires KYC_ENABLED to be “OAUTH2”. Example: “\fI\%http://localhost:8888/oauth/v2/login\fP” (or “/token”) .TP .B KYC_OAUTH2_LOGIN_URL -URL of the OAuth2 endpoint to be used for KYC checks. Requires KYC_ENABLED to be "OAUTH2". Example: "\fI\%http://localhost:8888/oauth/v2/login\fP" +URL of the OAuth2 endpoint to be used for KYC checks. Requires KYC_ENABLED to be “OAUTH2”. Example: “\fI\%http://localhost:8888/oauth/v2/login\fP” .TP .B KYC_INFO_URL -URL of the endpoint where the OAuth 2.0 token can be used to download the user\(aqs details. Requires KYC_ENABLED to be "OAUTH2". Example: "\fI\%http://localhost:8888/api/user/me\fP" +URL of the endpoint where the OAuth 2.0 token can be used to download the user’s details. Requires KYC_ENABLED to be “OAUTH2”. Example: “\fI\%http://localhost:8888/api/user/me\fP” .TP .B KYC_OAUTH2_CLIENT_ID -Client ID of the exchange when it talks to the KYC OAuth2 endpoint. Requires KYC_ENABLED to be "OAUTH2". +Client ID of the exchange when it talks to the KYC OAuth2 endpoint. Requires KYC_ENABLED to be “OAUTH2”. .TP .B KYC_OAUTH2_CLIENT_SECRET -Client secret of the exchange to use when talking to the KYC Oauth2 endpoint. Requires KYC_ENABLED to be "OAUTH2". +Client secret of the exchange to use when talking to the KYC Oauth2 endpoint. Requires KYC_ENABLED to be “OAUTH2”. .TP .B KYC_OAUTH2_POST_URL -URL to which the exchange will redirect the client\(aqs browser after successful authorization/login for the KYC process. +URL to which the exchange will redirect the client’s browser after successful authorization/login for the KYC process. .UNINDENT .SS EXCHANGE OFFLINE SIGNING OPTIONS .sp -The following options must be in the section "[exchange\-offline]". +The following options must be in the section “[exchange\-offline]”. .INDENT 0.0 .TP .B MASTER_PRIV_FILE @@ -277,7 +277,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 “[taler\-exchange\-secmod\-rsa]”. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -304,7 +304,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 “[taler\-exchange\-secmod\-cs]”. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -331,7 +331,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 “[taler\-exchange\-secmod\-eddsa]”. .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -358,7 +358,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 “[exchangedb]”. .INDENT 0.0 .TP .B IDLE_RESERVE_EXPIRATION_TIME @@ -415,7 +415,7 @@ URL of the wire gateway. Typically of the form \fBhttps://$HOSTNAME[:$PORT]/taler\-wire\-gateway/$USERNAME/\fP where $HOSTNAME is the hostname of the system running the bank (such as the Taler Python bank or the Nexus) and \fB$USERNAME\fP is -the username of the exchange\(aqs bank account (usually matching +the username of the exchange’s bank account (usually matching the \fBUSERNAME\fP option used for authentication). Example: \fBhttps://bank.demo.taler.net/taler\-wire\-gateway/Exchange/\fP\&. .TP @@ -470,12 +470,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 “CS” or “RSA”. The respective crypto\-helper will then generate the keys for this denomination. .TP .B RSA_KEYSIZE -What is the RSA keysize modulos (in bits)? Only used if "CIPHER=RSA". +What is the RSA keysize modulos (in bits)? Only used if “CIPHER=RSA”. .UNINDENT .SS MERCHANT OPTIONS .sp @@ -522,7 +522,7 @@ Base URL of the exchange, e.g.\ “\fI\%https://exchange.demo.taler.net/\fP” .TP .B MASTER_KEY Crockford Base32 encoded master public key, public version of the -exchange\(aqs long\-time offline signing key. Can be omitted, in that +exchange’s long\-time offline signing key. Can be omitted, in that case the exchange will NOT be trusted unless it is audited by a known auditor. Omitting \fBMASTER_KEY\fP can be useful if we do not trust the exchange @@ -581,12 +581,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.\ “postgres:///taler” to use the +“taler” 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 “[bank]” for the taler\-fakebank\-run(1) command. They are not used by the exchange or LibEuFin! .INDENT 0.0 .TP .B HTTP_PORT |