1 | /* |
2 | * |
3 | * Copyright 2015 gRPC authors. |
4 | * |
5 | * Licensed under the Apache License, Version 2.0 (the "License"); |
6 | * you may not use this file except in compliance with the License. |
7 | * You may obtain a copy of the License at |
8 | * |
9 | * http://www.apache.org/licenses/LICENSE-2.0 |
10 | * |
11 | * Unless required by applicable law or agreed to in writing, software |
12 | * distributed under the License is distributed on an "AS IS" BASIS, |
13 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
14 | * See the License for the specific language governing permissions and |
15 | * limitations under the License. |
16 | * |
17 | */ |
18 | |
19 | #ifndef GRPC_COMPRESSION_H |
20 | #define GRPC_COMPRESSION_H |
21 | |
22 | #include <grpc/impl/codegen/port_platform.h> |
23 | |
24 | #include <stdlib.h> |
25 | |
26 | #include <grpc/impl/codegen/compression_types.h> |
27 | #include <grpc/slice.h> |
28 | |
29 | #ifdef __cplusplus |
30 | extern "C" { |
31 | #endif |
32 | |
33 | /** Return if an algorithm is message compression algorithm. */ |
34 | GRPCAPI int grpc_compression_algorithm_is_message( |
35 | grpc_compression_algorithm algorithm); |
36 | |
37 | /** Return if an algorithm is stream compression algorithm. */ |
38 | GRPCAPI int grpc_compression_algorithm_is_stream( |
39 | grpc_compression_algorithm algorithm); |
40 | |
41 | /** Parses the \a slice as a grpc_compression_algorithm instance and updating \a |
42 | * algorithm. Returns 1 upon success, 0 otherwise. */ |
43 | GRPCAPI int grpc_compression_algorithm_parse( |
44 | grpc_slice value, grpc_compression_algorithm* algorithm); |
45 | |
46 | /** Updates \a name with the encoding name corresponding to a valid \a |
47 | * algorithm. Note that \a name is statically allocated and must *not* be freed. |
48 | * Returns 1 upon success, 0 otherwise. */ |
49 | GRPCAPI int grpc_compression_algorithm_name( |
50 | grpc_compression_algorithm algorithm, const char** name); |
51 | |
52 | /** Returns the compression algorithm corresponding to \a level for the |
53 | * compression algorithms encoded in the \a accepted_encodings bitset.*/ |
54 | GRPCAPI grpc_compression_algorithm grpc_compression_algorithm_for_level( |
55 | grpc_compression_level level, uint32_t accepted_encodings); |
56 | |
57 | GRPCAPI void grpc_compression_options_init(grpc_compression_options* opts); |
58 | |
59 | /** Mark \a algorithm as enabled in \a opts. */ |
60 | GRPCAPI void grpc_compression_options_enable_algorithm( |
61 | grpc_compression_options* opts, grpc_compression_algorithm algorithm); |
62 | |
63 | /** Mark \a algorithm as disabled in \a opts. */ |
64 | GRPCAPI void grpc_compression_options_disable_algorithm( |
65 | grpc_compression_options* opts, grpc_compression_algorithm algorithm); |
66 | |
67 | /** Returns true if \a algorithm is marked as enabled in \a opts. */ |
68 | GRPCAPI int grpc_compression_options_is_algorithm_enabled( |
69 | const grpc_compression_options* opts, grpc_compression_algorithm algorithm); |
70 | |
71 | #ifdef __cplusplus |
72 | } |
73 | #endif |
74 | |
75 | #endif /* GRPC_COMPRESSION_H */ |
76 | |