contrib/libpcap/sockutils.c

89 #define SOCKET_NAME_NULL_DAD "Null address (possibly DAD Phase)"
200  * so that lower-rated errors for a given address in a given family
201  * should not overwrite higher-rated errors for another address in that
208 	SOCK_AFNOTSUPERR,	/* address family not supported */
230 		 * and we're trying the wrong address family.
291 		 * address family if it's not supported), but overwrite
377  * \brief It checks if the sockaddr variable contains a multicast address.
379  * \return '0' if the address is multicast, '-1' if it is not.
404  * Sort by IPv4 address vs. IPv6 address.
416  * within a given error code, by IPv4 address vs. IPv6 address.
543 		 * "any" address, it is, in effect, also bound to the
544 		 * IPv4 "any" address, so when we create an IPv4 socket
545 		 * and try to bind it to the IPv4 "any" address, it gets
579 		/* WARNING: if the address is a mcast one, I should place the proper Win32 code here */
625 			    "There are no addresses in the address list");
653 		 * address/protocol family to use, and IPv4 and IPv6 are
654 		 * separate address/protocol families).
673 			 * different address family, close it.
684 			 * for *this* address's address family.
722 			 * address families within error sets.
782 					 * Get the string for the address
956 			    "%sThe address family for looking up %s was not recognized",
979 			    "%sNo address associated with %s",
1046  * \brief Checks that the address, port and flags given are valids and it returns an 'addrinfo' structure.
1049  * to control that everything is fine (e.g. a TCP socket cannot have a mcast address, and such).
1053  * a host name, a numeric literal address, or NULL or "" (useful
1118 					 * Free up the address info first.
1151 	 * XXX - should we just check that at least *one* address is
1800 				 * If we are here, it means that the current address does not matches
1856  * accept() call), containing the first address to compare.
1858  * \param second: a sockaddr_storage structure containing the second address to compare.
1873 		else /* address family is AF_INET6 */
1886  * \brief It gets the address/port the system picked for this socket (on connected sockets).
1888  * It is used to return the address and port the server picked for our socket on the local machine.
1898  * \param address: it contains the address that will be returned by the function. This buffer
1899  * must be properly allocated by the user. The address can be either literal or numeric depending
1902  * \param addrlen: the length of the 'address' buffer.
1910  * that determine if the resulting address must be in numeric / literal form, and so on.
1920  * The address and port corresponding are returned back in the buffers 'address' and 'port'.
1923  * \warning If the socket is using a connectionless protocol, the address may not be available
1926 int sock_getmyinfo(SOCKET sock, char *address, int addrlen, char *port, int portlen, int flags, char *errbuf, int errbuflen)
1940 	/* Returns the numeric address of the host that triggered the error */
1941 	return sock_getascii_addrport(&mysockaddr, address, addrlen, port, portlen, flags, errbuf, errbuflen);
1945  * \brief It retrieves two strings containing the address and the port of a given 'sockaddr' variable.
1954  * form. So, for instance, it is able to translate an hex address (stored in binary form) into
1955  * a standard IPv6 address like "::1".
1960  * \param sockaddr: a 'sockaddr_in' or 'sockaddr_in6' structure containing the address that
1962  * zero-ed prior using it, and the address family field must be filled with the proper value.
1966  * \param address: it contains the address that will be returned by the function. This buffer
1967  * must be properly allocated by the user. The address can be either literal or numeric depending
1970  * \param addrlen: the length of the 'address' buffer.
1978  * that determine if the resulting address must be in numeric / literal form, and so on.
1988  * The address and port corresponding to the given SockAddr are returned back in the buffers 'address'
1992 int sock_getascii_addrport(const struct sockaddr_storage *sockaddr, char *address, int addrlen, char *port, int portlen, int flags, char *errbuf, size_t errbuflen)
2013 			if (address)
2014 				pcap_strlcpy(address, SOCKET_NAME_NULL_DAD, addrlen);
2019 	if (getnameinfo((struct sockaddr *) sockaddr, sockaddrlen, address, addrlen, port, portlen, flags) != 0)
2029 		if (address)
2031 			pcap_strlcpy(address, SOCKET_NO_NAME_AVAILABLE, addrlen);
2032 			address[addrlen - 1] = 0;
2048  * \brief It translates an address from the 'presentation' form into the 'network' form.
2052  * An additional advantage is that 'Address' can be both a numeric address (e.g. '127.0.0.1',
2057  * \param address: a zero-terminated string which contains the name you have to
2061  * 'network' form of the requested address.
2079  * the content of the SockAddr parameter will be the address corresponding to the first mapping.
2083 int sock_present2network(const char *address, struct sockaddr_storage *sockaddr, int addr_family, char *errbuf, int errbuflen)
2093 	if ((retval = sock_initaddress(address, "22222" /* fake port */, &hints, &addrinfo, errbuf, errbuflen)) == -1)