sec_getmsgsec Subroutine

Purpose

Gets the security attributes of Interprocess Communication (IPC) message queue.

Library

Standard C library (libc.a)

Syntax

#include <sys/mac.h>
#include <sys/ipc.h>
#include <sys/msg.h>

int sec_getmsgsec (msgid, ipcsec)
int msgid;
ipc_sec_t *ipcsec;

Description

The sec_getmsgsec subroutine retrieves the security attributes associated with the message queue that is specified by the msgid 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 message queue.

Parameters

Item	Description
msgid	Specifies the message queue.
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 message queue that the msgid parameter specifies is not valid.