| Standards / Extensions | C or C++ | Dependencies |
|---|---|---|
| RFC3678 | both | z/OS® V1.9 |
#define _OPEN_SYS_SOCK_EXT3
#include <netinet/in.h>
int setipv4sourcefilter(int s, struct in_addr interface, struct in_addr group,
uint32_t fmode, uint32_t numsrc, struct in_addr *slist);This function allows applications to set and replace the current multicast filtering state for a tuple consisting of socket, interface, and multicast group values.
A multicast filter is described by a filter mode, which is MCAST_INCLUDE or MCAST_EXCLUDE, and a list of source addresses which are filtered.
This function is IPv4-specific, must be used only on AF_INET sockets with an open socket of type SOCK_DGRAM or SOCK_RAW.
If the function is unable to obtain the required storage, control will not return to the caller. Instead the application will terminate due to an out of memory condition (if the reserve stack is available and the caller is not XPLINK), or it will terminate with an abend indicating that storage could not be obtained.
If successful, the function returns 0. Otherwise, it returns -1 and sets errno to one of the following values.