.\" Text automatically generated by txt2man
.TH aiohttp-wsgi-serve 1 "29 June 2019" "aiohttp-wsgi-serve-0.8.2" "run a WSGI application"
.SH NAME
\fBaiohttp-wsgi-serve \fP- run a WSGI application
.SH SYNOPSIS
.nf
.fam C
\fBaiohttp-wsgi-serve\fP [\fB-h\fP] [\fB--host\fP \fIHOST\fP] [\fB--port\fP \fIPORT\fP]
                   [\fB--unix-socket\fP \fIUNIX_SOCKET\fP]
                   [\fB--unix-socket-perms\fP \fIUNIX_SOCKET_PERMS\fP]
                   [\fB--backlog\fP \fIBACKLOG\fP] [\fB--static\fP \fISTATIC\fP]
                   [\fB--static-cors\fP \fISTATIC_CORS\fP]
                   [\fB--script-name\fP \fISCRIPT_NAME\fP]
                   [\fB--url-scheme\fP \fIURL_SCHEME\fP] [\fB--threads\fP \fITHREADS\fP]
                   [\fB--inbuf-overflow\fP \fIINBUF_OVERFLOW\fP]
                   [\fB--max-request-body-size\fP \fIMAX_REQUEST_BODY_SIZE\fP]
                   [\fB--shutdown-timeout\fP \fISHUTDOWN_TIMEOUT\fP] [\fB--verbose\fP]
                   [\fB--quiet\fP] [\fB--version\fP]
                   \fBmodule:application\fP
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
Run a WSGI application on top of asyncio event loop.
.SH OPTIONS
.TP
.B
\fB-h\fP, \fB--help\fP
show help message and exit
.TP
.B
\fB--host\fP \fIHOST\fP
Host interfaces to bind. Defaults to '0.0.0.0' and '::'. Can be specified multiple times.
.TP
.B
\fB--port\fP \fIPORT\fP, \fB-p\fP \fIPORT\fP
Port to bind. Defaults to 8080.
.TP
.B
\fB--unix-socket\fP \fIUNIX_SOCKET\fP
Path to a unix socket to bind, cannot be used with host.
.TP
.B
\fB--unix-socket-perms\fP \fIUNIX_SOCKET_PERMS\fP
Filesystem permissions to apply to the unix socket. Defaults to 384.
.TP
.B
\fB--backlog\fP \fIBACKLOG\fP
Socket connection backlog. Defaults to 1024.
.TP
.B
\fB--static\fP \fISTATIC\fP
Static route mappings in the form 'path=directory'. `path` must start with a slash, but not end with a slash. Can be specified multiple times.
.TP
.B
\fB--static-cors\fP \fISTATIC_CORS\fP
Set to '*' to enable CORS on static files for all origins, or a string to enable CORS for a specific origin. Defaults to None.
.TP
.B
\fB--script-name\fP \fISCRIPT_NAME\fP
URL prefix for the WSGI application, should start with a slash, but not end with a slash. Defaults to ''.
.TP
.B
\fB--url-scheme\fP \fIURL_SCHEME\fP
A hint about the URL scheme used to access the application. Corresponds to environ['wsgi.url_scheme']. Default is auto-detected to 'http' or 'https'.
.TP
.B
\fB--threads\fP \fITHREADS\fP
Number of threads used to process application logic. Defaults to 4.
.TP
.B
\fB--inbuf-overflow\fP \fIINBUF_OVERFLOW\fP
A tempfile will be created if the request body is larger than this value, which is measured in bytes. Defaults to 524288.
.TP
.B
\fB--max-request-body-size\fP \fIMAX_REQUEST_BODY_SIZE\fP
Maximum number of bytes in request body. Defaults to 1073741824. Larger requests will receive a HTTP 413 (Request Entity Too Large) response.
.TP
.B
\fB--shutdown-timeout\fP \fISHUTDOWN_TIMEOUT\fP
Timeout when closing client connections on server shutdown. Defaults to 60.0.
.TP
.B
\fB--verbose\fP, \fB-v\fP
Increase verbosity. Can be specified multiple times.
.TP
.B
\fB--quiet\fP, \fB-q\fP
Decrease verbosity. Can be specified multiple times.
.TP
.B
\fB--version\fP
Display version information.
.SH EXAMPLES

Run WSGI application on local port 8000 with 8 threads:
.PP
.nf
.fam C
     $ aiohttp-wsgi-serve --host 127.0.0.1 --port 8000 --threads 8 wsgiapp:main

.fam T
.fi
.SH AUTHOR
aiohttp-wsgi was written by David Hall <dave@etianen.com>.
.PP
This manual page was written by William Grzybowski <william@grzy.org> for the Debian project (but may be used by others).