[ashd.git] / python3 / doc / scgi-wsgi3.doc

scgi-wsgi3(1)
============

NAME
----
scgi-wsgi3 - WSGI adapter for SCGI

SYNOPSIS
--------
*scgi-wsgi3* [*-hA*] [*-m* 'PDM-SPEC'] [*-p* 'MODPATH'] [*-T* \[HOST:]'PORT'] 'HANDLER-MODULE' ['ARGS'...]

DESCRIPTION
-----------

The *scgi-wsgi3* program translates SCGI requests to WSGI requests,
and passes them to a specified Python module. It is mainly written to
emulate the behavior of *ashd-wsgi*(1), but over SCGI instead of the
native *ashd*(7) protocol, so please see its documentation for details
of Python interoperation. Unlike *ashd-wsgi* which requires CPython,
however, *scgi-wsgi3* is written in pure Python using only the
standard library, and so should be usable by any Python
implementation. If using it under *ashd*(7), please see the
documentation for *callscgi*(1) as well.

Following *callscgi*(1) conventions, *scgi-wsgi3* will, by default,
accept connections on a socket passed on its standard input (a
behavior which is, obviously, not available on all Python
implementations). Use the *-T* option to listen to a TCP address
instead.

OPTIONS
-------

*-h*::

	Print a brief help message to standard output and exit.

*-A*::

	Use the convention used by Apache's mod_wsgi module to find
	the WSGI application object. See the PROTOCOL section of
	*ashd-wsgi*(1) for details.

*-p* 'MODPATH'::

	Prepend 'MODPATH' to Python's `sys.path`; can be given multiple
	times.

*-T* \[HOST:]'PORT'::

	Instead of using a listening socket passed on standard input
	to accept SCGI connections, bind a TCP socket to the 'HOST'
	address listening for connections on 'PORT' instead. If 'HOST'
	is not given, `localhost` is used by default.

*-m* 'PDM-SPEC'::

	If the PDM library is installed on the system, create a
	listening socket for connecting PDM clients according to
	'PDM-SPEC'.

AUTHOR
------
Fredrik Tolf <fredrik@dolda2000.com>

SEE ALSO
--------
*ashd-wsgi3*(1), *callscgi*(1), <http://wsgi.org/>,
<http://www.python.ca/scgi/>
Commit	Line	Data
	1	scgi-wsgi3(1)
	2	============
	3
	4	NAME
	5	----
	6	scgi-wsgi3 - WSGI adapter for SCGI
	7
	8	SYNOPSIS
	9	--------
	10	scgi-wsgi3 [-hA] [-m 'PDM-SPEC'] [-p 'MODPATH'] [-T \[HOST:]'PORT'] 'HANDLER-MODULE' ['ARGS'...]
	11
	12	DESCRIPTION
	13	-----------
	14
	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
	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-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.
	24
	25	Following callscgi(1) conventions, scgi-wsgi3 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
	56	-m 'PDM-SPEC'::
	57
	58	If the PDM library is installed on the system, create a
	59	listening socket for connecting PDM clients according to
	60	'PDM-SPEC'.
	61
	62	AUTHOR
	63	------
	64	Fredrik Tolf <fredrik@dolda2000.com>
	65
	66	SEE ALSO
	67	--------
	68	ashd-wsgi3(1), callscgi(1), <http://wsgi.org/>,
	69	<http://www.python.ca/scgi/>