Skip to content
Snippets Groups Projects
Commit 0c2f1626 authored by David Garcia Quintas's avatar David Garcia Quintas
Browse files

Moved docs from .c to .h for compress_filter

parent cadbf224
No related branches found
No related tags found
No related merge requests found
...@@ -31,26 +31,6 @@ ...@@ -31,26 +31,6 @@
* *
*/ */
/** Compression filter for outgoing data.
*
* Compression settings may come from:
* - Channel configuration, as established at channel creation time.
* - The metadata accompanying the outgoing data to be compressed. This is
* taken as a request only. We may choose not to honor it. The metadata key
* is given by \a GRPC_COMPRESS_REQUEST_ALGORITHM_KEY.
*
* Compression can be disabled for concrete messages (for instance in order to
* prevent CRIME/BEAST type attacks) by having the GRPC_WRITE_NO_COMPRESS set in
* the BEGIN_MESSAGE flags.
*
* The attempted compression mechanism is added to the resulting initial
* metadata under the'grpc-encoding' key.
*
* If compression is actually performed, BEGIN_MESSAGE's flag is modified to
* incorporate GRPC_WRITE_INTERNAL_COMPRESS. Otherwise, and regardless of the
* aforementioned 'grpc-encoding' metadata value, data will pass through
* uncompressed. */
#include <assert.h> #include <assert.h>
#include <string.h> #include <string.h>
......
...@@ -38,14 +38,28 @@ ...@@ -38,14 +38,28 @@
#define GRPC_COMPRESS_REQUEST_ALGORITHM_KEY "internal:grpc-encoding-request" #define GRPC_COMPRESS_REQUEST_ALGORITHM_KEY "internal:grpc-encoding-request"
/** Message-level compression filter. /** Compression filter for outgoing data.
* *
* See <grpc/compression.h> for the available compression settings. * See <grpc/compression.h> for the available compression settings.
* *
* grpc_op instances of type GRPC_OP_SEND_MESSAGE can have the bit specified by * Compression settings may come from:
* the GRPC_WRITE_NO_COMPRESS mask in order to disable compression in an * - Channel configuration, as established at channel creation time.
* otherwise compressed channel. * - The metadata accompanying the outgoing data to be compressed. This is
* */ * taken as a request only. We may choose not to honor it. The metadata key
* is given by \a GRPC_COMPRESS_REQUEST_ALGORITHM_KEY.
*
* Compression can be disabled for concrete messages (for instance in order to
* prevent CRIME/BEAST type attacks) by having the GRPC_WRITE_NO_COMPRESS set in
* the BEGIN_MESSAGE flags.
*
* The attempted compression mechanism is added to the resulting initial
* metadata under the'grpc-encoding' key.
*
* If compression is actually performed, BEGIN_MESSAGE's flag is modified to
* incorporate GRPC_WRITE_INTERNAL_COMPRESS. Otherwise, and regardless of the
* aforementioned 'grpc-encoding' metadata value, data will pass through
* uncompressed. */
extern const grpc_channel_filter grpc_compress_filter; extern const grpc_channel_filter grpc_compress_filter;
#endif /* GRPC_INTERNAL_CORE_CHANNEL_COMPRESS_FILTER_H */ #endif /* GRPC_INTERNAL_CORE_CHANNEL_COMPRESS_FILTER_H */
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment