tdb2: copy tdb1's changed expansion logic.
[ccan] / ccan / net / net.h
1 /* Licensed under BSD-MIT - see LICENSE file for details */
2 #ifndef CCAN_NET_H
3 #define CCAN_NET_H
4 /**
5  * net_client_lookup - look up a network name to connect to.
6  * @hostname: the name to look up
7  * @service: the service to look up
8  * @family: Usually AF_UNSPEC, otherwise AF_INET or AF_INET6.
9  * @socktype: SOCK_DGRAM or SOCK_STREAM.
10  *
11  * This will do a synchronous lookup of a given name, returning a linked list
12  * of results, or NULL on error.  You should use freeaddrinfo() to free it.
13  *
14  * Example:
15  *      #include <sys/types.h>
16  *      #include <sys/socket.h>
17  *      #include <stdio.h>
18  *      #include <netdb.h>
19  *      #include <err.h>
20  *      ...
21  *      struct addrinfo *addr;
22  *
23  *      // Get a TCP connection to ccan.ozlabs.org daytime port.
24  *      addr = net_client_lookup("ccan.ozlabs.org", "daytime",
25  *                               AF_UNSPEC, SOCK_STREAM);
26  *      if (!addr)
27  *              errx(1, "Failed to look up daytime at ccan.ozlabs.org");
28  */
29 struct addrinfo *net_client_lookup(const char *hostname,
30                                    const char *service,
31                                    int family,
32                                    int socktype);
33
34 /**
35  * net_connect - connect to a server
36  * @addrinfo: linked list struct addrinfo (usually from net_client_lookup).
37  *
38  * This synchronously connects to a server described by @addrinfo, or returns
39  * -1 on error (and sets errno).
40  *
41  * Example:
42  *      int fd;
43  *      ...
44  *      fd = net_connect(addr);
45  *      if (fd < 0)
46  *              err(1, "Failed to connect to ccan.ozlabs.org");
47  *      freeaddrinfo(addr);
48  */
49 int net_connect(const struct addrinfo *addrinfo);
50 #endif /* CCAN_NET_H */