dirplex: Correct config resolution for base directory.
[ashd.git] / python3 / doc / scgi-wsgi3.doc
CommitLineData
1f3d7aa3 1scgi-wsgi3(1)
173e0e9e
FT
2============
3
4NAME
5----
1f3d7aa3 6scgi-wsgi3 - WSGI adapter for SCGI
173e0e9e
FT
7
8SYNOPSIS
9--------
1f3d7aa3 10*scgi-wsgi3* [*-hA*] [*-p* 'MODPATH'] [*-T* \[HOST:]'PORT'] 'HANDLER-MODULE' ['ARGS'...]
173e0e9e
FT
11
12DESCRIPTION
13-----------
14
1f3d7aa3
FT
15The *scgi-wsgi3* program translates SCGI requests to WSGI requests,
16and passes them to a specified Python module. It is mainly written to
173e0e9e
FT
17emulate the behavior of *ashd-wsgi*(1), but over SCGI instead of the
18native *ashd*(7) protocol, so please see its documentation for details
19of Python interoperation. Unlike *ashd-wsgi* which requires CPython,
1f3d7aa3
FT
20however, *scgi-wsgi3* is written in pure Python using only the
21standard library, and so should be usable by any Python
22implementation. If using it under *ashd*(7), please see the
23documentation for *callscgi*(1) as well.
173e0e9e 24
1f3d7aa3 25Following *callscgi*(1) conventions, *scgi-wsgi3* will, by default,
173e0e9e
FT
26accept connections on a socket passed on its standard input (a
27behavior which is, obviously, not available on all Python
28implementations). Use the *-T* option to listen to a TCP address
29instead.
30
31OPTIONS
32-------
33
34*-h*::
35
36 Print a brief help message to standard output and exit.
37
38*-A*::
39
40 Use the convention used by Apache's mod_wsgi module to find
41 the WSGI application object. See the PROTOCOL section of
42 *ashd-wsgi*(1) for details.
43
44*-p* 'MODPATH'::
45
46 Prepend 'MODPATH' to Python's `sys.path`; can be given multiple
47 times.
48
49*-T* \[HOST:]'PORT'::
50
51 Instead of using a listening socket passed on standard input
52 to accept SCGI connections, bind a TCP socket to the 'HOST'
53 address listening for connections on 'PORT' instead. If 'HOST'
54 is not given, `localhost` is used by default.
55
56AUTHOR
57------
58Fredrik Tolf <fredrik@dolda2000.com>
59
60SEE ALSO
61--------
1f3d7aa3 62*ashd-wsgi3*(1), *callscgi*(1), <http://wsgi.org/>,
173e0e9e 63<http://www.python.ca/scgi/>