1 ## gRPC Compression
9 Compression is used to reduce the amount of bandwidth used between peers. The
10 compression supported by gRPC acts _at the individual message level_, taking
14 The implementation supports different compression algorithms. A _default
15 compression level_, to be used in the absence of message-specific settings, MAY
18 The ability to control compression settings per call and to enable/disable
19 compression on a per message basis MAY be used to prevent CRIME/BEAST attacks.
20 It also allows for asymmetric compression communication, whereby a response MAY
25 Compression MAY be configured by the Client Application by calling the
26 appropriate API method. There are two scenarios where compression MAY be
29 +  At channel creation time, which sets the channel default compression and
30    therefore the compression that SHALL be used in the absence of per-RPC
31    compression configuration.
35       configuration is reduced to disabling compression altogether.
37 ### Compression Method Asymmetry Between Peers  argument
39 A gRPC peer MAY choose to respond using a different compression method to that
40 of the request, including not performing any compression, regardless of channel
41 and RPC settings (for example, if compression would result in small or negative
50 MUST NOT be related to compression. If a server sent data which is compressed by an algorithm
62 ### Specific Disabling of Compression  argument
65 compression the next message MUST be sent uncompressed. This is instrumental in
69 ### Compression Levels and Algorithms  argument
83 in the future. Currently however, compression levels are only supported at the
89 The inheritance of the compression configuration by child RPCs is left up to the
93 ### Deflate Compression  argument
96 compression to mean the zlib structure (defined in 
98 with the deflate compression algorithm (defined in 
104 1. When a compression level is not specified for either the channel or the
107 1. When per-RPC compression configuration isn't present for a message, the
108 channel compression configuration MUST be used.
109 1. When a compression method (including no compression) is specified for an
114 `grpc-accept-encoding` header MUST NOT contain the compression method
119 `grpc-accept-encoding` header MUST NOT contain the compression method