Commit | Line | Data |
---|---|---|
1f3d7aa3 | 1 | scgi-wsgi3(1) |
173e0e9e FT |
2 | ============ |
3 | ||
4 | NAME | |
5 | ---- | |
1f3d7aa3 | 6 | scgi-wsgi3 - WSGI adapter for SCGI |
173e0e9e FT |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
1f3d7aa3 | 10 | *scgi-wsgi3* [*-hA*] [*-p* 'MODPATH'] [*-T* \[HOST:]'PORT'] 'HANDLER-MODULE' ['ARGS'...] |
173e0e9e FT |
11 | |
12 | DESCRIPTION | |
13 | ----------- | |
14 | ||
1f3d7aa3 FT |
15 | The *scgi-wsgi3* program translates SCGI requests to WSGI requests, |
16 | and passes them to a specified Python module. It is mainly written to | |
173e0e9e FT |
17 | emulate the behavior of *ashd-wsgi*(1), but over SCGI instead of the |
18 | native *ashd*(7) protocol, so please see its documentation for details | |
19 | of Python interoperation. Unlike *ashd-wsgi* which requires CPython, | |
1f3d7aa3 FT |
20 | however, *scgi-wsgi3* is written in pure Python using only the |
21 | standard library, and so should be usable by any Python | |
22 | implementation. If using it under *ashd*(7), please see the | |
23 | documentation for *callscgi*(1) as well. | |
173e0e9e | 24 | |
1f3d7aa3 | 25 | Following *callscgi*(1) conventions, *scgi-wsgi3* will, by default, |
173e0e9e FT |
26 | accept connections on a socket passed on its standard input (a |
27 | behavior which is, obviously, not available on all Python | |
28 | implementations). Use the *-T* option to listen to a TCP address | |
29 | instead. | |
30 | ||
31 | OPTIONS | |
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 | ||
56 | AUTHOR | |
57 | ------ | |
58 | Fredrik Tolf <fredrik@dolda2000.com> | |
59 | ||
60 | SEE ALSO | |
61 | -------- | |
1f3d7aa3 | 62 | *ashd-wsgi3*(1), *callscgi*(1), <http://wsgi.org/>, |
173e0e9e | 63 | <http://www.python.ca/scgi/> |