mtourne/ngx_massive_chunker

Debug module to force nginx to output a lot of small packets.

Name
    ngx_massive_chunker - debug module to force output in tiny chunks.

    *This module is not distributed with the Nginx source.* See the
    installation instructions.


Use Case
    This module is intended to be used with 2 nginx instances, one with
    a proxy_pass to the other while using keepalives.


Status
    This module is intended for debugging only, this shouldn't be used
    in production under any circumnstances.


Synopsis

     server {

        location /chunks {
            mass_chunk on;
            mass_chunk_max_size 3;
            mass_chunk_max_chunks 3;
        }
     }


Directives
  mass_chunk
     syntax: mass_chunk on|off

     default: mass_chunk off

     enable the massive chunking, it will split the content into separate
     chunks.

  mass_chunk_max_size
     syntax: mass_chunk_max_size <size>

     default: mass_chunk_max_size 10

     configure maximum number of bytes that will be sent in a single chunk.

  mass_chunk_max_chunks
     syntax: mass_chunk_max_chunks <size>

     default: mass_chunk_max_chunks 0

     configure maximum number of chunks that will be sent in a single chain
     (for local debugging) or TCP packet (for remote debugging).
     Note: 0 means off, all the chunks will be sent in the same chain.


Installation

     To build nginx with the massive chunker :

     cd nginx

     ./configure --add-module=/path/to/ngx_massive_chunker

     make && make install


Copyright

    Copyright (C) 2011, Matthieu Tourne <matthieu.tourne@gmail.com>.