Dolda2000 GitWeb / ashd.git / blame
| 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/> |