aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorflorian2014-01-20 13:00:31 +0000
committerWynn Wolf Arbor2020-05-24 12:33:55 +0200
commitecf9d02f8ee54a5ae0f36af0e6750f848bc06285 (patch)
tree5bf7ee18aefe19dd916fa26d501573c9742cfefb
parentb9bb934f63cf27a8620bd519914253fa13d93772 (diff)
downloadslowcgi-ecf9d02f8ee54a5ae0f36af0e6750f848bc06285.tar.gz
Better explanation what slowcgi(8) is for. Room for improvements pointed out by deraadt@ Tweaks/OK jmc@ OK deraadt@
Diffstat (limited to '')
-rw-r--r--slowcgi.827
1 files changed, 25 insertions, 2 deletions
diff --git a/slowcgi.8 b/slowcgi.8
index be11765..7307c7a 100644
--- a/slowcgi.8
+++ b/slowcgi.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: slowcgi.8,v 1.6 2014/01/19 12:47:21 deraadt Exp $
+.\" $OpenBSD: slowcgi.8,v 1.7 2014/01/20 13:00:31 florian Exp $
.\"
.\" Copyright (c) 2013 Florian Obser <florian@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 19 2014 $
+.Dd $Mdocdate: January 20 2014 $
.Dt SLOWCGI 8
.Os
.Sh NAME
@@ -27,6 +27,24 @@
.Sh DESCRIPTION
.Nm
is a server which implements the FastCGI Protocol to execute CGI scripts.
+FastCGI was designed to overcome the CGI protocol's scalability
+and resource sharing limitations.
+While CGI scripts need to be forked for every request, FastCGI scripts
+can be kept running and handle many HTTP requests.
+.Pp
+.Xr nginx 8
+intentionally does not implement the CGI protocol.
+.Nm
+is a simple server that translates FastCGI requests coming from
+.Xr nginx 8
+to the CGI protocol.
+It executes the requested CGI script and translates its output back to the
+FastCGI protocol.
+.Pp
+Modern web frameworks and web applications usually come with the
+capability to run as FastCGI servers.
+.Nm
+is not intended for these applications.
.Pp
.Nm
opens a socket at
@@ -65,3 +83,8 @@ Create and bind to alternative local socket at
.%R RFC 3875
.%T The Common Gateway Interface (CGI) Version 1.1
.Re
+.Sh BUGS
+.Nm
+only implements the parts of the FastCGI standard needed to execute
+CGI scripts.
+This is intentional.