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 | -------- | |
0690bcf6 | 10 | *scgi-wsgi3* [*-hAL*] [*-m* 'PDM-SPEC'] [*-p* 'MODPATH'] [*-t* 'HANDLING-MODEL'] [*-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 | ||
0690bcf6 FT |
44 | *-L*:: |
45 | By default, *scgi-wsgi3* sets up the Python logging with a | |
46 | logging format and for logging to standard error. The *-L* | |
47 | option suppresses that behavior, so that any handler module | |
48 | may set up logging itself. | |
49 | ||
173e0e9e FT |
50 | *-p* 'MODPATH':: |
51 | ||
52 | Prepend 'MODPATH' to Python's `sys.path`; can be given multiple | |
53 | times. | |
54 | ||
0690bcf6 FT |
55 | *-t* 'HANDLING-MODEL':: |
56 | ||
57 | Specify the way *scgi-wsgi3* handles requests. See the REQUEST | |
58 | HANDLING section of *ashd-wsgi3*(1) for details. | |
59 | ||
173e0e9e FT |
60 | *-T* \[HOST:]'PORT':: |
61 | ||
62 | Instead of using a listening socket passed on standard input | |
63 | to accept SCGI connections, bind a TCP socket to the 'HOST' | |
64 | address listening for connections on 'PORT' instead. If 'HOST' | |
65 | is not given, `localhost` is used by default. | |
66 | ||
62705f8e FT |
67 | *-m* 'PDM-SPEC':: |
68 | ||
69 | If the PDM library is installed on the system, create a | |
983f5a41 | 70 | listening socket for connecting PDM clients according to |
62705f8e FT |
71 | 'PDM-SPEC'. |
72 | ||
173e0e9e FT |
73 | AUTHOR |
74 | ------ | |
75 | Fredrik Tolf <fredrik@dolda2000.com> | |
76 | ||
77 | SEE ALSO | |
78 | -------- | |
1f3d7aa3 | 79 | *ashd-wsgi3*(1), *callscgi*(1), <http://wsgi.org/>, |
173e0e9e | 80 | <http://www.python.ca/scgi/> |