so-bindtodevice in doc, minor corrections in doc

This commit is contained in:
Gerhard Rieger 2009-05-06 08:34:02 +02:00
parent 7c2039ada8
commit c5201ee1f5
3 changed files with 19 additions and 10 deletions

View file

@ -1,4 +1,10 @@
corrections:
docu mentions option so-bindtodev but correct name is so-bindtodevice.
Thanks to Jim Zimmerman for reporting.
minor corrections in doc
####################### V 1.7.1.0: ####################### V 1.7.1.0:
new features: new features:

View file

@ -216,12 +216,14 @@ When you receive an error like:</p>
<table border="1" bgcolor="#e08080"><tr><td><tt>... E sendto(3, 0x80c2e44, 4, <table border="1" bgcolor="#e08080"><tr><td><tt>... E sendto(3, 0x80c2e44, 4,
0, AF=2 224.1.0.1:6666, 16): Network is unreachable</tt></td></tr></table> 0, AF=2 224.1.0.1:6666, 16): Network is unreachable</tt></td></tr></table>
<p>you have a routing problem. The (Linux) IP stack seems to handle multicast <p>you have a routing problem. The (Linux) IP stack seems to handle multicast
addresses just like unicast addresses when determining their route (interface and gateway).</p> addresses just like unicast addresses when determining their route (interface
and gateway), i.e. the routing table needs an entry that somehow matches the
target address. </p>
<p> <p>
For the same reason, multicast packets will probably leave your host on the For the same reason, multicast packets will probably leave your host on the
interface with the default route.</p> interface with the default route if it is specified.</p>
<p> <p>
Set a multicast/broadcast route with the following command:</p> Set a multicast/broadcast route with the following command (Linux):</p>
<span class="frame"><span class="shell"> <span class="frame"><span class="shell">
route add -net 224.0.0.0/3 gw 192.168.10.2 route add -net 224.0.0.0/3 gw 192.168.10.2
</span></span> </span></span>
@ -231,7 +233,8 @@ route add -net 224.0.0.0/3 gw 192.168.10.2
<p> <p>
<tt>224.0.0.1</tt></a> is the all-systems multicast address: all <tt>224.0.0.1</tt></a> is the all-systems multicast address: all
datagram sockets appear to be automatically member of this group on all datagram sockets appear to be automatically member of this group on all
interfaces. This membership cannot be dropped on Linux. interfaces. This membership cannot be dropped on Linux (you need iptables to
filter packets).
</p> </p>
@ -240,11 +243,11 @@ interfaces. This membership cannot be dropped on Linux.
<p>When you use the above examples you should understand that all datagram <p>When you use the above examples you should understand that all datagram
sockets without exception accept all packets that are directly addressed to sockets without exception accept all packets that are directly addressed to
them; them;
the multi- and broadcast receiving features are just extensions to the normal the multi- and broadcast receiving features are just extensions to this
functionality. socat currently has no means to handle incoming packets functionality. socat currently has no means to handle incoming packets
differently when it is addressed to a unicast, multicast, or broadcast differently whether they are addressed to unicast, multicast, or broadcast
address. However, for EXEC'd scripts socat can provide this info in environment addresses. However, for EXEC'd scripts socat can provide this info in
variables. environment variables.
</p> </p>
<p>Authentication or encryption are not available.</p> <p>Authentication or encryption are not available.</p>

View file

@ -10,7 +10,7 @@ def(Filan)(0)(bf(Filan))
def(procan)(0)(bf(procan)) def(procan)(0)(bf(procan))
def(Procan)(0)(bf(Procan)) def(Procan)(0)(bf(Procan))
manpage(socat)(1)(Apr 2009)()() manpage(socat)(1)(May 2009)()()
whenhtml( whenhtml(
label(CONTENTS) label(CONTENTS)
@ -1791,7 +1791,7 @@ label(OPTION_BIND)dit(bf(tt(bind=<sockname>)))
label(OPTION_CONNECT_TIMEOUT)dit(bf(tt(connect-timeout=<seconds>))) label(OPTION_CONNECT_TIMEOUT)dit(bf(tt(connect-timeout=<seconds>)))
Abort the connection attempt after <seconds> [link(timeval)(TYPE_TIMEVAL)] Abort the connection attempt after <seconds> [link(timeval)(TYPE_TIMEVAL)]
with error status. with error status.
label(OPTION_SO_BINDTODEV)dit(bf(tt(so-bindtodev=<interface>))) label(OPTION_SO_BINDTODEVICE)dit(bf(tt(so-bindtodevice=<interface>)))
Binds the socket to the given link(<interface>)(TYPE_INTERFACE). Binds the socket to the given link(<interface>)(TYPE_INTERFACE).
This option might require root privilege. This option might require root privilege.
label(OPTION_SO_BROADCAST)dit(bf(tt(broadcast))) label(OPTION_SO_BROADCAST)dit(bf(tt(broadcast)))