linux/include/asm-sparc
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
..
a.out.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
apc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
asi.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
asmmacro.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
atomic.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
auxio.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
auxvec.h [PATCH] auxiliary vector cleanups 2005-09-07 16:57:21 -07:00
bitext.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
bitops.h [PATCH] bitops: sparc: use generic bitops 2006-03-26 08:57:14 -08:00
bpp.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
bsderrno.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
btfixup.h [PATCH] fix the breakage in sparc headers 2005-10-05 07:33:42 -07:00
bug.h [PATCH] remove all kernel BUGs 2005-05-01 08:59:01 -07:00
bugs.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
byteorder.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
cache.h [PATCH] Kill L1_CACHE_SHIFT_MAX 2006-01-08 20:13:39 -08:00
cacheflush.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
checksum.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
clock.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
contregs.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
cpudata.h [SPARC]: Try to start getting SMP back into shape. 2006-03-23 22:36:19 -08:00
cputime.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
current.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
cypress.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
delay.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
div64.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
dma-mapping.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
dma.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
ebus.h [SPARC]: Port of_device layer and make ebus use it. 2006-06-23 23:15:47 -07:00
ecc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
eeprom.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
elf.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
emergency-restart.h [PATCH] Add emergency_restart() 2005-07-26 14:35:41 -07:00
errno.h [PATCH] add EOWNERDEAD and ENOTRECOVERABLE version 2 2005-05-01 08:59:06 -07:00
fbio.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
fcntl.h [PATCH] Clean up struct flock64 definitions 2005-09-07 16:57:38 -07:00
fixmap.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
floppy.h [PATCH] remove some more check_region stuff 2005-10-30 17:37:18 -08:00
futex.h [PATCH] consolidate asm/futex.h 2006-01-08 20:13:39 -08:00
hardirq.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
head.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
highmem.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
hw_irq.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
ide.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
idprom.h [SPARC]: Clean up idprom header files. 2006-03-20 01:12:08 -08:00
io-unit.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
io.h [SPARC]: Add iomap interfaces. 2006-06-25 23:24:24 -07:00
ioctl.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
ioctls.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
iommu.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
ipc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
ipcbuf.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
irq.h [PATCH] adjust handle_IRR_event() return type 2006-06-23 07:43:08 -07:00
jsflash.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
kdebug.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
kgdb.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
kmap_types.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
linkage.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
local.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
machines.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mbus.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
mc146818rtc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
memreg.h [PATCH] sun4c_memerr_reg __iomem annotations 2005-12-15 10:01:29 -08:00
mman.h [PATCH] add asm-generic/mman.h 2006-02-15 15:32:22 -08:00
mmu.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mmu_context.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
module.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mostek.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
mpmbox.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
msgbuf.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
msi.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
mutex.h [PATCH] mutex subsystem, add default include/asm-*/mutex.h files 2006-01-09 15:59:19 -08:00
mxcc.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
namei.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
obio.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
of_device.h [SPARC]: Port of_device layer and make ebus use it. 2006-06-23 23:15:47 -07:00
openprom.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
openpromio.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
oplib.h [SPARC64]: Recognize "virtual-console" as input and output console device. 2006-03-20 01:12:28 -08:00
page.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
param.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
pbm.h [SPARC]: Port sparc64 in-kernel device tree code to sparc32. 2006-06-23 23:15:45 -07:00
pci.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
pcic.h [PATCH] fix iomem annotations in sparc32 pcic code 2005-12-15 10:01:28 -08:00
pconf.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
percpu.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
perfctr.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
pgalloc.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
pgtable.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
pgtsrmmu.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
pgtsun4.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
pgtsun4c.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
poll.h [PATCH] POLLRDHUP/EPOLLRDHUP handling for half-closed devices notifications 2006-03-25 08:22:56 -08:00
posix_types.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
processor.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
prom.h [SPARC]: Add unique device_node IDs and a ".node" property. 2006-06-25 23:18:57 -07:00
psr.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
ptrace.h [PATCH] consolidate sys_ptrace() 2005-11-07 07:53:42 -08:00
reg.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
resource.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
ross.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
rtc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sbi.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
sbus.h [SBUS]: Rewrite and plug into of_device framework. 2006-06-23 23:15:50 -07:00
scatterlist.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sections.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
semaphore.h [PATCH] semaphore: Remove __MUTEX_INITIALIZER() 2005-10-30 17:37:27 -08:00
sembuf.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
setup.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sfp-machine.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
shmbuf.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
shmparam.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sigcontext.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
siginfo.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
signal.h [PATCH] asm/signal.h unification 2005-05-04 07:33:15 -07:00
smp.h Merge master.kernel.org:/pub/scm/linux/kernel/git/davem/sparc-2.6 2006-06-20 17:39:28 -07:00
smpprim.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
socket.h [AF_UNIX]: Datagram getpeersec 2006-06-29 16:58:06 -07:00
sockios.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
solerrno.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
spinlock.h [SPARC]: Add missing rw can_lock macros 2006-06-20 00:35:13 -07:00
spinlock_types.h [PATCH] spinlock consolidation 2005-09-10 10:06:21 -07:00
stat.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
statfs.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
string.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sun4paddr.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sun4prom.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sunbpp.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
svr4.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
swift.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sysen.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
system.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
termbits.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
termios.h [SPARC]: remove duplicate TIOCPKT_ definitions 2005-11-07 14:10:42 -08:00
thread_info.h [SPARC]: Add support for *at(), ppoll, and pselect syscalls. 2006-01-19 02:42:49 -08:00
timer.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
timex.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
tlb.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
tlbflush.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
topology.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
traps.h [SPARC]: "extern inline" doesn't make much sense. 2005-10-03 17:37:02 -07:00
tsunami.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
turbosparc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
types.h [PATCH] sab: consolidate kmem_bufctl_t 2005-09-05 00:05:48 -07:00
uaccess.h [SPARC]: Kill off these __put_user_ret things. 2006-03-20 01:13:15 -08:00
unaligned.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
unistd.h Merge branch 'master' of git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6 2006-05-24 09:22:21 +01:00
user.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
vac-ops.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
vaddrs.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
vfc_ioctls.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
vga.h [PATCH] sparc32 vga support 2006-04-11 06:18:54 -07:00
viking.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
winmacro.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
xor.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00