GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
IPADDR_LOCAL(3) libdill Library Functions IPADDR_LOCAL(3)

ipaddr_local - resolve the address of a local network interface


#include <libdill.h>
int ipaddr_local(
    struct ipaddr* addr,
    const char* name,
    int port,
    int mode);

    

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 otherwise.
IPADDR_PREF_IPV6: Get IPv6 address if possible, IPv4 address otherwise.

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 --disable-sockets option.

In case of success the function returns 0. In case of error it returns -1 and sets errno to one of the values below.

ENODEV: Local network interface with the specified name does not exist.


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));

    

ipaddr_equal(3) ipaddr_family(3) ipaddr_len(3) ipaddr_port(3) ipaddr_remote(3) ipaddr_remotes(3) ipaddr_setport(3) ipaddr_sockaddr(3) ipaddr_str(3)
libdill

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.