netdev - Re: Documentation for IP

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <1228828648.7631.75.camel@bzorp.balabit>
Date:	Tue, 09 Dec 2008 14:17:28 +0100
From:	Balazs Scheidler <bazsi@...abit.hu>
To:	mtk.manpages@...il.com
Cc:	KOVACS Krisztian <hidden@....bme.hu>,
	David Miller <davem@...emloft.net>, linux-net@...r.kernel.org,
	netdev <netdev@...r.kernel.org>
Subject: Re: Documentation for IP_TRANSPARENT?

Hi,

On Mon, 2008-11-24 at 11:06 -0500, Michael Kerrisk wrote:
> Hello Krisztian,
> 
> Your 2.6.27 patch adds  the IP_TRANSPARENT socket option.  Could you
> please supply some documentation (plain text is fine) suitable for
> inclusion in the ip(7) man page.

Although it was Krisztian who originally submitted the patches, but I
also did some things about them, so here I gave the documentation part a
spin. 

There are some other related options, that are undocumented right now,
so I tried to give documentation on those as well.

IP_FREEBIND
	Enable binding to IP addresses that do not currently exist. When 
	enabled on a TCP or UDP socket, the bind(2) call referencing a 
	non-existing IP address will succeed. This functionality is useful 
	if the specified IP address is dynamic (e.g. assigned to a PPP device) 
	and is down at the time when the application is trying to bind to it. 
	This setsockopt is the per-socket equivalent to ip_nonlocal_bind sysctl.

IP_TRANSPARENT
	Enable transparent proxying on this socket. This socket option allows 
	the calling application to bind to a non-local IP address and operate
	both as a client and a server with the foreign address as the local 
	endpoint. NOTE: this requires that routing be set up in a way that 
	packets going to the foreign address are routed through the tproxy box. 
	Enabling this socket option requires superuser privileges 
	(more specifically the CAP_NET_ADMIN capability).

	TProxy redirection with the iptables TPROXY target also requires that
	this option be set on the redirected socket.

IP_RECVORIGDSTADDR
	Enables the IP_ORIGDSTADDR ancillary message in recvmsg(2) in which 
	the kernel returns the original destination address of a datagram. The 
	ancillary message contains a "struct sockaddr_in" instance.

-- 
Bazsi


--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html