X-Git-Url: http://www.dolda2000.com/gitweb/?a=blobdiff_plain;f=doc%2Fhtparser.doc;h=928e642c9a241c87376820f98c81588dea4262e4;hb=518c678c21a99f4b148f3cb1f40afe8b51577082;hp=6e2c239078dc43c9f337aee567b60139422b0654;hpb=082441e412764602d6666cfe94d85aef00736888;p=ashd.git diff --git a/doc/htparser.doc b/doc/htparser.doc index 6e2c239..928e642 100644 --- a/doc/htparser.doc +++ b/doc/htparser.doc @@ -24,7 +24,8 @@ all the 'ARGS' as command-line arguments. Only after that will *htparser* do any daemonizing or chrooting as specified by options. The root handler must be a persistent program as specified in -*ashd*(7). If the handler program exits, *htparser* will exit too. +*ashd*(7). If the handler program exits, *htparser* will exit too, +following the procedure described below under SIGNALS. PORT SPECIFICATION ------------------ @@ -37,9 +38,9 @@ PORT SPECIFICATION Currently, the available 'HANDLERs' are *plain* and *ssl*, for handling plain TCP connections and SSL/TLS-protected connections, respectively. For details regarding the arguments that each handler -accept, simply run *htparser* with 'HANDLER'*:help*. For example, the -command "`htparser ssl:help`" will display help for the *ssl* handler to -standard output and then exit. +accepts, simply run *htparser* with 'HANDLER'*:help*. For example, the +command "`htparser ssl:help`" will display help for the *ssl* handler +to standard output and then exit. The port specifications must be followed by the `--` argument to distinguish them from the root handler specification. @@ -63,23 +64,34 @@ OPTIONS Daemonize after all specified ports have been successfully bound and the root handler has been started. -*-u*:: +*-u* 'USER':: Change UID to 'USER' once all specified ports have been successfully bound and the root handler has been started. 'USER' must be specified symbolically (i.e. not as a numeric UID). -*-r*:: +*-r* 'ROOT':: Change root directory to 'ROOT' once all specified ports have been successfully bound and the root handler has been started. -*-p*:: +*-p* 'PIDFILE':: After having daemonized, write the PID of the new process to 'PIDFILE'. +SIGNALS +------- + +SIGTERM, SIGINT:: + + Upon first reception, `htparser` closes all listening ports + and the socket to the root handler, but continues to serve all + currently ongoing requests until none remain, not keeping the + connections open for keep-alive. Upon second reception, + `htparser` shuts down completely. + EXAMPLES --------