.

htpipe.1

@@ -0,0 +1,23 @@
+.TH htpipe 1
+.SH NAME
+htpipe \- pipe HTTP header fields
+.SH SYNOPSIS
+htpipe PROG ARGS
+.SH DESCRIPTION
+htpipe is meant to run under a superserver such
+as tcpserver(1) or inetd(8).
+It reads an HTTP request from stdin and pipes the content
+of the first HTTP multipart/form-data field to PROG.
+Specifically it exec's into PROG where the first
+argument is set to PROG and the remaining to ARGS.
+.PP
+If the HTTP request specifies no multipart/form-data field,
+htpipe responds with "400 Bad Request" and exits with 100.
+.PP
+On any other internal error, it responds with "500 Internal
+Server Error" and exits with 111.
+.SH "EXAMPLE"
+An echo HTTP service:
+  tcpserver 0 80 htpipe nobotgate-access -n cat
+.SH "SEE ALSO"
+nobotgate-access(1), tcpserver(1), inetd(8)