Update doc

_static/jquery.js

@@ -11,7 +11,7 @@
  * Copyright 2011, The Dojo Foundation
  * Released under the MIT, BSD, and GPL Licenses.
  *
- * Date: Thu Aug  1 23:20:30 BRT 2013
+ * Date: Fri Jul  5 14:07:58 UTC 2013
  */
 (function( window, undefined ) {
 

apiref.html

@@ -942,6 +942,33 @@ which is analogous to HEADERS in SPDY.</p>
 
 </dd></dl>
 
+<dl class="type">
+<dt id="c.nghttp2_hd_inflate_flag">
+<tt class="descname">nghttp2_hd_inflate_flag</tt><a class="headerlink" href="#c.nghttp2_hd_inflate_flag" title="Permalink to this definition">¶</a></dt>
+<dd><p>The flags for header inflation.</p>
+<dl class="macro">
+<dt id="c.NGHTTP2_HD_INFLATE_NONE">
+<tt class="descname">NGHTTP2_HD_INFLATE_NONE</tt><a class="headerlink" href="#c.NGHTTP2_HD_INFLATE_NONE" title="Permalink to this definition">¶</a></dt>
+<dd><p>(<tt class="docutils literal"><span class="pre">0</span></tt>)
+No flag set.</p>
+</dd></dl>
+
+<dl class="macro">
+<dt id="c.NGHTTP2_HD_INFLATE_FINAL">
+<tt class="descname">NGHTTP2_HD_INFLATE_FINAL</tt><a class="headerlink" href="#c.NGHTTP2_HD_INFLATE_FINAL" title="Permalink to this definition">¶</a></dt>
+<dd><p>(<tt class="docutils literal"><span class="pre">1</span></tt>)
+Indicates all headers were inflated.</p>
+</dd></dl>
+
+<dl class="macro">
+<dt id="c.NGHTTP2_HD_INFLATE_EMIT">
+<tt class="descname">NGHTTP2_HD_INFLATE_EMIT</tt><a class="headerlink" href="#c.NGHTTP2_HD_INFLATE_EMIT" title="Permalink to this definition">¶</a></dt>
+<dd><p>(<tt class="docutils literal"><span class="pre">(1</span> <span class="pre">&lt;&lt;</span> <span class="pre">1)</span></tt>)
+Indicates a header was emitted.</p>
+</dd></dl>
+
+</dd></dl>
+
 </div>
 <div class="section" id="types-structs-unions-and-typedefs">
 <h2>Types (structs, unions and typedefs)<a class="headerlink" href="#types-structs-unions-and-typedefs" title="Permalink to this headline">¶</a></h2>
@@ -1960,6 +1987,12 @@ this structure are intentionally hidden from the public API.</p>
 intentionally hidden from the public API.</p>
 </dd></dl>
 
+<dl class="type">
+<dt id="c.nghttp2_hd_inflater">
+<tt class="descname">nghttp2_hd_inflater</tt><a class="headerlink" href="#c.nghttp2_hd_inflater" title="Permalink to this definition">¶</a></dt>
+<dd><p>HPACK inflater object.</p>
+</dd></dl>
+
 </div>
 <div class="section" id="functions">
 <h2>Functions<a class="headerlink" href="#functions" title="Permalink to this headline">¶</a></h2>
@@ -3049,6 +3082,78 @@ is valid according to
 character (0x00).</p>
 </dd></dl>
 
+<dl class="function">
+<dt id="c.nghttp2_hd_inflate_new">
+int <tt class="descname">nghttp2_hd_inflate_new</tt><big>(</big><a class="reference internal" href="#c.nghttp2_hd_inflater" title="nghttp2_hd_inflater">nghttp2_hd_inflater</a><em>&nbsp;**inflater_ptr</em><big>)</big><a class="headerlink" href="#c.nghttp2_hd_inflate_new" title="Permalink to this definition">¶</a></dt>
+<dd><p>Initializes <em>*inflater_ptr</em> for inflating name/values pairs.</p>
+<p>This function returns 0 if it succeeds, or one of the following
+negative error codes:</p>
+<dl class="docutils">
+<dt><a class="reference internal" href="#c.NGHTTP2_ERR_NOMEM" title="NGHTTP2_ERR_NOMEM"><tt class="xref c c-macro docutils literal"><span class="pre">NGHTTP2_ERR_NOMEM</span></tt></a></dt>
+<dd>Out of memory.</dd>
+</dl>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.nghttp2_hd_inflate_del">
+void <tt class="descname">nghttp2_hd_inflate_del</tt><big>(</big><a class="reference internal" href="#c.nghttp2_hd_inflater" title="nghttp2_hd_inflater">nghttp2_hd_inflater</a><em>&nbsp;*inflater</em><big>)</big><a class="headerlink" href="#c.nghttp2_hd_inflate_del" title="Permalink to this definition">¶</a></dt>
+<dd><p>Deallocates any resources allocated for <em>inflater</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.nghttp2_hd_inflate_change_table_size">
+int <tt class="descname">nghttp2_hd_inflate_change_table_size</tt><big>(</big><a class="reference internal" href="#c.nghttp2_hd_inflater" title="nghttp2_hd_inflater">nghttp2_hd_inflater</a><em>&nbsp;*inflater</em>, size_t<em>&nbsp;settings_hd_table_bufsize_max</em><big>)</big><a class="headerlink" href="#c.nghttp2_hd_inflate_change_table_size" title="Permalink to this definition">¶</a></dt>
+<dd><p>Changes header table size in the <em>inflater</em>. This may trigger
+eviction in the dynamic table.</p>
+<p>The <em>settings_hd_table_bufsize_max</em> should be the value transmitted
+in SETTINGS_HEADER_TABLE_SIZE.</p>
+<p>This function returns 0 if it succeeds, or one of the following
+negative error codes:</p>
+<dl class="docutils">
+<dt><a class="reference internal" href="#c.NGHTTP2_ERR_NOMEM" title="NGHTTP2_ERR_NOMEM"><tt class="xref c c-macro docutils literal"><span class="pre">NGHTTP2_ERR_NOMEM</span></tt></a></dt>
+<dd>Out of memory.</dd>
+</dl>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.nghttp2_hd_inflate_hd">
+ssize_t <tt class="descname">nghttp2_hd_inflate_hd</tt><big>(</big><a class="reference internal" href="#c.nghttp2_hd_inflater" title="nghttp2_hd_inflater">nghttp2_hd_inflater</a><em>&nbsp;*inflater</em>, <a class="reference internal" href="#c.nghttp2_nv" title="nghttp2_nv">nghttp2_nv</a><em>&nbsp;*nv_out</em>, int<em>&nbsp;*inflate_flags</em>, uint8_t<em>&nbsp;*in</em>, size_t<em>&nbsp;inlen</em>, int<em>&nbsp;in_final</em><big>)</big><a class="headerlink" href="#c.nghttp2_hd_inflate_hd" title="Permalink to this definition">¶</a></dt>
+<dd><p>Inflates name/value block stored in <em>in</em> with length <em>inlen</em>. This
+function performs decompression. For each successful emission of
+header name/value pair, <a class="reference internal" href="#c.NGHTTP2_HD_INFLATE_EMIT" title="NGHTTP2_HD_INFLATE_EMIT"><tt class="xref c c-macro docutils literal"><span class="pre">NGHTTP2_HD_INFLATE_EMIT</span></tt></a> is set in
+<em>*inflate_flags</em> and name/value pair is assigned to the <em>nv_out</em>
+and the function returns. The caller must not free the members of
+<em>nv_out</em>.</p>
+<p>The <em>nv_out</em> may include pointers to the memory region in the
+<em>in</em>. The caller must retain the <em>in</em> while the <em>nv_out</em> is used.</p>
+<p>The application should call this function repeatedly until the
+<tt class="xref c c-func docutils literal"><span class="pre">(*inflate_flags)</span> <span class="pre">&amp;</span> <span class="pre">NGHTTP2_HD_INFLATE_FINAL()</span></tt> is nonzero and return
+value is non-negative. This means the all input values are
+processed successfully. Then the application must call
+<a class="reference internal" href="#c.nghttp2_hd_inflate_end_headers" title="nghttp2_hd_inflate_end_headers"><tt class="xref c c-func docutils literal"><span class="pre">nghttp2_hd_inflate_end_headers()</span></tt></a> to prepare for the next header
+block input.</p>
+<p>The caller can feed complete compressed header block. It also can
+feed it in several chunks. The caller must set <em>in_final</em> to
+nonzero if the given input is the last block of the compressed
+header.</p>
+<p>This function returns the number of bytes processed if it succeeds,
+or one of the following negative error codes:</p>
+<dl class="docutils">
+<dt><a class="reference internal" href="#c.NGHTTP2_ERR_NOMEM" title="NGHTTP2_ERR_NOMEM"><tt class="xref c c-macro docutils literal"><span class="pre">NGHTTP2_ERR_NOMEM</span></tt></a></dt>
+<dd>Out of memory.</dd>
+<dt><a class="reference internal" href="#c.NGHTTP2_ERR_HEADER_COMP" title="NGHTTP2_ERR_HEADER_COMP"><tt class="xref c c-macro docutils literal"><span class="pre">NGHTTP2_ERR_HEADER_COMP</span></tt></a></dt>
+<dd>Inflation process has failed.</dd>
+</dl>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.nghttp2_hd_inflate_end_headers">
+int <tt class="descname">nghttp2_hd_inflate_end_headers</tt><big>(</big><a class="reference internal" href="#c.nghttp2_hd_inflater" title="nghttp2_hd_inflater">nghttp2_hd_inflater</a><em>&nbsp;*inflater</em><big>)</big><a class="headerlink" href="#c.nghttp2_hd_inflate_end_headers" title="Permalink to this definition">¶</a></dt>
+<dd><p>Signals the end of decompression for one header block.</p>
+<p>This function returns 0 if it succeeds. Currently this function
+always succeeds.</p>
+</dd></dl>
+
 </div>
 </div>
 

genindex.html

@@ -659,6 +659,46 @@
   </dt>
 
       
+  <dt><a href="apiref.html#c.nghttp2_hd_inflate_change_table_size">nghttp2_hd_inflate_change_table_size (C function)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.nghttp2_hd_inflate_del">nghttp2_hd_inflate_del (C function)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.NGHTTP2_HD_INFLATE_EMIT">NGHTTP2_HD_INFLATE_EMIT (C macro)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.nghttp2_hd_inflate_end_headers">nghttp2_hd_inflate_end_headers (C function)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.NGHTTP2_HD_INFLATE_FINAL">NGHTTP2_HD_INFLATE_FINAL (C macro)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.nghttp2_hd_inflate_flag">nghttp2_hd_inflate_flag (C type)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.nghttp2_hd_inflate_hd">nghttp2_hd_inflate_hd (C function)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.nghttp2_hd_inflate_new">nghttp2_hd_inflate_new (C function)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.NGHTTP2_HD_INFLATE_NONE">NGHTTP2_HD_INFLATE_NONE (C macro)</a>
+  </dt>
+
+      
+  <dt><a href="apiref.html#c.nghttp2_hd_inflater">nghttp2_hd_inflater (C type)</a>
+  </dt>
+
+      
   <dt><a href="apiref.html#c.NGHTTP2_HEADERS">NGHTTP2_HEADERS (C macro)</a>
   </dt>
 
@@ -714,6 +754,8 @@
   <dt><a href="apiref.html#c.nghttp2_info.version_num">nghttp2_info.version_num (C member)</a>
   </dt>
 
+  </dl></td>
+  <td style="width: 33%" valign="top"><dl>
       
   <dt><a href="apiref.html#c.nghttp2_info.version_str">nghttp2_info.version_str (C member)</a>
   </dt>
@@ -734,8 +776,6 @@
   <dt><a href="apiref.html#c.NGHTTP2_INTERNAL_ERROR">NGHTTP2_INTERNAL_ERROR (C macro)</a>
   </dt>
 
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
       
   <dt><a href="apiref.html#c.nghttp2_is_fatal">nghttp2_is_fatal (C function)</a>
   </dt>

nghttp2.h.html

@@ -318,7 +318,7 @@
 <span class="cm"> *</span>
 <span class="cm"> * The maximum header table size.</span>
 <span class="cm"> */</span>
-<span class="cp">#define NGHTTP2_MAX_HEADER_TABLE_SIZE (1 &lt;&lt; 16)</span>
+<span class="cp">#define NGHTTP2_MAX_HEADER_TABLE_SIZE (1 &lt;&lt; 28)</span>
 
 
 <span class="cm">/**</span>
@@ -3003,6 +3003,122 @@
 <span class="cm"> */</span>
 <span class="kt">int</span> <span class="nf">nghttp2_check_header_value</span><span class="p">(</span><span class="k">const</span> <span class="kt">uint8_t</span> <span class="o">*</span><span class="n">value</span><span class="p">,</span> <span class="kt">size_t</span> <span class="n">len</span><span class="p">);</span>
 
+<span class="cm">/* HPACK API */</span>
+
+<span class="k">struct</span> <span class="n">nghttp2_hd_inflater</span><span class="p">;</span>
+
+<span class="cm">/**</span>
+<span class="cm"> * @struct</span>
+<span class="cm"> *</span>
+<span class="cm"> * HPACK inflater object.</span>
+<span class="cm"> */</span>
+<span class="k">typedef</span> <span class="k">struct</span> <span class="n">nghttp2_hd_inflater</span> <span class="n">nghttp2_hd_inflater</span><span class="p">;</span>
+
+<span class="cm">/**</span>
+<span class="cm"> * @function</span>
+<span class="cm"> *</span>
+<span class="cm"> * Initializes |*inflater_ptr| for inflating name/values pairs.</span>
+<span class="cm"> *</span>
+<span class="cm"> * This function returns 0 if it succeeds, or one of the following</span>
+<span class="cm"> * negative error codes:</span>
+<span class="cm"> *</span>
+<span class="cm"> * :enum:`NGHTTP2_ERR_NOMEM`</span>
+<span class="cm"> *     Out of memory.</span>
+<span class="cm"> */</span>
+<span class="kt">int</span> <span class="nf">nghttp2_hd_inflate_new</span><span class="p">(</span><span class="n">nghttp2_hd_inflater</span> <span class="o">**</span><span class="n">inflater_ptr</span><span class="p">);</span>
+
+<span class="cm">/**</span>
+<span class="cm"> * @function</span>
+<span class="cm"> *</span>
+<span class="cm"> * Deallocates any resources allocated for |inflater|.</span>
+<span class="cm"> */</span>
+<span class="kt">void</span> <span class="nf">nghttp2_hd_inflate_del</span><span class="p">(</span><span class="n">nghttp2_hd_inflater</span> <span class="o">*</span><span class="n">inflater</span><span class="p">);</span>
+
+<span class="cm">/**</span>
+<span class="cm"> * @function</span>
+<span class="cm"> *</span>
+<span class="cm"> * Changes header table size in the |inflater|. This may trigger</span>
+<span class="cm"> * eviction in the dynamic table.</span>
+<span class="cm"> *</span>
+<span class="cm"> * The |settings_hd_table_bufsize_max| should be the value transmitted</span>
+<span class="cm"> * in SETTINGS_HEADER_TABLE_SIZE.</span>
+<span class="cm"> *</span>
+<span class="cm"> * This function returns 0 if it succeeds, or one of the following</span>
+<span class="cm"> * negative error codes:</span>
+<span class="cm"> *</span>
+<span class="cm"> * :enum:`NGHTTP2_ERR_NOMEM`</span>
+<span class="cm"> *     Out of memory.</span>
+<span class="cm"> */</span>
+<span class="kt">int</span> <span class="nf">nghttp2_hd_inflate_change_table_size</span><span class="p">(</span><span class="n">nghttp2_hd_inflater</span> <span class="o">*</span><span class="n">inflater</span><span class="p">,</span>
+                                         <span class="kt">size_t</span> <span class="n">settings_hd_table_bufsize_max</span><span class="p">);</span>
+
+<span class="cm">/**</span>
+<span class="cm"> * @enum</span>
+<span class="cm"> *</span>
+<span class="cm"> * The flags for header inflation.</span>
+<span class="cm"> */</span>
+<span class="k">typedef</span> <span class="k">enum</span> <span class="p">{</span>
+  <span class="cm">/**</span>
+<span class="cm">   * No flag set.</span>
+<span class="cm">   */</span>
+  <span class="n">NGHTTP2_HD_INFLATE_NONE</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
+  <span class="cm">/**</span>
+<span class="cm">   * Indicates all headers were inflated.</span>
+<span class="cm">   */</span>
+  <span class="n">NGHTTP2_HD_INFLATE_FINAL</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+  <span class="cm">/**</span>
+<span class="cm">   * Indicates a header was emitted.</span>
+<span class="cm">   */</span>
+  <span class="n">NGHTTP2_HD_INFLATE_EMIT</span> <span class="o">=</span> <span class="p">(</span><span class="mi">1</span> <span class="o">&lt;&lt;</span> <span class="mi">1</span><span class="p">)</span>
+<span class="p">}</span> <span class="n">nghttp2_hd_inflate_flag</span><span class="p">;</span>
+
+<span class="cm">/**</span>
+<span class="cm"> * @function</span>
+<span class="cm"> *</span>
+<span class="cm"> * Inflates name/value block stored in |in| with length |inlen|. This</span>
+<span class="cm"> * function performs decompression. For each successful emission of</span>
+<span class="cm"> * header name/value pair, :enum:`NGHTTP2_HD_INFLATE_EMIT` is set in</span>
+<span class="cm"> * |*inflate_flags| and name/value pair is assigned to the |nv_out|</span>
+<span class="cm"> * and the function returns. The caller must not free the members of</span>
+<span class="cm"> * |nv_out|.</span>
+<span class="cm"> *</span>
+<span class="cm"> * The |nv_out| may include pointers to the memory region in the</span>
+<span class="cm"> * |in|. The caller must retain the |in| while the |nv_out| is used.</span>
+<span class="cm"> *</span>
+<span class="cm"> * The application should call this function repeatedly until the</span>
+<span class="cm"> * `(*inflate_flags) &amp; NGHTTP2_HD_INFLATE_FINAL` is nonzero and return</span>
+<span class="cm"> * value is non-negative. This means the all input values are</span>
+<span class="cm"> * processed successfully. Then the application must call</span>
+<span class="cm"> * `nghttp2_hd_inflate_end_headers()` to prepare for the next header</span>
+<span class="cm"> * block input.</span>
+<span class="cm"> *</span>
+<span class="cm"> * The caller can feed complete compressed header block. It also can</span>
+<span class="cm"> * feed it in several chunks. The caller must set |in_final| to</span>
+<span class="cm"> * nonzero if the given input is the last block of the compressed</span>
+<span class="cm"> * header.</span>
+<span class="cm"> *</span>
+<span class="cm"> * This function returns the number of bytes processed if it succeeds,</span>
+<span class="cm"> * or one of the following negative error codes:</span>
+<span class="cm"> *</span>
+<span class="cm"> * :enum:`NGHTTP2_ERR_NOMEM`</span>
+<span class="cm"> *     Out of memory.</span>
+<span class="cm"> * :enum:`NGHTTP2_ERR_HEADER_COMP`</span>
+<span class="cm"> *     Inflation process has failed.</span>
+<span class="cm"> */</span>
+<span class="kt">ssize_t</span> <span class="nf">nghttp2_hd_inflate_hd</span><span class="p">(</span><span class="n">nghttp2_hd_inflater</span> <span class="o">*</span><span class="n">inflater</span><span class="p">,</span>
+                              <span class="n">nghttp2_nv</span> <span class="o">*</span><span class="n">nv_out</span><span class="p">,</span> <span class="kt">int</span> <span class="o">*</span><span class="n">inflate_flags</span><span class="p">,</span>
+                              <span class="kt">uint8_t</span> <span class="o">*</span><span class="n">in</span><span class="p">,</span> <span class="kt">size_t</span> <span class="n">inlen</span><span class="p">,</span> <span class="kt">int</span> <span class="n">in_final</span><span class="p">);</span>
+
+<span class="cm">/**</span>
+<span class="cm"> * @function</span>
+<span class="cm"> *</span>
+<span class="cm"> * Signals the end of decompression for one header block.</span>
+<span class="cm"> *</span>
+<span class="cm"> * This function returns 0 if it succeeds. Currently this function</span>
+<span class="cm"> * always succeeds.</span>
+<span class="cm"> */</span>
+<span class="kt">int</span> <span class="nf">nghttp2_hd_inflate_end_headers</span><span class="p">(</span><span class="n">nghttp2_hd_inflater</span> <span class="o">*</span><span class="n">inflater</span><span class="p">);</span>
+
 <span class="cp">#ifdef __cplusplus</span>
 <span class="p">}</span>
 <span class="cp">#endif</span>