From 128dd21665396575f1e752d2fbc77ca5719972da Mon Sep 17 00:00:00 2001
From: Florian Dold <florian.dold@gmail.com>
Date: Wed, 18 Sep 2019 19:23:51 +0200
Subject: prebuilt: man

---
 man/taler-exchange-httpd.1 | 127 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 127 insertions(+)
 create mode 100644 man/taler-exchange-httpd.1

(limited to 'man/taler-exchange-httpd.1')

diff --git a/man/taler-exchange-httpd.1 b/man/taler-exchange-httpd.1
new file mode 100644
index 00000000..13dd886a
--- /dev/null
+++ b/man/taler-exchange-httpd.1
@@ -0,0 +1,127 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-HTTPD" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-httpd \- run Taler exchange (with RESTful API)
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-httpd\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\-i\fP\ |\ \fB–init\-db\fP]
+[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP‌\fILOGLEVEL\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
+exchange (HTTP server). The required configuration, keys and database
+must exist before running this command.
+.sp
+Its options are as follows:
+.INDENT 0.0
+.TP
+\fB\-C\fP | \fB–connection\-close\fP
+Force each HTTP connection to be closed after each request (useful in
+combination with \fB\-f\fP to avoid having to wait for nc to time out).
+.TP
+\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP‌\fIFILENAME\fP
+Use the configuration and other resources for the merchant to operate
+from FILENAME.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-i\fP | \fB–init\-db\fP
+Initialize the database by creating tables and indices if necessary.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.TP
+\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
+test cases against the exchange using AFL. When this option is
+present, the HTTP server will
+.INDENT 7.0
+.IP 1. 3
+terminate after the first client’s HTTP connection is completed,
+and
+.IP 2. 3
+automatically start such a client using a helper process based on
+the nc(1) or ncat(1) binary using FILENAME as the standard input
+to the helper process.
+.UNINDENT
+.sp
+As a result, the process will effectively run with \fIFILENAME\fP 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.
+.TP
+\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\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP‌\fILOGLEVEL\fP
+Specifies the log level to use. Accepted values are: DEBUG, INFO,
+WARNING, ERROR.
+.UNINDENT
+.SH SIGNALS
+.sp
+\fBtaler\-exchange\-httpd\fP responds to the following signals:
+.INDENT 0.0
+.TP
+.B \fBSIGUSR1\fP
+Sending a SIGUSR1 to the process will cause it to reload denomination
+and signing keys.
+.TP
+.B \fBSIGTERM\fP
+Sending a SIGTERM to the process will cause it to shutdown cleanly.
+.TP
+.B \fBSIGHUP\fP
+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.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-dbinit(1), taler\-exchange\-keyup(1),
+taler\-exchange\-reservemod(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
-- 
cgit v1.2.3