linux/include/asm-m68k
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
adb.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
adb_iop.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
amigahw.h [PATCH] m68k: namespace pollution fix (custom->amiga_custom) 2006-01-12 09:09:00 -08:00
amigaints.h [PATCH] m68k: convert amiga irq code 2006-06-25 10:00:57 -07:00
amigayle.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
amipcmcia.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
apollodma.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
apollohw.h [PATCH] m68k: convert apollo irq code 2006-06-25 10:00:57 -07:00
atafd.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atafdreg.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atari_acsi.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atari_joystick.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atari_SLM.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atari_stdma.h [PATCH] m68k: introduce irq controller 2006-06-25 10:00:57 -07:00
atari_stram.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atarihw.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atariints.h [PATCH] m68k: cleanup generic irq names 2006-06-25 10:00:57 -07:00
atarikb.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
atomic.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
auxvec.h [PATCH] auxiliary vector cleanups 2005-09-07 16:57:21 -07:00
bitops.h [PATCH] m68k: fix undefined reference to generic_find_next_zero_le_bit 2006-03-26 08:57:13 -08:00
blinken.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
bootinfo.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
bug.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
bugs.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
bvme6000hw.h [PATCH] m68k: convert VME irq code 2006-06-25 10:00:58 -07: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
cachectl.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
cacheflush.h [PATCH] m68k: small flush_icache() cleanup 2006-06-25 10:00:56 -07:00
checksum.h [PATCH] m68k: checksum __user annotations 2006-01-12 09:09:03 -08:00
contregs.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07: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
delay.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
div64.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
dma-mapping.h [PATCH] m68k: dma API addition 2006-06-25 10:00:56 -07:00
dma.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
dsp56k.h [PATCH] m68k: dsp56k __user annotations 2006-01-12 09:09:04 -08:00
dvma.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01: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
entry.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
errno.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -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
floppy.h [PATCH] m68k: NULL noise removal 2006-01-12 09:09:04 -08:00
fpu.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01: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
hp300hw.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
hwtest.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 Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
intersil.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
io.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
ioctl.h [PATCH] Generic ioctl.h 2006-01-10 08:01:34 -08:00
ioctls.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -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] m68k: convert generic irq code to irq controller 2006-06-25 10:00:57 -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
mac_asc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mac_baboon.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mac_iop.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mac_mouse.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mac_oss.h [PATCH] m68k: convert mac irq code 2006-06-25 10:00:58 -07:00
mac_psc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mac_via.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
machdep.h [PATCH] m68k: convert generic irq code to irq controller 2006-06-25 10:00:57 -07:00
machines.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
machw.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
macintosh.h [PATCH] m68k: convert mac irq code 2006-06-25 10:00:58 -07:00
macints.h [PATCH] m68k: convert mac irq code 2006-06-25 10:00:58 -07:00
math-emu.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
mc146818rtc.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
md.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07: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 Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
module.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
motorola_pgalloc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
motorola_pgtable.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
movs.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
mutex.h [PATCH] mutex subsystem, add default include/asm-*/mutex.h files 2006-01-09 15:59:19 -08:00
mvme16xhw.h [PATCH] m68k: convert VME irq code 2006-06-25 10:00:58 -07:00
mvme147hw.h [PATCH] m68k: convert VME irq code 2006-06-25 10:00:58 -07:00
namei.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
nubus.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
openprom.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
oplib.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
page.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
page_offset.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
parport.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
pci.h [ACPI] PNPACPI vs sound IRQ 2005-07-12 00:03:30 -04:00
percpu.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
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 [PATCH] m68k: use c99 initializer 2006-06-23 07:43:00 -07:00
ptrace.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
q40_master.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
q40ints.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
raw_io.h [PATCH] iomap_copy fallout (m68k) 2006-02-18 16:30:40 -05:00
resource.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
sbus.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
scatterlist.h [PATCH] m68k: Add the generic dma API functions 2006-06-25 10:00:56 -07:00
sections.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
segment.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
semaphore-helper.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01: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
serial.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
setup.h Don't include linux/config.h from anywhere else in include/ 2006-04-26 12:56:16 +01:00
shm.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] m68k: fix constraints of the signal functions and some cleanup 2006-06-25 10:00:56 -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
spinlock.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
stat.h [PATCH] 2TB files: st_blocks is invalid when calling stat64 2006-03-26 08:57:00 -08:00
statfs.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
string.h [PATCH] m68k: cleanup inline mem functions 2005-09-05 00:06:19 -07:00
sun3-head.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sun3_pgalloc.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sun3_pgtable.h [PATCH] m68k: bogus function argument types (sun3_pgtable.h) 2006-01-12 09:09:01 -08:00
sun3ints.h [PATCH] m68k: convert sun3 irq code 2006-06-25 10:00:58 -07:00
sun3mmu.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sun3x.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
sun3xflop.h [PATCH] m68k: NULL noise removal 2006-01-12 09:09:04 -08:00
sun3xprom.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
suspend.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
swim_iop.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 Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
thread_info.h [PATCH] missing helper - task_stack_page() 2006-01-12 09:08:50 -08: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 [PATCH] m68k: convert generic irq code to irq controller 2006-06-25 10:00:57 -07:00
types.h [PATCH] sab: consolidate kmem_bufctl_t 2005-09-05 00:05:48 -07:00
uaccess.h [PATCH] m68k: fix uaccess.h for gcc-3.x 2006-06-25 10:00:56 -07:00
ucontext.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
unaligned.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
unistd.h [PATCH] m68k: cleanup unistd.h 2006-06-23 07:43:00 -07:00
user.h Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
virtconvert.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
zorro.h [PATCH] m68k: basic iomem annotations 2006-01-12 09:09:02 -08:00