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 typedef struct {
45   char addr[GRPC_MAX_SOCKADDR_SIZE];
46   socklen_t len;
47 } grpc_resolved_address;
48 
49 typedef struct {
50   size_t naddrs;
51   grpc_resolved_address* addrs;
52 } grpc_resolved_addresses;
53 
54 typedef struct grpc_address_resolver_vtable {
55   void (*resolve_address)(const char* addr, const char* default_port,
56                           grpc_pollset_set* interested_parties,
57                           grpc_closure* on_done,
58                           grpc_resolved_addresses** addresses);
59   grpc_error* (*blocking_resolve_address)(const char* name,
60                                           const char* default_port,
61                                           grpc_resolved_addresses** addresses);
62 } grpc_address_resolver_vtable;
63 
64 void grpc_set_resolver_impl(grpc_address_resolver_vtable* vtable);
65 
66 /* Asynchronously resolve addr. Use default_port if a port isn't designated
67    in addr, otherwise use the port in addr. */
68 /* TODO(ctiller): add a timeout here */
69 void grpc_resolve_address(const char* addr, const char* default_port,
70                           grpc_pollset_set* interested_parties,
71                           grpc_closure* on_done,
72                           grpc_resolved_addresses** addresses);
73 
74 /* Destroy resolved addresses */
75 void grpc_resolved_addresses_destroy(grpc_resolved_addresses* addresses);
76 
77 /* Resolve addr in a blocking fashion. On success,
78    result must be freed with grpc_resolved_addresses_destroy. */
79 grpc_error* grpc_blocking_resolve_address(const char* name,
80                                           const char* default_port,
81                                           grpc_resolved_addresses** addresses);
82 
83 #endif /* GRPC_CORE_LIB_IOMGR_RESOLVE_ADDRESS_H */
84