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_SRC_CORE_LIB_IOMGR_IOMGR_INTERNAL_H 20 #define GRPC_SRC_CORE_LIB_IOMGR_IOMGR_INTERNAL_H 21 22 #include <grpc/support/port_platform.h> 23 24 #include <stdbool.h> 25 26 #include "src/core/lib/iomgr/closure.h" 27 #include "src/core/lib/iomgr/error.h" 28 29 typedef struct grpc_iomgr_object { 30 char* name; 31 struct grpc_iomgr_object* next; 32 struct grpc_iomgr_object* prev; 33 } grpc_iomgr_object; 34 35 typedef struct grpc_iomgr_platform_vtable { 36 void (*init)(void); 37 void (*flush)(void); 38 void (*shutdown)(void); 39 void (*shutdown_background_closure)(void); 40 bool (*is_any_background_poller_thread)(void); 41 bool (*add_closure_to_background_poller)(grpc_closure* closure, 42 grpc_error_handle error); 43 } grpc_iomgr_platform_vtable; 44 45 void grpc_iomgr_register_object(grpc_iomgr_object* obj, const char* name); 46 void grpc_iomgr_unregister_object(grpc_iomgr_object* obj); 47 48 bool grpc_have_determined_iomgr_platform(); 49 50 void grpc_set_iomgr_platform_vtable(grpc_iomgr_platform_vtable* vtable); 51 52 void grpc_set_default_iomgr_platform(); 53 54 void grpc_iomgr_platform_init(void); 55 /// flush any globally queued work from iomgr 56 void grpc_iomgr_platform_flush(void); 57 /// tear down all platform specific global iomgr structures 58 void grpc_iomgr_platform_shutdown(void); 59 60 /// shut down all the closures registered in the background poller 61 void grpc_iomgr_platform_shutdown_background_closure(void); 62 63 /// return true if the caller is a worker thread for any background poller 64 bool grpc_iomgr_platform_is_any_background_poller_thread(void); 65 66 /// Return true if the closure is registered into the background poller. Note 67 /// that the closure may or may not run yet when this function returns, and the 68 /// closure should not be blocking or long-running. 69 bool grpc_iomgr_platform_add_closure_to_background_poller( 70 grpc_closure* closure, grpc_error_handle error); 71 72 bool grpc_iomgr_abort_on_leaks(void); 73 74 #endif // GRPC_SRC_CORE_LIB_IOMGR_IOMGR_INTERNAL_H 75