Module rustls::compress

Certificate compression and decompression support

This crate supports compression and decompression everywhere certificates are used, in accordance with RFC8879.

Note that this is only supported for TLS1.3 connections.

Getting started

Build this crate with the brotli and/or zlib crate features. This adds dependencies on these crates. They are used by default if enabled.

We especially recommend brotli as it has the widest deployment so far.

Custom compression/decompression implementations

1. Implement the CertCompressor and/or CertDecompressor traits
2. Provide those to:

• ClientConfig::cert_compressors or ServerConfig::cert_compressors.
• ClientConfig::cert_decompressors or ServerConfig::cert_decompressors.

These are used in these circumstances:

Peer	Client authentication	Server authentication
Client	ClientConfig::cert_compressors	ClientConfig::cert_decompressors
Server	ServerConfig::cert_decompressors	ServerConfig::cert_compressors

Structs

• CompressionCacheInner
  Innards of an enabled CompressionCache.
• CompressionFailed
  A content-less error for when CertCompressor::compress fails.
• DecompressionFailed
  A content-less error for when CertDecompressor::decompress fails.

Enums

• CompressionCache
  An LRU cache for compressions.
• CompressionLevel
  A hint for how many resources to dedicate to a compression.

Traits

• CertCompressor
  An available certificate compression algorithm.
• CertDecompressor
  An available certificate decompression algorithm.

Functions

• default_cert_compressors
  Returns the supported CertCompressor implementations enabled by crate features.
• default_cert_decompressors
  Returns the supported CertDecompressor implementations enabled by crate features.