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_CORE_LIB_IOMGR_RESOLVE_ADDRESS_H 20 #define GRPC_CORE_LIB_IOMGR_RESOLVE_ADDRESS_H 21 22 #include <grpc/support/port_platform.h> 23 24 #include <stddef.h> 25 26 #include "src/core/lib/iomgr/port.h" 27 28 #ifdef GRPC_UV 29 #include <uv.h> 30 #endif 31 32 #ifdef GRPC_WINSOCK_SOCKET 33 #include <ws2tcpip.h> 34 #endif 35 36 #if defined(GRPC_POSIX_SOCKET) || defined(GRPC_CFSTREAM) 37 #include <sys/socket.h> 38 #endif 39 40 #include "src/core/lib/iomgr/pollset_set.h" 41 42 #define GRPC_MAX_SOCKADDR_SIZE 128 43 44 struct grpc_resolved_address { 45 char addr[GRPC_MAX_SOCKADDR_SIZE]; 46 socklen_t len; 47 }; 48 struct grpc_resolved_addresses { 49 size_t naddrs; 50 grpc_resolved_address* addrs; 51 }; 52 typedef struct grpc_address_resolver_vtable { 53 void (*resolve_address)(const char* addr, const char* default_port, 54 grpc_pollset_set* interested_parties, 55 grpc_closure* on_done, 56 grpc_resolved_addresses** addresses); 57 grpc_error* (*blocking_resolve_address)(const char* name, 58 const char* default_port, 59 grpc_resolved_addresses** addresses); 60 } grpc_address_resolver_vtable; 61 62 void grpc_set_resolver_impl(grpc_address_resolver_vtable* vtable); 63 64 /* Asynchronously resolve addr. Use default_port if a port isn't designated 65 in addr, otherwise use the port in addr. */ 66 /* TODO(apolcyn): add a timeout here */ 67 void grpc_resolve_address(const char* addr, const char* default_port, 68 grpc_pollset_set* interested_parties, 69 grpc_closure* on_done, 70 grpc_resolved_addresses** addresses); 71 72 /* Destroy resolved addresses */ 73 void grpc_resolved_addresses_destroy(grpc_resolved_addresses* addresses); 74 75 /* Resolve addr in a blocking fashion. On success, 76 result must be freed with grpc_resolved_addresses_destroy. */ 77 grpc_error* grpc_blocking_resolve_address(const char* name, 78 const char* default_port, 79 grpc_resolved_addresses** addresses); 80 81 #endif /* GRPC_CORE_LIB_IOMGR_RESOLVE_ADDRESS_H */ 82