1 /* Licensed under BSD-MIT - see LICENSE file for details */
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.
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.
15 * #include <sys/types.h>
16 * #include <sys/socket.h>
21 * struct addrinfo *addr;
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);
27 * errx(1, "Failed to look up daytime at ccan.ozlabs.org");
29 struct addrinfo *net_client_lookup(const char *hostname,
35 * net_connect - connect to a server
36 * @addrinfo: linked list struct addrinfo (usually from net_client_lookup).
38 * This synchronously connects to a server described by @addrinfo, or returns
39 * -1 on error (and sets errno).
44 * fd = net_connect(addr);
46 * err(1, "Failed to connect to ccan.ozlabs.org");
49 int net_connect(const struct addrinfo *addrinfo);
50 #endif /* CCAN_NET_H */