Method

SoupMessageset_compression_dictionary_hash

unstable since: 3.8

Declaration [src]

void
soup_message_set_compression_dictionary_hash (
  SoupMessage* msg,
  GBytes* hash
)

Description [src]

Sets the SHA-256 hash of the shared dictionary to advertise for Compression Dictionary Transport (RFC 9842).

When set, SoupContentDecoder will include dcb and/or dcz in the Accept-Encoding request header (over HTTPS) and will send an Available-Dictionary header containing the base64-encoded hash. When the server responds with Content-Encoding: dcb or dcz, the SoupMessage::request-compression-dictionary signal is emitted so the caller can supply the actual dictionary bytes.

The hash does not survive redirects: a dictionary is chosen for a specific request URL, so when msg is redirected the hash and the Available-Dictionary header are cleared. It is the caller’s responsibility to select and set a new dictionary appropriate for the redirect target, if any.

Available since: 3.8

Parameters

hash

Type: GBytes

A GBytes containing the raw SHA-256 hash (32 bytes) of the shared dictionary, or NULL to unset.

The argument can be NULL.

The data is owned by the caller of the method.