| 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 | |