Module Name: src Committed By: mbalmer Date: Sat Jan 9 09:19:19 UTC 2010
Modified Files: src/share/man/man4: faith.4 Log Message: Various language fixes. From FreeBSD. To generate a diff of this commit: cvs rdiff -u -r1.10 -r1.11 src/share/man/man4/faith.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/share/man/man4/faith.4 diff -u src/share/man/man4/faith.4:1.10 src/share/man/man4/faith.4:1.11 --- src/share/man/man4/faith.4:1.10 Sun Sep 7 16:22:27 2003 +++ src/share/man/man4/faith.4 Sat Jan 9 09:19:18 2010 @@ -1,4 +1,4 @@ -.\" $NetBSD: faith.4,v 1.10 2003/09/07 16:22:27 wiz Exp $ +.\" $NetBSD: faith.4,v 1.11 2010/01/09 09:19:18 mbalmer Exp $ .\" $KAME: faith.4,v 1.10 2001/06/30 00:42:48 itojun Exp $ .\" .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. @@ -53,15 +53,15 @@ subcommands. .Pp Special action will be taken when IPv6 TCP traffic is seen on a router, -and routing table suggests to route it to +and the routing table suggests to route it to the .Nm interface. In this case, the packet will be accepted by the router, -regardless of list of IPv6 interface addresses assigned to the router. -The packet will be captured by an IPv6 TCP socket, if it has +regardless of the list of IPv6 interface addresses assigned to the router. +The packet will be captured by an IPv6 TCP socket, if it has the .Dv IN6P_FAITH -flag turned on and it has matching address/port pairs. -In result, +flag turned on and matching address/port pairs. +As a result, .Nm will let you capture IPv6 TCP traffic to some specific destination addresses. Userland programs, such as @@ -73,43 +73,42 @@ and perform application-specific address mapping to relay IPv6 TCP to IPv4 TCP. .Pp .Dv IN6P_FAITH -flag on IPv6 TCP socket can be set by using +flag on a IPv6 TCP socket can be set by using .Xr setsockopt 2 , -with level equals to +with level .Dv IPPROTO_IPV6 -and optname equals to +and optname .Dv IPv6_FAITH . .Pp -To handle error reports by ICMPv6, some of ICMPv6 packets routed to +To handle error reports by ICMPv6, some ICMPv6 packets routed to an .Nm interface will be delivered to IPv6 TCP, as well. .Pp To understand how .Nm -can be used, take a look at source code of +can be used, take a look at the source code of .Xr faithd 8 . .Pp -As +As the .Nm -interface implements potentially dangerous operation, -great care must be taken when configuring -.Nm -interface. -To avoid possible misuse, +interface implements potentially dangerous operations, +great care must be taken when configuring it. +To avoid possible misuse, the .Xr sysctl 8 variable .Li net.inet6.ip6.keepfaith must be set to .Li 1 -prior to the use of the interface. +prior to using the interface. When .Li net.inet6.ip6.keepfaith is .Li 0 , -no packet will be captured by +no packets will be captured by the .Nm interface. .Pp +The .Nm interface is intended to be used on routers, not on hosts. .\" @@ -126,5 +125,5 @@ .%D June 2001 .Re .Sh HISTORY -The FAITH IPv6-to-IPv4 TCP relay translator was first appeared in +The FAITH IPv6-to-IPv4 TCP relay translator first appeared in the WIDE hydrangea IPv6 stack.