sec_getshmsec Subroutine

Purpose

Gets the security attributes of a shared memory segment.

Library

Standard C library (libc.a)

Syntax

#include <sys/mac.h>
#include <sys/ipc.h>
#include <sys/shm.h>
int sec_getshmsec (shmid, ipcsec)
int shmid;
ipc_sec_t *ipcsec;

Description

The sec_getshmsec subroutine retrieves the security attributes associated with the shared memory segment that is specified by the shmid parameter. The returned security attributes are stored in the structure that is pointed to by the ipcsec parameter. For a successful completion of the subroutine, the calling process must have MAC and DAC READ access to the shared memory segment.

Parameters

Item Description
shmid Specifies the shared memory segment.
ipcsec Points to an ipc_sec_t structure.

Return Values

Item Description
0 Successful
-1 Unsuccessful

Error Codes

Item Description
EACCES The calling process does not have permissions or privileges.
EFAULT The address that the ipcsec parameter points to is not valid.
EINVAL The shared memory segment that the shmid parameter specifies is not valid.