Mercurial > hg > ngx_http_bytes_filter_module
changeset 6:91985471307e
Add license and some minimal documentation.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Fri, 04 Jul 2008 05:35:38 +0400 |
parents | be5e612dd602 |
children | 2e1eaf93e67e |
files | LICENSE README |
diffstat | 2 files changed, 53 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
new file mode 100644 --- /dev/null +++ b/LICENSE @@ -0,0 +1,25 @@ +/* + * Copyright (C) 2008 Maxim Dounin + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + */
new file mode 100644 --- /dev/null +++ b/README @@ -0,0 +1,28 @@ +Bytes module for nginx. + +This module was designed to allow easy access to range of file data. It +searches request arguments for 'bytes=...' and return requested range. All +requested data is returned concatinated in single reply, with apropriate +Content-Length set. + +All of the above allows to do nasty things with regular files and even +proxied replies, including things like flv streaming. E.g. one may use +something like this instead of flv module: + + location /video/ { + bytes on; + if ($args ~ "start=(\d+)") { + set $args "bytes=0-12,$1-"; + } + } + +Argument bytes= must contain range specification as defined in RFC 2616, +"14.35.1 Byte Ranges", with the following exceptions: + + 1. Whitespaces aren't permitted. + + 1. Ranges must not overlap and must be monothonic. E.g. something + like "bytes=10-20,0-10" isn't premitted. + +To compile nginx with bytes module, use "--add-module <path>" option to nginx +configure.