| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | #ifndef _ASM_SOCKET_H
 | 
					
						
							|  |  |  | #define _ASM_SOCKET_H
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #include <asm/sockios.h>
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* For setsockopt(2) */ | 
					
						
							|  |  |  | /*
 | 
					
						
							|  |  |  |  * Note: we only bother about making the SOL_SOCKET options | 
					
						
							|  |  |  |  * same as OSF/1, as that's all that "normal" programs are | 
					
						
							|  |  |  |  * likely to set.  We don't necessarily want to be binary | 
					
						
							|  |  |  |  * compatible with _everything_.  | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | #define SOL_SOCKET	0xffff
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define SO_DEBUG	0x0001
 | 
					
						
							|  |  |  | #define SO_REUSEADDR	0x0004
 | 
					
						
							|  |  |  | #define SO_KEEPALIVE	0x0008
 | 
					
						
							|  |  |  | #define SO_DONTROUTE	0x0010
 | 
					
						
							|  |  |  | #define SO_BROADCAST	0x0020
 | 
					
						
							|  |  |  | #define SO_LINGER	0x0080
 | 
					
						
							|  |  |  | #define SO_OOBINLINE	0x0100
 | 
					
						
							|  |  |  | /* To add :#define SO_REUSEPORT 0x0200 */ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define SO_TYPE		0x1008
 | 
					
						
							|  |  |  | #define SO_ERROR	0x1007
 | 
					
						
							|  |  |  | #define SO_SNDBUF	0x1001
 | 
					
						
							|  |  |  | #define SO_RCVBUF	0x1002
 | 
					
						
							| 
									
										
										
										
											2005-08-09 19:30:51 -07:00
										 |  |  | #define SO_SNDBUFFORCE	0x100a
 | 
					
						
							|  |  |  | #define SO_RCVBUFFORCE	0x100b
 | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | #define	SO_RCVLOWAT	0x1010
 | 
					
						
							|  |  |  | #define	SO_SNDLOWAT	0x1011
 | 
					
						
							|  |  |  | #define	SO_RCVTIMEO	0x1012
 | 
					
						
							|  |  |  | #define	SO_SNDTIMEO	0x1013
 | 
					
						
							|  |  |  | #define SO_ACCEPTCONN	0x1014
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* linux-specific, might as well be the same as on i386 */ | 
					
						
							|  |  |  | #define SO_NO_CHECK	11
 | 
					
						
							|  |  |  | #define SO_PRIORITY	12
 | 
					
						
							|  |  |  | #define SO_BSDCOMPAT	14
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define SO_PASSCRED	17
 | 
					
						
							|  |  |  | #define SO_PEERCRED	18
 | 
					
						
							|  |  |  | #define SO_BINDTODEVICE 25
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* Socket filtering */ | 
					
						
							|  |  |  | #define SO_ATTACH_FILTER        26
 | 
					
						
							|  |  |  | #define SO_DETACH_FILTER        27
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define SO_PEERNAME		28
 | 
					
						
							|  |  |  | #define SO_TIMESTAMP		29
 | 
					
						
							|  |  |  | #define SCM_TIMESTAMP		SO_TIMESTAMP
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define SO_PEERSEC		30
 | 
					
						
							| 
									
										
											  
											
												[AF_UNIX]: Datagram getpeersec
This patch implements an API whereby an application can determine the
label of its peer's Unix datagram sockets via the auxiliary data mechanism of
recvmsg.
Patch purpose:
This patch enables a security-aware application to retrieve the
security context of the peer of a Unix datagram socket.  The application
can then use this security context to determine the security context for
processing on behalf of the peer who sent the packet.
Patch design and implementation:
The design and implementation is very similar to the UDP case for INET
sockets.  Basically we build upon the existing Unix domain socket API for
retrieving user credentials.  Linux offers the API for obtaining user
credentials via ancillary messages (i.e., out of band/control messages
that are bundled together with a normal message).  To retrieve the security
context, the application first indicates to the kernel such desire by
setting the SO_PASSSEC option via getsockopt.  Then the application
retrieves the security context using the auxiliary data mechanism.
An example server application for Unix datagram socket should look like this:
toggle = 1;
toggle_len = sizeof(toggle);
setsockopt(sockfd, SOL_SOCKET, SO_PASSSEC, &toggle, &toggle_len);
recvmsg(sockfd, &msg_hdr, 0);
if (msg_hdr.msg_controllen > sizeof(struct cmsghdr)) {
    cmsg_hdr = CMSG_FIRSTHDR(&msg_hdr);
    if (cmsg_hdr->cmsg_len <= CMSG_LEN(sizeof(scontext)) &&
        cmsg_hdr->cmsg_level == SOL_SOCKET &&
        cmsg_hdr->cmsg_type == SCM_SECURITY) {
        memcpy(&scontext, CMSG_DATA(cmsg_hdr), sizeof(scontext));
    }
}
sock_setsockopt is enhanced with a new socket option SOCK_PASSSEC to allow
a server socket to receive security context of the peer.
Testing:
We have tested the patch by setting up Unix datagram client and server
applications.  We verified that the server can retrieve the security context
using the auxiliary data mechanism of recvmsg.
Signed-off-by: Catherine Zhang <cxzhang@watson.ibm.com>
Acked-by: Acked-by: James Morris <jmorris@namei.org>
Signed-off-by: David S. Miller <davem@davemloft.net>
											
										 
											2006-06-29 12:27:47 -07:00
										 |  |  | #define SO_PASSSEC		34
 | 
					
						
							| 
									
										
										
										
											2007-03-25 22:14:49 -07:00
										 |  |  | #define SO_TIMESTAMPNS		35
 | 
					
						
							|  |  |  | #define SCM_TIMESTAMPNS		SO_TIMESTAMPNS
 | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | /* Security levels - as per NRL IPv6 - don't actually do anything */ | 
					
						
							|  |  |  | #define SO_SECURITY_AUTHENTICATION		19
 | 
					
						
							|  |  |  | #define SO_SECURITY_ENCRYPTION_TRANSPORT	20
 | 
					
						
							|  |  |  | #define SO_SECURITY_ENCRYPTION_NETWORK		21
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-01-30 19:08:16 -08:00
										 |  |  | #define SO_MARK			36
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | #endif /* _ASM_SOCKET_H */
 |