diff -up man-pages-3.43/man7/ip.7.ip man-pages-3.43/man7/ip.7 --- man-pages-3.43/man7/ip.7.ip 2012-10-15 11:13:49.000000000 +0200 +++ man-pages-3.43/man7/ip.7 2012-10-25 19:56:48.499351666 +0200 @@ -256,6 +259,58 @@ Only valid as a .BR setsockopt (2). .\" .TP +.BR IP_ADD_SOURCE_MEMBERSHIP " (since Linux 2.5.68)" +Join a multicast group and allow receiving data only +from a specified source. +Argument is an +.I ip_mreq_source +structure. +.sp +.in +4n +.nf +struct ip_mreq_source { + struct in_addr imr_multiaddr; /* IP multicast group + address */ + struct in_addr imr_interface; /* IP address of local + interface */ + struct in_addr imr_sourceaddr; /* IP address of + multicast source */ +}; +.fi +.in +.sp +.I ip_mreq_source +structure is similar to +.I ip_mreqn +described at +.BR IP_ADD_MEMBERSIP . +.I imr_multiaddr +contains the address of the multicast group the application +wants to join or leave. +.I imr_interface +is the address of the local interface with which +the system should join the multicast group. +Finally +.I imr_sourceaddr +field contains address of the source the +application wants to receive data from. +.IP +This option can be used multiple times to allow +receiving data from more than one source. +.TP +.BR IP_BLOCK_SOURCE " (since Linux 2.5.68)" +Stop receiving multicast data from a specific source in a given +group. This is valid only after the application has subscribed +to the multicast group using either +.BR IP_ADD_MEMBERSHIP +or +.BR IP_ADD_SOURCE_MEMBERSHIP . +.IP +Argument is an +.I ip_mreq_source +structure as described at +.BR IP_ADD_SOURCE_MEMBERSHIP . +.TP .BR IP_DROP_MEMBERSHIP " (since Linux 1.2)" Leave a multicast group. Argument is an @@ -265,6 +320,19 @@ or structure similar to .BR IP_ADD_MEMBERSHIP . .TP +.BR IP_DROP_SOURCE_MEMBERSHIP " (since Linux 2.5.68)" +Leave a source-specific group, i.e., stop receiving data from +a given multicast group that come from a given source). +If the application has subscribed to multiple sources within +the same group, data from the remaining sources will still be +delivered. To stop receiving data from all sources at once use +.BR IP_LEAVE_GROUP . +.IP +Argument is an +.I ip_mreq_source +structure as described at +.BR IP_ADD_SOURCE_MEMBERSHIP . +.TP .BR IP_FREEBIND " (since Linux 2.4)" .\" Precisely: 2.4.0-test10 If enabled, this boolean option allows binding to an IP address @@ -293,6 +361,45 @@ When this flag is enabled the values set and .B IP_TOS are ignored. +.TP +.BR IP_MSFILTER " (since Linux 2.5.68)" +This option provides access to the advanced full-state filtering API. +Argument is an +.I ip_msfilter +structure. +.sp +.in +4n +.nf +struct ip_msfilter { + struct in_addr imsf_multiaddr; /* IP multicast group + address */ + struct in_addr imsf_interface; /* IP address of local + interface */ + uint32_t imsf_fmode; /* Filter-mode */ + + uint32_t imsf_numsrc; /* Number of sources in + the following array */ + struct in_addr imsf_slist[1]; /* Array of source + addresses */ +}; +.fi +.in +.sp +There are two macros, +.BR MCAST_INCLUDE +and +.BR MCAST_EXCLUDE , +which can be used to specify the filtering mode. +Additionaly, +.BR IP_MSFILTER_SIZE (n) +macro exists to determine how much memory is needed to store +.I ip_msfilter +structure with +.I n +sources in the source list. +.IP +For the full description of multicast source filtering +refer to RFC 3376. .\" .\" FIXME Document IP_IPSEC_POLICY .\" Since Linux 2.5.47 @@ -393,6 +500,17 @@ This is also particularly useful for dia that wish to deliberately send probe packets larger than the observed Path MTU. .TP +.BR IP_MULTICAST_ALL " (since Linux 2.6.31)" +Sets the policy for multicast delivery to the socket. Argument is a boolean +integer that enables or disables multicast delivery from all groups. +If not set, delivery to the socket is restricted to data from those multicast +groups that have been explicitly subscribed to via a multicast join operation +for this socket. The default is 1 which means that a socket which is bound +to the wildcard address +.RB ( INADDR_ANY ) +will receive multicast packets from all +groups that have been subscribed to on this system. +.TP .BR IP_MULTICAST_IF " (since Linux 1.2)" Set the local device for a multicast socket. Argument is an @@ -768,6 +886,16 @@ this option be set on the redirected soc .BR IP_TTL " (since Linux 1.0)" Set or retrieve the current time-to-live field that is used in every packet sent from this socket. +.TP +.BR IP_UNBLOCK_SOURCE " (since Linux 2.5.68)" +Unblock previously blocked multicast source. Returns +.BR EADDRNOTAVAIL +when given source is not being blocked. +.IP +Argument is an +.I ip_mreq_source +structure as described at +.BR IP_ADD_SOURCE_MEMBERSHIP . .\" FIXME Document IP_XFRM_POLICY .\" Since Linux 2.5.48 .\" Needs CAP_NET_ADMIN @@ -1005,6 +1133,7 @@ and .BR socket (7). .SH NOTES .BR IP_FREEBIND , +.BR IP_MSFILTER , .BR IP_MTU , .BR IP_MTU_DISCOVER , .BR IP_RECVORIGDSTADDR ,