FreeBSD Manual Pages
IPADDR_LOCAL(3) libdill Library Functions IPADDR_LOCAL(3) NAME ipaddr_local - resolve the address of a local network interface SYNOPSIS #include <libdill.h> int ipaddr_local( struct ipaddr* addr, const char* name, int port, int mode); DESCRIPTION Converts an IP address in human-readable format, or a name of a local network interface into an ipaddr structure. Mode specifies which kind of addresses should be returned. Possible values are: • IPADDR_IPV4: Get IPv4 address. • IPADDR_IPV6: Get IPv6 address. • IPADDR_PREF_IPV4: Get IPv4 address if possible, IPv6 address other- wise. • IPADDR_PREF_IPV6: Get IPv6 address if possible, IPv4 address other- wise. Setting the argument to zero invokes default behaviour, which, at the present, is IPADDR_PREF_IPV4. However, in the future when IPv6 becomes more common it may be switched to IPADDR_PREF_IPV6. addr: Out parameter, The IP address object. name: Name of the local network interface, such as "eth0", "192.168.0.111" or "::1". port: Port number. Valid values are 1-65535. mode: What kind of address to return. See above. This function is not available if libdill is compiled with --dis- able-sockets option. RETURN VALUE In case of success the function returns 0. In case of error it returns -1 and sets errno to one of the values below. ERRORS • ENODEV: Local network interface with the specified name does not ex- ist. EXAMPLE struct ipaddr addr; ipaddr_local(&addr, "eth0", 5555, 0); int s = socket(ipaddr_family(addr), SOCK_STREAM, 0); bind(s, ipaddr_sockaddr(&addr), ipaddr_len(&addr)); SEE ALSO ipaddr_equal(3) ipaddr_family(3) ipaddr_len(3) ipaddr_port(3) ipad- dr_remote(3) ipaddr_remotes(3) ipaddr_setport(3) ipaddr_sockaddr(3) ipaddr_str(3) libdill IPADDR_LOCAL(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ipaddr_local&sektion=3&manpath=FreeBSD+Ports+15.0>