AT&T UNIX™PC Unix System V Users Manual - tenox

AT&T UNIX™PC Unix System V Users Manual - tenox AT&T UNIX™PC Unix System V Users Manual - tenox

01.01.2013 Views

MSGCTL(2) MSGCTL ( 2 ) user ID of the calling process is not equal to that of super user. IEPERMI Buf points to an illegal address. IEFAULTI RETURN VALUE Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error. SEE ALSO msgget(2), msgop(2), stdipc(3C). - 2-

MSGGET (2) MSGGET (2) NAME msgget - get message queue SYNOPSIS #include #include #include int msgget {key, msgflg) key_t key; int msgflg; DESCRIPTION Msgget returns the message queue identifier associated with key. A message queue identifier and associated message queue and data structure (see intro(2)) are created for key if one of the following are true: Key is equal to IPC_PRIVATE. Key does not already have a message queue identifier associated with it, and (msgftg & IPC_CREAT) is "true". Upon creation, the data structure associated with the new message queue identifier is initialized as follows: Msg_perm.cuid, msg_perm.uid, msg_perm.cgid, and msg_perm.gid are set equal to the effective user ID and effective group ID, respectively, of the calling process. The low-order 9 bits of msg_perm.mode are set equal to the low-order 9 bits of msgftg . Msg_qnum, msg_lspid, msg_lrpid, msg_stime, and msg_rtime are set equal to 0. Msg_ctime is set equal to the current time. Msg_qbytes is set equal to the system limit. Msgget will fail if one or more of the following are true: A message queue identifier exists for key but operation permission (see intro(2)) as specified by the low-order 9 bits of msgftg would not be granted. [EACCESI A message queue identifier does not exist for key and (msgftg & IPC_CREAT) is "false". [ENOENTI A message queue identifier is to be created but the system imposed limit on the maximum number of allowed message queue identifiers system wide would be exceeded. [ENOSPCI A message queue identifier exists for key but ( ( msgftg & IPC_CREAT) & { msgftg & IPC_EXCL) ) is "true". [EEXISTI RETURN VALUE Upon successful completion, a non-negative integer, namely a message queue identifier, is returned. Otherwise, a value of - 1 is returned and errno is set to indicate the error. - 1 -

MSGCTL(2) MSGCTL ( 2 )<br />

user ID of the calling process is not equal to that of super<br />

user. IEPERMI<br />

Buf points to an illegal address. IEFAULTI<br />

RETURN VALUE<br />

Upon successful completion, a value of 0 is returned. Otherwise, a<br />

value of -1 is returned and errno is set to indicate the error.<br />

SEE ALSO<br />

msgget(2), msgop(2), stdipc(3C).<br />

- 2-

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!