doc/nghttp2_hd_inflate_change_table_size.rst

   1
   2 nghttp2_hd_inflate_change_table_size
   3 ====================================
   4
   5 Synopsis
   6 --------
   7
   8 *#include <nghttp2/nghttp2.h>*
   9
  10 .. function:: int nghttp2_hd_inflate_change_table_size(nghttp2_hd_inflater *inflater, size_t settings_max_dynamic_table_size)
  11
  12
  13     Changes header table size in the *inflater*.  This may trigger
  14     eviction in the dynamic table.
  15
  16     The *settings_max_dynamic_table_size* should be the value
  17     transmitted in SETTINGS_HEADER_TABLE_SIZE.
  18
  19     This function must not be called while header block is being
  20     inflated.  In other words, this function must be called after
  21     initialization of *inflater*, but before calling
  22     `nghttp2_hd_inflate_hd2()`, or after
  23     `nghttp2_hd_inflate_end_headers()`.  Otherwise,
  24     `NGHTTP2_ERR_INVALID_STATE` was returned.
  25
  26     This function returns 0 if it succeeds, or one of the following
  27     negative error codes:
  28
  29     :macro:`NGHTTP2_ERR_NOMEM`
  30         Out of memory.
  31     :macro:`NGHTTP2_ERR_INVALID_STATE`
  32         The function is called while header block is being inflated.
  33         Probably, application missed to call
  34         `nghttp2_hd_inflate_end_headers()`.