Updated README.rst

This commit is contained in:
Tatsuhiro Tsujikawa 2012-06-07 01:58:36 +09:00
parent 18f557f743
commit 6b5beeac14
1 changed files with 51 additions and 1 deletions

View File

@ -41,11 +41,16 @@ needed:
* OpenSSL >= 1.0.1 * OpenSSL >= 1.0.1
To enable ``-a`` option (getting linked assets from the downloaded To enable ``-a`` option (getting linked assets from the downloaded
resouce) in spdycat (one of the example program), the following resouce) in ``spdycat`` (one of the example program), the following
packages are needed: packages are needed:
* libxml2 >= 2.7.7 * libxml2 >= 2.7.7
To build SPDY/HTTPS to HTTP reverse proxy ``shrpx`` (one of the
example program), the following packages are needed:
* libevent-openssl >= 2.0.8
Build from git Build from git
-------------- --------------
@ -88,6 +93,9 @@ purposes. Please note that OpenSSL with `NPN
required in order to build and run these programs. At the time of required in order to build and run these programs. At the time of
this writing, the OpenSSL 1.0.1 supports NPN. this writing, the OpenSSL 1.0.1 supports NPN.
Spdycat - SPDY client
+++++++++++++++++++++
The SPDY client is called ``spdycat``. It is a dead simple downloader The SPDY client is called ``spdycat``. It is a dead simple downloader
like wget/curl. It connects to SPDY server and gets resources given in like wget/curl. It connects to SPDY server and gets resources given in
the command-line:: the command-line::
@ -154,6 +162,9 @@ the command-line::
[ 0.077] send GOAWAY frame <version=3, flags=0, length=8> [ 0.077] send GOAWAY frame <version=3, flags=0, length=8>
(last_good_stream_id=0) (last_good_stream_id=0)
Spdyd - SPDY server
+++++++++++++++++++
SPDY server is called ``spdyd`` and serves static files. It is single SPDY server is called ``spdyd`` and serves static files. It is single
threaded and multiplexes connections using non-blocking socket. The threaded and multiplexes connections using non-blocking socket. The
static files are read using blocking I/O system call, read(2). It static files are read using blocking I/O system call, read(2). It
@ -193,6 +204,45 @@ speaks SPDY/2 and SPDY/3::
Currently, ``spdyd`` needs ``epoll`` or ``kqueue``. Currently, ``spdyd`` needs ``epoll`` or ``kqueue``.
Shrpx - A reverse proxy for SPDY/HTTPS
++++++++++++++++++++++++++++++++++++++
The ``shrpx`` is a multi-threaded reverse proxy for SPDY/HTTPS. It
converts SPDY/HTTPS traffic to plain HTTP.
Here is the command-line options::
Usage: shrpx [-Dh] [-b <HOST,PORT>] [-f <HOST,PORT>] [-n <CORES>]
[-c <NUM>] [-L <LEVEL>] <PRIVATE_KEY> <CERT>
A reverse proxy for SPDY/HTTPS.
OPTIONS:
-b, --backend=<HOST,PORT>
Set backend host and port.
Default: 'localhost,80'
-f, --frontend=<HOST,PORT>
Set frontend host and port.
Default: 'localhost,3000'
-n, --workers=<CORES>
Set the number of worker threads.
-c, --spdy-max-concurrent-streams=<NUM>
Set the maximum number of the concurrent
streams in one SPDY session.
-L, --log-level=<LEVEL>
Set the severity level of log output.
INFO, WARNING, ERROR and FATAL
-D, --daemon Run in a background. If -D is used, the
current working directory is changed to '/'.
-h, --help Print this help.
For those of you who are curious, ``shrpx`` is an abbreviation of
"Spdy/https to Http Reverse ProXy".
Other examples
++++++++++++++
There is another SPDY server called ``spdynative``, which is There is another SPDY server called ``spdynative``, which is
`node.native <https://github.com/d5/node.native>`_ style simple SPDY `node.native <https://github.com/d5/node.native>`_ style simple SPDY
server:: server::