Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 1 | /* |
| 2 | * |
| 3 | * Copyright 2017 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_CORE_TSI_TRANSPORT_SECURITY_GRPC_H |
| 20 | #define GRPC_CORE_TSI_TRANSPORT_SECURITY_GRPC_H |
| 21 | |
| 22 | #include <grpc/slice_buffer.h> |
| 23 | #include "src/core/tsi/transport_security.h" |
| 24 | |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 25 | /* This method creates a tsi_zero_copy_grpc_protector object. It return TSI_OK |
| 26 | assuming there is no fatal error. |
| 27 | The caller is responsible for destroying the protector. */ |
| 28 | tsi_result tsi_handshaker_result_create_zero_copy_grpc_protector( |
Yash Tibrewal | 8cf1470 | 2017-12-06 09:47:54 -0800 | [diff] [blame^] | 29 | const tsi_handshaker_result* self, size_t* max_output_protected_frame_size, |
Craig Tiller | baa14a9 | 2017-11-03 09:09:36 -0700 | [diff] [blame] | 30 | tsi_zero_copy_grpc_protector** protector); |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 31 | |
| 32 | /* -- tsi_zero_copy_grpc_protector object -- */ |
| 33 | |
| 34 | /* Outputs protected frames. |
| 35 | - unprotected_slices is the unprotected data to be protected. |
| 36 | - protected_slices is the protected output frames. One or more frames |
| 37 | may be produced in this protect function. |
| 38 | - This method returns TSI_OK in case of success or a specific error code in |
| 39 | case of failure. */ |
| 40 | tsi_result tsi_zero_copy_grpc_protector_protect( |
Yash Tibrewal | 8cf1470 | 2017-12-06 09:47:54 -0800 | [diff] [blame^] | 41 | tsi_zero_copy_grpc_protector* self, grpc_slice_buffer* unprotected_slices, |
| 42 | grpc_slice_buffer* protected_slices); |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 43 | |
| 44 | /* Outputs unprotected bytes. |
| 45 | - protected_slices is the bytes of protected frames. |
| 46 | - unprotected_slices is the unprotected output data. |
| 47 | - This method returns TSI_OK in case of success. Success includes cases where |
| 48 | there is not enough data to output in which case unprotected_slices has 0 |
| 49 | bytes. */ |
| 50 | tsi_result tsi_zero_copy_grpc_protector_unprotect( |
Yash Tibrewal | 8cf1470 | 2017-12-06 09:47:54 -0800 | [diff] [blame^] | 51 | tsi_zero_copy_grpc_protector* self, grpc_slice_buffer* protected_slices, |
| 52 | grpc_slice_buffer* unprotected_slices); |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 53 | |
| 54 | /* Destroys the tsi_zero_copy_grpc_protector object. */ |
Yash Tibrewal | 8cf1470 | 2017-12-06 09:47:54 -0800 | [diff] [blame^] | 55 | void tsi_zero_copy_grpc_protector_destroy(tsi_zero_copy_grpc_protector* self); |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 56 | |
| 57 | /* Base for tsi_zero_copy_grpc_protector implementations. */ |
| 58 | typedef struct { |
Yash Tibrewal | 8cf1470 | 2017-12-06 09:47:54 -0800 | [diff] [blame^] | 59 | tsi_result (*protect)(tsi_zero_copy_grpc_protector* self, |
Craig Tiller | baa14a9 | 2017-11-03 09:09:36 -0700 | [diff] [blame] | 60 | grpc_slice_buffer* unprotected_slices, |
| 61 | grpc_slice_buffer* protected_slices); |
Yash Tibrewal | 8cf1470 | 2017-12-06 09:47:54 -0800 | [diff] [blame^] | 62 | tsi_result (*unprotect)(tsi_zero_copy_grpc_protector* self, |
Craig Tiller | baa14a9 | 2017-11-03 09:09:36 -0700 | [diff] [blame] | 63 | grpc_slice_buffer* protected_slices, |
| 64 | grpc_slice_buffer* unprotected_slices); |
Yash Tibrewal | 8cf1470 | 2017-12-06 09:47:54 -0800 | [diff] [blame^] | 65 | void (*destroy)(tsi_zero_copy_grpc_protector* self); |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 66 | } tsi_zero_copy_grpc_protector_vtable; |
| 67 | |
| 68 | struct tsi_zero_copy_grpc_protector { |
Craig Tiller | baa14a9 | 2017-11-03 09:09:36 -0700 | [diff] [blame] | 69 | const tsi_zero_copy_grpc_protector_vtable* vtable; |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 70 | }; |
| 71 | |
Jiangtao Li | 0211cfb | 2017-08-07 11:24:07 -0700 | [diff] [blame] | 72 | #endif /* GRPC_CORE_TSI_TRANSPORT_SECURITY_GRPC_H */ |