src/core/lib/iomgr/resolve_address.h

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