Commit | Line | Data |
---|---|---|
338bee9d FT |
1 | scgi-wsgi(1) |
2 | ============ | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | scgi-wsgi - WSGI adapter for SCGI | |
7 | ||
8 | SYNOPSIS | |
9 | -------- | |
62705f8e | 10 | *scgi-wsgi* [*-hA*] [*-m* 'PDM-SPEC'] [*-p* 'MODPATH'] [*-T* \[HOST:]'PORT'] 'HANDLER-MODULE' ['ARGS'...] |
338bee9d FT |
11 | |
12 | DESCRIPTION | |
13 | ----------- | |
14 | ||
15 | The *scgi-wsgi* program translates SCGI requests to WSGI requests, and | |
16 | passes them to a specified Python module. It is mainly written to | |
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, | |
20 | however, *scgi-wsgi* is written in pure Python using only the standard | |
21 | library, and so should be usable by any Python implementation. If | |
22 | using it under *ashd*(7), please see the documentation for | |
23 | *callscgi*(1) as well. | |
24 | ||
25 | Following *callscgi*(1) conventions, *scgi-wsgi* will, by default, | |
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 | ||
62705f8e FT |
56 | *-m* 'PDM-SPEC':: |
57 | ||
58 | If the PDM library is installed on the system, create a | |
59 | listening socket for connection PDM clients according to | |
60 | 'PDM-SPEC'. | |
61 | ||
338bee9d FT |
62 | AUTHOR |
63 | ------ | |
64 | Fredrik Tolf <fredrik@dolda2000.com> | |
65 | ||
66 | SEE ALSO | |
67 | -------- | |
68 | *ashd-wsgi*(1), *callscgi*(1), <http://wsgi.org/>, | |
69 | <http://www.python.ca/scgi/> |