kernel_optimize_test/include
Catherine Zhang 877ce7c1b3 [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 16:58:06 -07:00
..
acpi Merge branch 'release' of git://git.kernel.org/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6 2006-06-23 07:52:36 -07:00
asm-alpha [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-arm [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-arm26 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-cris [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-frv [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-generic [PATCH] Add EXPORT_UNUSED_SYMBOL and EXPORT_UNUSED_SYMBOL_GPL 2006-06-28 14:59:04 -07:00
asm-h8300 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-i386 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-ia64 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-m32r [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-m68k [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-m68knommu [PATCH] m68knommu: fix clobber list in uCdimm/uCsimm helper asm 2006-06-28 15:03:47 -07:00
asm-mips [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-parisc [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-powerpc [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-ppc Merge git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/devfs-2.6 2006-06-29 14:19:21 -07:00
asm-s390 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-sh [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-sh64 [PATCH] genirq: add ->retrigger() irq op to consolidate hw_irq_resend() 2006-06-29 10:26:23 -07:00
asm-sparc [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-sparc64 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-um [PATCH] genirq: add ->retrigger() irq op to consolidate hw_irq_resend() 2006-06-29 10:26:23 -07:00
asm-v850 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-x86_64 [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
asm-xtensa [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
keys [PATCH] keys: discard the contents of a key on revocation 2006-06-26 09:58:18 -07:00
linux [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
math-emu
media Merge git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/devfs-2.6 2006-06-29 14:19:21 -07:00
mtd Merge git://git.infradead.org/hdrcleanup-2.6 2006-06-20 15:10:08 -07:00
net [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
pcmcia Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
rdma IB/uverbs: Don't serialize with ib_uverbs_idr_mutex 2006-06-17 20:44:49 -07:00
rxrpc
scsi Merge branch 'master' into upstream 2006-06-22 22:11:56 -04:00
sound [ALSA] ak4xxx-adda - Code clean-up 2006-06-28 19:31:09 +02:00
video Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00