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


Manual Reference Pages  -  GETIFMADDRS (3)

NAME

getifmaddrs - get multicast group memberships

CONTENTS

Synopsis
Description
Return Values
Errors
See Also
History
Bugs

SYNOPSIS


.In ifaddrs.h int getifmaddrs struct ifmaddrs **ifmap void freeifmaddrs struct ifmaddrs *ifmp

DESCRIPTION

The getifmaddrs function stores a reference to a linked list of the multicast memberships on the local machine in the memory referenced by ifmap. The list consists of
.Vt ifmaddrs structures, as defined in the include file
.In ifaddrs.h . The
.Vt ifmaddrs structure contains at least the following entries:
    struct ifmaddrs   *ifma_next;     /* Pointer to next struct */
    struct sockaddr   *ifma_name;     /* Interface name (AF_LINK) */
    struct sockaddr   *ifma_addr;     /* Multicast address */
    struct sockaddr   *ifma_lladdr;   /* Link-layer translation, if any */

The ifma_next field contains a pointer to the next structure on the list. This field is NULL in last structure on the list.

The ifma_name field references an AF_LINK address structure, containing the name of the interface where the membership exists.

The ifma_addr references the address that this membership is for.

The ifma_lladdr field references a link-layer translation for the protocol-level address in ifma_addr, if one is set, otherwise it is NULL.

The data returned by getifmaddrs is dynamically allocated and should be freed using freeifmaddrs when no longer needed.

RETURN VALUES


.Rv -std getifmaddrs

ERRORS

The getifmaddrs may fail and set errno for any of the errors specified for the library routines malloc(3) or sysctl(3).

SEE ALSO

sysctl(3), networking(4), ifconfig(8)

HISTORY

The getifmaddrs function first appeared in
.Fx 5.2 .

BUGS

If both
.In net/if.h and
.In ifaddrs.h are being included,
.In net/if.h must be included before
.In ifaddrs.h .
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 manServer 1.07.