X-Git-Url: http://git.ozlabs.org/?a=blobdiff_plain;f=ccan%2Fnet%2F_info;h=cfa58f842830fd07ce4c89effa95e203e4248234;hb=3c65e082a9547992222a9f379f2484cceaaedfa8;hp=0b38c440061fd77776091e8813c26e10f14c4937;hpb=04a42d50a02645aca83d7dc02d8e9838540e818d;p=ccan

diff --git a/ccan/net/_info b/ccan/net/_info
index 0b38c440..cfa58f84 100644
--- a/ccan/net/_info
+++ b/ccan/net/_info
@@ -1,10 +1,13 @@
-#include <string.h>
 #include "config.h"
+#include <stdio.h>
+#include <string.h>
 
 /**
- * net - simple IPv4/IPv6 client library
+ * net - simple IPv4/IPv6 socket library
  *
- * This code makes it simple to support IPv4 and IPv6 without speed penalty.
+ * This code makes it simple to support IPv4 and IPv6 without speed penalty
+ * in clients by using non-blocking simultaneous connect, and using
+ * a convenience function to create both IPv4 and IPv6 sockets for servers.
  *
  * License: MIT
  *
@@ -12,8 +15,7 @@
  *
  * Example:
  *	#include <ccan/net/net.h>
- *	#include <sys/types.h>
- *	#include <sys/socket.h>
+ *	#include <netinet/in.h>
  *	#include <stdio.h>
  *	#include <err.h>
  *
@@ -22,8 +24,12 @@
  *		struct addrinfo *addr;
  *		const char *dest, *port;
  *		int fd;
- *		struct sockaddr saddr;
- *		socklen_t slen = sizeof(saddr);
+ *		union {
+ *			struct sockaddr s;
+ *			struct sockaddr_in v4;
+ *			struct sockaddr_in6 v6;
+ *		} u;
+ *		socklen_t slen = sizeof(u);
  *	
  *		if (argc == 2) {
  *			dest = argv[1];
@@ -41,11 +47,12 @@
  *		fd = net_connect(addr);
  *		if (fd < 0)
  *			err(1, "Failed to connect to %s", dest);
+ *		freeaddrinfo(addr);
  *	
- *		if (getsockname(fd, &saddr, &slen) == 0)
+ *		if (getsockname(fd, &u.s, &slen) == 0)
  *			printf("Connected via %s\n",
- *			       saddr.sa_family == AF_INET6 ? "IPv6"
- *			       : saddr.sa_family == AF_INET ? "IPv4"
+ *			       u.s.sa_family == AF_INET6 ? "IPv6"
+ *			       : u.s.sa_family == AF_INET ? "IPv4"
  *			       : "UNKNOWN??");
  *		else
  *			err(1, "Failed to get socket type for connection");