diff options
Diffstat (limited to 'doc/taler-exchange-httpd.1')
| -rw-r--r-- | doc/taler-exchange-httpd.1 | 92 |
1 files changed, 0 insertions, 92 deletions
diff --git a/doc/taler-exchange-httpd.1 b/doc/taler-exchange-httpd.1 deleted file mode 100644 index 9cb178abf..000000000 --- a/doc/taler-exchange-httpd.1 +++ /dev/null @@ -1,92 +0,0 @@ -.Dd April 22, 2015 -.Dt TALER-EXCHANGE-HTTPD 1 -.Os -.Sh NAME -.Nm taler-exchange-httpd -.Nd Run Taler exchange (with RESTful API) -.Sh SYNOPSIS -.Nm -.Op Fl C | -connection-close -.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME -.Op Fl f Ar FILENAME | Fl -file-input= Ns Ar FILENAME -.Op Fl h | -help -.Op Fl i | -init-db -.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL -.Op Fl t Ar SECONDS | Fl -timeout= Ns Ar SECONDS -.Op Fl v | -version -.Sh DESCRIPTION -.Nm -is a command line tool to run the Taler exchange (HTTP server). -The required configuration, keys and database must exist before -running this command. -.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. -.It Fl i | -init-db -Initialize the database by creating tables and indices if necessary. -.It Fl v | -version -Print version information. -.It Fl f Ar FILENAME | Fl -file-input= Ns Ar FILENAME -This option is only available if the exchange was compiled with the -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 -.Bl -enum -offset indent -compact -.It -terminate after the first client's HTTP connection is completed, and -.It -automatically start such a client using a helper process based on the -.Xr nc 1 -or -.Xr ncat 1 -binary using FILENAME as the standard input to the helper process. -.El -As a result, the process will effectively run with -.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. -.It Dv SIGHUP -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. -.El -.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 . |