2012-10-25 18:06:28 +00:00
|
|
|
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
|
2012-09-13 10:44:16 +00:00
|
|
|
.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
|
2012-10-25 18:06:28 +00:00
|
|
|
@@ -265,6 +320,19 @@ or
|
2012-09-13 10:44:16 +00:00
|
|
|
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
|
2012-10-25 18:06:28 +00:00
|
|
|
@@ -293,6 +361,45 @@ When this flag is enabled the values set
|
2012-09-13 10:44:16 +00:00
|
|
|
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
|
2012-10-25 18:06:28 +00:00
|
|
|
@@ -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
|
2012-09-13 10:44:16 +00:00
|
|
|
.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
|
2012-10-25 18:06:28 +00:00
|
|
|
@@ -1005,6 +1133,7 @@ and
|
2012-09-13 10:44:16 +00:00
|
|
|
.BR socket (7).
|
|
|
|
.SH NOTES
|
|
|
|
.BR IP_FREEBIND ,
|
|
|
|
+.BR IP_MSFILTER ,
|
|
|
|
.BR IP_MTU ,
|
|
|
|
.BR IP_MTU_DISCOVER ,
|
|
|
|
.BR IP_RECVORIGDSTADDR ,
|