taler/exchange
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc fixes in format and typos.

Browse Source
This commit is contained in:
ng0 2019-05-10 10:56:49 +00:00
parent 39263a48d3
commit 3f9aafdc72
No known key found for this signature in database
GPG Key ID: E22F9BBFEE348588
6 changed files with 290 additions and 206 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

78
doc/taler-exchange-dbinit.1
View File

@ -1,35 +1,47 @@
.TH TALER\-EXCHANGE\-DBINIT 1 "May 31, 2016" "GNU Taler" .Dd May 31, 2016
.Dt TALER-EXCHANGE-DBINIT 1
.SH NAME .Os
taler\-exchange\-dbinit \- Initialize Taler exchange database. .Sh NAME
.Nm taler-exchange-dbinit
.SH SYNOPSIS .Nd Initialize Taler exchange database.
.B taler\-exchange\-dbinit .Sh SYNOPSIS
.RI [ options ] .Nm
.br .Op Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
.Op Fl h | -help
.SH DESCRIPTION .Op Fl g | -gc
\fBtaler\-exchange\-dbinit\fP is a command line tool to initialize the Taler exchange database. It creates the necessary tables and indices for the Taler exchange to operate. .Op Fl r | -reset
.Op Fl v | -version
.SH OPTIONS .Sh DESCRIPTION
.B .Nm
.IP "\-d DIRNAME, \-\-exchange-dir=DIRNAME" is a command line tool to initialize the Taler exchange database.
Use the configuration and other resources for the exchange to operate from DIRNAME. It creates the necessary tables and indices for the Taler exchange
.B to operate.
.IP "\-h, \-\-help" .Pp
Its options are as follows:
.Bl -tag -width indent
.It Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
Use the configuration and other resources for the exchange to
operate from
.Ar DIRNAME .
.It Fl h | -help
Print short help on options. Print short help on options.
.B .It Fl g | -gc
.IP "\-g, \-\-gc" Garbage collect database.
Garbage collect database. Deletes all unnecessary data in the database. Deletes all unnecessary data in the database.
.B .It Fl r | -reset
.IP "\-r, \-\-reset" Drop tables.
Drop tables. Dangerous, will delete all existing data in the database before creating the tables. Dangerous, will delete all existing data in the database before
.B creating the tables.
.IP "\-v, \-\-version" .It Fl v | -version
Print version information. Print version information.
.El
.SH BUGS .Sh SEE ALSO
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <taler@gnu.org> .Xr taler-exchange-httpd 1 ,
.Xr taler-exchange-keyup 1 ,
.SH "SEE ALSO" .Xr taler-exchange-reservemod 1 ,
\fBtaler\-exchange\-httpd\fP(1), \fBtaler\-exchange\-keyup\fP(1), \fBtaler\-exchange\-reservemod\fP(1), \fBtaler.conf\fP(5) .Xr taler.conf 5 .
.Sh BUGS
Report bugs by using
.Lk https://bugs.gnunet.org
or by sending electronic mail to
.Aq Mt taler@gnu.org .

140
doc/taler-exchange-httpd.1
View File

@ -1,56 +1,92 @@
.TH TALER\-EXCHANGE\-HTTPD 1 "Apr 22, 2015" "GNU Taler" .Dd April 22, 2015
.Dt TALER-EXCHANGE-HTTPD 1
.SH NAME .Os
taler\-exchange\-httpd \- Run Taler exchange (with RESTful API) .Sh NAME
.Nm taler-exchange-httpd
.SH SYNOPSIS .Nd Run Taler exchange (with RESTful API)
.B taler\-exchange\-httpd .Sh SYNOPSIS
.RI [ options ] .Nm
.br .Op Fl C | -connection-close
.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
.SH DESCRIPTION .Op Fl f Ar FILENAME | Fl -file-input= Ns Ar FILENAME
\fBtaler\-exchange\-httpd\fP is a command line tool to run the Taler exchange (HTTP server). The required configuration, keys and database must exist before running this command. .Op Fl h | -help
.Op Fl i | -init-db
.SH OPTIONS .Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
.B .Op Fl t Ar SECONDS | Fl -timeout= Ns Ar SECONDS
.IP "\-C, \-\-connection-close" .Op Fl v | -version
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). .Sh DESCRIPTION
.B .Nm
.IP "\-c FILENAME, \-\-config=FILENAME" is a command line tool to run the Taler exchange (HTTP server).
Use the configuration and other resources for the merchant to operate from FILENAME. The required configuration, keys and database must exist before
.B running this command.
.IP "\-h, \-\-help" .Pp
Its options are as follows:
.Bl -tag -width indent
.It Fl C | -connection-close
Force each HTTP connection to be closed after each request (useful
in combination with
.Fl f
to avoid having to wait for nc to time out).
.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
Use the configuration and other resources for the merchant to operate
from FILENAME.
.It Fl h | -help
Print short help on options. Print short help on options.
.B .It Fl i | -init-db
.IP "\-i, \-\-init-db"
Initialize the database by creating tables and indices if necessary. Initialize the database by creating tables and indices if necessary.
.B .It Fl v | -version
.IP "\-v, \-\-version"
Print version information. Print version information.
.B .It Fl f Ar FILENAME | Fl -file-input= Ns Ar FILENAME
.IP "\-f FILENAME, \-\-file\-input=FILENAME" This option is only available if the exchange was compiled with the
This option is only available if the exchange was compiled with the configure option configure option --enable-developer-mode.
\-\-enable\-developer\-mode. It is used for generating test cases against the exchange using AFL. When this option is present, the HTTP server will (1) terminate after the first client's HTTP connection is completed, and (2) automatically start such a client using a helper process based on the 'nc' or 'ncat' binary using FILENAME as the standard input to the helper process. As a result, the process will effectively run with FILENAME as the 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. It is used for generating test cases against the exchange using AFL.
.B When this option is present, the HTTP server will
.IP "\-t SECONDS, \-\-timeout=SECONDS" .Bl -enum -offset indent -compact
Specifies the number of SECONDS after which the HTTPD should close (idle) HTTP connections. .It
.B terminate after the first client's HTTP connection is completed, and
.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL" .It
Specifies the log level to use. Accepted values are: DEBUG, INFO, WARNING, ERROR. automatically start such a client using a helper process based on the
.Xr nc 1
.SH SIGNALS or
.B .Xr ncat 1
.IP SIGUSR1 binary using FILENAME as the standard input to the helper process.
Sending a SIGUSR1 to the process will cause it to reload denomination and signing keys. .El
.B As a result, the process will effectively run with
.IP SIGTERM .Ar FILENAME
as the 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.
.It Fl t Ar SECONDS | Fl -timeout= Ns Ar SECONDS
Specifies the number of SECONDS after which the HTTPD should
close (idle) HTTP connections.
.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
Specifies the log level to use.
Accepted values are: DEBUG, INFO, WARNING, ERROR.
.El
.Sh SIGNALS
.Nm
responds to the following signals:
.Bl -tag -width indent
.It Dv SIGUSR1
Sending a SIGUSR1 to the process will cause it to reload denomination
and signing keys.
.It Dv SIGTERM
Sending a SIGTERM to the process will cause it to shutdown cleanly. Sending a SIGTERM to the process will cause it to shutdown cleanly.
.B .It Dv SIGHUP
.IP SIGHUP Sending a SIGHUP to the process will cause it to re-execute the
Sending a SIGHUP to the process will cause it to re-execute the taler\-exchange\-httpd binary in the PATH, passing it the existing listen socket. Then the old server process will automatically exit after it is done handling existing client connections; the new server process will accept and handle new client connections. taler-exchange-httpd binary in the PATH, passing it the existing
listen socket.
.SH BUGS Then the old server process will automatically exit after it is done
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <taler@gnu.org> handling existing client connections; the new server process will
accept and handle new client connections.
.SH "SEE ALSO" .El
\fBtaler\-exchange\-dbinit\fP(1), \fBtaler\-exchange\-keyup\fP(1), \fBtaler\-exchange\-reservemod\fP(1), \fBtaler.conf\fP(5) .Sh SEE ALSO
.Xr taler-exchange-dbinit 1 ,
.Xr taler-exchange-keyup 1 ,
.Xr taler-exchange-reservemod 1 ,
.Xr taler.conf 5 .
.Sh BUGS
Report bugs by using
.Lk https://gnunet.org/bugs
or by sending electronic mail to
.Aq Mt taler@gnu.org .

64
doc/taler-exchange-keycheck.1
View File

@ -1,29 +1,39 @@
.TH TALER\-EXCHANGE\-KEYCHECK 1 "Apr 22, 2015" "GNU Taler" .Dd April 22, 2015
.Dt TALER-EXCHANGE-KEYCHECK 1
.SH NAME .Os
taler\-exchange\-keycheck \- Check validity of Taler signing and denomination keys. .Sh NAME
.Nm taler\-exchange\-keycheck
.SH SYNOPSIS .Nd check validity of Taler signing and denomination keys
.B taler\-exchange\-keycheck .Sh SYNOPSIS
.RI [ options ] .Nm
.br .Op Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
.Op Fl h | -help
.SH DESCRIPTION .Op Fl v | -version
\fBtaler\-exchange\-keycheck\fP can be used to check if the signing and denomination keys in the operation directory are well-formed. This can be useful after importing fresh keys from the offline system to ensure that the files are correct. .Sh DESCRIPTION
.Nm
.SH OPTIONS can be used to check if the signing and denomination keys in the
.B operation directory are well-formed.
.IP "\-d DIRNAME, \-\-exchange-dir=DIRNAME" This can be useful after importing fresh keys from the
Use the configuration and other resources for the exchange to operate from DIRNAME. offline system to ensure that the files are correct.
.B .Pp
.IP "\-h, \-\-help" Its options are as follows:
.Bl -tag -width indent
.It Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
Use the configuration and other resources for the exchange
to operate from
.Ar DIRNAME .
.It Fl h | -help
Print short help on options. Print short help on options.
.B .It Fl v | -version
.IP "\-v, \-\-version"
Print version information. Print version information.
.El
.SH BUGS .Sh SEE ALSO
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <taler@gnu.org> .Xr taler-exchange-httpd 1 ,
.Xr taler-exchange-keyup 1 ,
.SH "SEE ALSO" .Xr taler-exchange-dbinit 1 ,
\fBtaler\-exchange\-httpd\fP(1), \fBtaler\-exchange\-keyup\fP(1), \fBtaler\-exchange\-dbinit\fP(1), \fBtaler.conf\fP(5) .Xr taler.conf 5 .
.Sh BUGS
Report bugs by using
.Lk https://gnunet.org/bugs/
or by sending electronic mail to
.Aq Mt taler@gnu.org .

88
doc/taler-exchange-keyup.1
View File

@ -1,41 +1,55 @@
.TH TALER\-EXCHANGE\-KEYUP 1 "Apr 7, 2017" "GNU Taler" .Dd April 7, 2017
.Dt TALER\-EXCHANGE\-KEYUP 1
.SH NAME .Os
taler\-exchange\-keyup \- Setup Taler exchange denomination and signing keys. .Sh NAME
.Nm taler\-exchange\-keyup
.SH SYNOPSIS .Nd setup Taler exchange denomination and signing keys
.B taler\-exchange\-keyup .Sh SYNOPSIS
.RI [ options ] .Nm
.br .Op Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
.Op Fl h | -help
.SH DESCRIPTION .Op Fl m Ar FILE | Fl -master-key= Ns Ar FILE
\fBtaler\-exchange\-keyup\fP is a command line tool to setup Taler denomination and signing keys. This tool requires access to the exchange's long-term offline signing key and should be run in a secure (offline) environment under strict controls. The resulting keys can then be copied to the main online directory where the Taler HTTP server operates. .Op Fl o Ar FILE | Fl -output= Ns Ar FILE
.Op Fl r Ar DKH | Fl -revoke= Ns Ar DKH
.SH OPTIONS .Op Fl t Ar TIMESTAMP | Fl -time= Ns Ar TIMESTAMP
.B .Op Fl v | -version
.IP "\-d DIRNAME, \-\-exchange-dir=DIRNAME" .Sh DESCRIPTION
Use the configuration and other resources for the exchange to operate from DIRNAME. .Nm
.B is a command line tool to setup Taler denomination and signing keys.
.IP "\-h, \-\-help" This tool requires access to the exchange's long-term offline signing
key and should be run in a secure (offline) environment under strict
controls.
The resulting keys can then be copied to the main online directory
where the Taler HTTP server operates.
.Pp
Its options are as follows:
.Bl -tag -width indent
.It Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
Use the configuration and other resources for the exchange to
operate from
.Ar DIRNAME .
.It Fl h | -help
Print short help on options. Print short help on options.
.B .It Fl m Ar FILE | Fl -master-key= Ns Ar FILE
.IP "\-m FILE, \-\-master-key=FILE"
Location of the private EdDSA offline master key of the exchange. Location of the private EdDSA offline master key of the exchange.
.B .It Fl o Ar FILE | Fl -output= Ns Ar FILE
.IP "\-o FILE, \-\-ouptut=FILE" Where to write a denomination key signing request file to be given
Where to write a denomination key signing request file to be given to the auditor. to the auditor.
.B .It Fl r Ar DKH | Fl -revoke= Ns Ar DKH
.IP "\-r DKH, \-\-revoke=DKH"
Revoke the denomination key where the denomination public key's hash is DKH. Revoke the denomination key where the denomination public key's hash is DKH.
.B .It Fl t Ar TIMESTAMP | Fl -time= Ns Ar TIMESTAMP
.IP "\-t TIMESTAMP, \-\-time=TIMESTAMP" Operate as if the current time was
Operate as if the current time was TIMESTAMP. .Ar TIMESTAMP .
.B .It Fl v | -version
.IP "\-v, \-\-version"
Print version information. Print version information.
.El
.SH BUGS .Sh SEE ALSO
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <taler@gnu.org> .Xr taler-exchange-httpd 1 ,
.Xr taler-exchange-keyup 1 ,
.SH "SEE ALSO" .Xr taler-exchange-keycheck 1 ,
\fBtaler\-exchange\-httpd\fP(1), \fBtaler\-exchange\-keyup\fP(1), \fBtaler\-exchange\-keycheck\fP(1), \fBtaler.conf\fP(5) .Xr taler.conf 5 .
.Sh BUGS
Report bugs by using
.Lk https://gnunet.org/bugs/
or by sending electronic mail to
.Aq Mt taler@gnu.org .

58
doc/taler-exchange-wire.1
View File

@ -1,28 +1,34 @@
.TH TALER\-EXCHANGE\-WIRE 1 "Mar 18, 2018" "GNU Taler" .Dd March 18, 2018
.Dt TALER-EXCHANGE-WIRE 1
.SH NAME .Os
taler\-exchange\-wire \- Create the master-key signed responses to /wire. .Sh NAME
.Nm taler-exchange-wire
.SH SYNOPSIS .Nd create the master-key signed responses to /wire
.B taler\-exchange\-wire .Sh SYNOPSIS
.RI [ options ] .Nm
.br .Op Fl h | -help
.Op Fl m Ar MASTERKEYFILE | Fl -master= Ns Ar MASTERKEYFILE
.SH DESCRIPTION .Op Fl v | -version
\fBtaler\-exchange\-wire\fP is used to create the exchange's reply to a /wire request. It converts the bank details into the appropriate signed response. This needs to be done using the long-term offline master key. .Sh DESCRIPTION
.Nm
.SH OPTIONS is used to create the exchange's reply to a /wire request.
.B It converts the bank details into the appropriate signed response.
.IP "\-m MASTERKEYFILE, \-\-master=MASTERKEYFILE" This needs to be done using the long-term offline master key.
Specifies the name of the file containing the exchange's master key. .Pp
.IP "\-h, \-\-help" Its options are as follows:
.Bl -tag -width indent
.It Fl h | -help
Print short help on options. Print short help on options.
.B .It Fl m Ar MASTERKEYFILE | Fl -master= Ns Ar MASTERKEYFILE
.IP "\-v, \-\-version" Specifies the name of the file containing the exchange's master key.
.It Fl v | -version
Print version information. Print version information.
.El
.SH BUGS .Sh SEE ALSO
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <taler@gnu.org> .Xr taler-exchange-httpd 1 ,
.Xr taler.conf 5 .
.SH "SEE ALSO" .Sh BUGS
\fBtaler\-exchange\-httpd\fP(1), \fBtaler.conf\fP(5) Report bugs by using
.Lk https://gnunet.org/bugs/
or by sending electronic mail to
.Aq Mt taler@gnu.org .

68
doc/taler-exchange-wirewatch.1
View File

@ -1,35 +1,41 @@
.TH TALER\-EXCHANGE\-WIREWATCH 1 "May 5, 2017" "GNU Taler" .Dd May 5, 2017
.Dt TALER-EXCHANGE-WIREWATCH 1
.SH NAME .Os
taler\-exchange\-wirewatch \- Watch for incoming wire transfers .Sh NAME
.Nm taler-exchange-wirewatch
.SH SYNOPSIS .Nd watch for incoming wire transfers
.B taler\-exchange\-wirewatch .Sh SYNOPSIS
.RI [ options ] .Nm
.br .Op Fl t Ar PLUGINNAME | Fl -type= Ns Ar PLUGINNAME
.Op Fl h | -help
.SH DESCRIPTION .Op Fl T | -test
\fBtaler\-exchange\-wirewatch\fP is a command line tool to import wire transactions into the Taler exchange database. .Op Fl r | -reset
.Op Fl v | -version
.SH OPTIONS .Sh DESCRIPTION
.B .Nm
.IP "\-t PLUGINNAME, \-\-type=PLUGINNAME" is a command line tool to import wire transactions into the
Taler exchange database.
.Pp
Its options are as follows:
.Bl -tag -width indent
.It Fl t Ar PLUGINNAME | Fl -type= Ns Ar PLUGINNAME
Use the specified wire plugin and its configuration to talk to the bank. Use the specified wire plugin and its configuration to talk to the bank.
.B .It Fl h | -help
.IP "\-h, \-\-help"
Print short help on options. Print short help on options.
.B .It Fl T | -test
.IP "\-T, \-\-test"
Run in test mode and exit when idle. Run in test mode and exit when idle.
.B .It Fl r | -reset
.IP "\-r, \-\-reset" Ignore our own database and start with transactions
Ignore our own database and start with transactions from the beginning of time. from the beginning of time.
.B .It Fl v | -version
.IP "\-v, \-\-version"
Print version information. Print version information.
.B .El
.SH BUGS .Sh SEE ALSO
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <taler@gnu.org> .Xr taler-exchange-aggregator 1 ,
.Xr taler-exchange-httpd 1 ,
.SH "SEE ALSO" .Xr taler.conf 5 .
\fBtaler\-exchange\-aggregator\fP(1), \fBtaler\-exchange\-httpd\fP(1), \fBtaler.conf\fP(5) .Sh BUGS
Report bugs by using
.Lk https://gnunet.org/bugs/
or by sending electronic mail to
.Aq Mt taler@gnu.org .