GRPC Core 0.10.0.0

- Main Page
- Data Structures
- Files

- File List
- Globals

All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
resolve_address.h
Go to the documentation of this file.
1 /*
2 *
3 * Copyright 2015, Google Inc.
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions are
8 * met:
9 *
10 * * Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * * Redistributions in binary form must reproduce the above
13 * copyright notice, this list of conditions and the following disclaimer
14 * in the documentation and/or other materials provided with the
15 * distribution.
16 * * Neither the name of Google Inc. nor the names of its
17 * contributors may be used to endorse or promote products derived from
18 * this software without specific prior written permission.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 *
32 */
33
34 #ifndef GRPC_INTERNAL_CORE_IOMGR_RESOLVE_ADDRESS_H
35 #define GRPC_INTERNAL_CORE_IOMGR_RESOLVE_ADDRESS_H
36
37 #include <stddef.h>
38
39 #define GRPC_MAX_SOCKADDR_SIZE 128
40
41 typedef struct {
42 char addr[GRPC_MAX_SOCKADDR_SIZE];
43 int len;
44 } grpc_resolved_address;
45
46 typedef struct {
47 size_t naddrs;
48 grpc_resolved_address *addrs;
49 } grpc_resolved_addresses;
50
51 /* Async result callback:
52 On success: addresses is the result, and the callee must call
53 grpc_resolved_addresses_destroy when it's done with them
54 On failure: addresses is NULL */
55 typedef void (*grpc_resolve_cb)(void *arg, grpc_resolved_addresses *addresses);
56 /* Asynchronously resolve addr. Use default_port if a port isn't designated
57 in addr, otherwise use the port in addr. */
58 /* TODO(ctiller): add a timeout here */
59 void grpc_resolve_address(const char *addr, const char *default_port,
60 grpc_resolve_cb cb, void *arg);
61 /* Destroy resolved addresses */
62 void grpc_resolved_addresses_destroy(grpc_resolved_addresses *addresses);
63
64 /* Resolve addr in a blocking fashion. Returns NULL on failure. On success,
65 result must be freed with grpc_resolved_addresses_destroy. */
66 grpc_resolved_addresses *grpc_blocking_resolve_address(
67 const char *addr, const char *default_port);
68
69 #endif /* GRPC_INTERNAL_CORE_IOMGR_RESOLVE_ADDRESS_H */
grpc_blocking_resolve_address
grpc_resolved_addresses * grpc_blocking_resolve_address(const char *addr, const char *default_port)
grpc_resolved_address
Definition: resolve_address.h:41
grpc_resolve_cb
void(* grpc_resolve_cb)(void *arg, grpc_resolved_addresses *addresses)
Definition: resolve_address.h:55
grpc_resolved_addresses
Definition: resolve_address.h:46
arg
Definition: cmdline.c:47
grpc_resolved_addresses::addrs
grpc_resolved_address * addrs
Definition: resolve_address.h:48
grpc_resolved_address::len
int len
Definition: resolve_address.h:43
grpc_resolve_address
void grpc_resolve_address(const char *addr, const char *default_port, grpc_resolve_cb cb, void *arg)
arg
struct arg arg
grpc_resolved_addresses::naddrs
size_t naddrs
Definition: resolve_address.h:47
GRPC_MAX_SOCKADDR_SIZE
#define GRPC_MAX_SOCKADDR_SIZE
Definition: resolve_address.h:39
grpc_resolved_addresses_destroy
void grpc_resolved_addresses_destroy(grpc_resolved_addresses *addresses)