network.h revision d198989a7cac917ba0bd341a76d94e8a32267074
d23c747de9d33966483fbdd41f08ad7766da7c5cTimo Sirainen unsigned short family;
b039dabf4c53f72454e795930e7643b6e0e625f9Timo Sirainen/* maxmimum string length of IP address */
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen#define IPADDR_IS_V4(ip) ((ip)->family == AF_INET)
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen#define IPADDR_IS_V6(ip) ((ip)->family == AF_INET6)
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* returns 1 if IPADDRs are the same */
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainenbool net_ip_compare(const struct ip_addr *ip1, const struct ip_addr *ip2);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenunsigned int net_ip_hash(const struct ip_addr *ip);
8e371a3ce32bd64288786855b8ce0cb63f19f7d1Timo Sirainen/* Connect to socket with ip address */
8e371a3ce32bd64288786855b8ce0cb63f19f7d1Timo Sirainenint net_connect_ip(const struct ip_addr *ip, unsigned int port,
8e371a3ce32bd64288786855b8ce0cb63f19f7d1Timo Sirainen/* Connect to named UNIX socket */
d23c747de9d33966483fbdd41f08ad7766da7c5cTimo Sirainen/* Disconnect socket */
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen/* Set socket blocking/nonblocking */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Set TCP_CORK if supported, ie. don't send out partial frames.
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen Returns 0 if ok, -1 if failed. */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Set IP to contain INADDR_ANY for IPv4 or IPv6. The IPv6 any address may
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen include IPv4 depending on the system (Linux yes, BSD no). */
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen/* Listen for connections on a socket */
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainenint net_listen(const struct ip_addr *my_ip, unsigned int *port, int backlog);
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen/* Listen for connections on an UNIX socket */
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainenint net_listen_unix(const char *path, int backlog);
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen/* Like net_listen_unix(), but if socket already exists, try to connect to it.
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen If it fails with ECONNREFUSED, unlink the socket and try creating it
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainenint net_listen_unix_unlink_stale(const char *path, int backlog);
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainen/* Accept a connection on a socket. Returns -1 if the connection got closed,
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen -2 for other failures */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenint net_accept(int fd, struct ip_addr *addr, unsigned int *port);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Read data from socket, return number of bytes read,
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen -1 = error, -2 = disconnected */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenssize_t net_receive(int fd, void *buf, size_t len);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Transmit data, return number of bytes sent, -1 = error, -2 = disconnected */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenssize_t net_transmit(int fd, const void *data, size_t len);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Get IP addresses for host. ips contains ips_count of IPs, they don't need
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen to be free'd. Returns 0 = ok, others = error code for net_gethosterror() */
8e371a3ce32bd64288786855b8ce0cb63f19f7d1Timo Sirainenint net_gethostbyname(const char *addr, struct ip_addr **ips,
d23c747de9d33966483fbdd41f08ad7766da7c5cTimo Sirainen unsigned int *ips_count);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* get error of net_gethostname() */
8e371a3ce32bd64288786855b8ce0cb63f19f7d1Timo Sirainenconst char *net_gethosterror(int error) ATTR_CONST;
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* return TRUE if host lookup failed because it didn't exist (ie. not
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen some error with name server) */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenint net_hosterror_notfound(int error) ATTR_CONST;
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Get socket local address/port */
f70a4526fa8eaf5faafca01800faf590a4eaedb0Timo Sirainenint net_getsockname(int fd, struct ip_addr *addr, unsigned int *port);
4d2211dac61c615c5bdfd501ea54d46c89d41b0fTimo Sirainen/* Get socket remote address/port */
4d2211dac61c615c5bdfd501ea54d46c89d41b0fTimo Sirainenint net_getpeername(int fd, struct ip_addr *addr, unsigned int *port);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Returns ip_addr as string, or NULL if ip is invalid. */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenconst char *net_ip2addr(const struct ip_addr *ip);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* char* -> struct ip_addr translation. */
12ea3aeeb61df84632f04f86f47902a3750d61f8Timo Sirainenint net_addr2ip(const char *addr, struct ip_addr *ip);
12ea3aeeb61df84632f04f86f47902a3750d61f8Timo Sirainen/* Convert IPv6 mapped IPv4 address to an actual IPv4 address. Returns 0 if
12ea3aeeb61df84632f04f86f47902a3750d61f8Timo Sirainen successful, -1 if the source address isn't IPv6 mapped IPv4 address. */
63f36c2b47217fc2dc4ed49cfc1907311d5ed366Timo Sirainenint net_ipv6_mapped_ipv4_convert(const struct ip_addr *src,
4d2211dac61c615c5bdfd501ea54d46c89d41b0fTimo Sirainen/* Get socket error */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Get name of TCP service */
bd7b1a9000b12349e2a99bb43b3ce8b96a18e92bTimo Sirainenconst char *net_getservbyport(unsigned short port) ATTR_CONST;
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenbool is_ipv4_address(const char *addr) ATTR_PURE;
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenbool is_ipv6_address(const char *addr) ATTR_PURE;
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Parse network as ip/bits. Returns 0 if successful, -1 if invalid input. */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenint net_parse_range(const char *network, struct ip_addr *ip_r,
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen unsigned int *bits_r);
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen/* Returns TRUE if ip is in net_ip/bits network. IPv6 mapped IPv4 addresses
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen are converted to plain IPv4 addresses before matching. */
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainenbool net_is_in_network(const struct ip_addr *ip, const struct ip_addr *net_ip,