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

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

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

SYNOPSIS
--------
*scgi-wsgi3* [*-hAL*] [*-m* 'PDM-SPEC'] [*-p* 'MODPATH'] [*-t* 'HANDLING-MODEL'] [*-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.

*-L*::
	By default, *scgi-wsgi3* sets up the Python logging with a
	logging format and for logging to standard error. The *-L*
	option suppresses that behavior, so that any handler module
	may set up logging itself.

*-p* 'MODPATH'::

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

*-t* 'HANDLING-MODEL'::

	Specify the way *scgi-wsgi3* handles requests. See the REQUEST
	HANDLING section of *ashd-wsgi3*(1) for details.

*-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 [-hAL] [-m 'PDM-SPEC'] [-p 'MODPATH'] [-t 'HANDLING-MODEL'] [-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	-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
	50	-p 'MODPATH'::
	51
	52	Prepend 'MODPATH' to Python's `sys.path`; can be given multiple
	53	times.
	54
	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
	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
	67	-m 'PDM-SPEC'::
	68
	69	If the PDM library is installed on the system, create a
	70	listening socket for connecting PDM clients according to
	71	'PDM-SPEC'.
	72
	73	AUTHOR
	74	------
	75	Fredrik Tolf <fredrik@dolda2000.com>
	76
	77	SEE ALSO
	78	--------
	79	ashd-wsgi3(1), callscgi(1), <http://wsgi.org/>,
	80	<http://www.python.ca/scgi/>