*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> standard/msgget (2)              
Title
Content
Arch
Section
 

Contents


msgget(2)							     msgget(2)


NAME    [Toc]    [Back]

     msgget - get message queue

SYNOPSIS    [Toc]    [Back]

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

     int msgget(key_t key, int msgflg);

DESCRIPTION    [Toc]    [Back]

     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 IPC_PRIVATE.

	  key does not already have a message queue identifier associated with
	  it, and (msgflg<b>&IPC_CREAT) is	true.

     On	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
	  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	to the low-order 9
	  bits of msgflg.

	  msg_qnum, msg_lspid, msg_lrpid, msg_stime, and msg_rtime are set to
	  0.

	  msg_ctime is set to the current time.

	  msg_qbytes is	set to the system limit.



     msgget fails if one or more of the	following are true:

     EACCES	    A message queue identifier exists for key, but operation
		    permission [see intro(2)] as specified by the low-order 9
		    bits of msgflg would not be	granted.

     ENOENT	    A message queue identifier does not	exist for key and
		    (msgflg<b>&IPC_CREAT) is false.






									Page 1






msgget(2)							     msgget(2)



     ENOSPC	    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.

     EEXIST	    A message queue identifier exists for key but
		    (msgflg<b>&IPC_CREAT) and (msgflg<b>&IPC_EXCL) are both true.

SEE ALSO    [Toc]    [Back]

      
      
     intro(2), msgctl(2), msgop(2), stdipc(3C).

DIAGNOSTICS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
mq_open Tru64 Establishes the connection between a message queue and a message queue descriptor (P1003.1b)
mq_receive Tru64 Receives the oldest, highest-priority message from the message queue (P1003.1b)
mq_send Tru64 Places a message in the message queue (P1003.1b)
mq_send HP-UX send a message to a message queue
msgrcv FreeBSD receive a message from a message queue
msgsnd FreeBSD send a message to a message queue
mq_receive HP-UX receive a message from a message queue
msgrcv OpenBSD receive a message from a message queue
msgsnd OpenBSD send a message to a message queue
msgrcv NetBSD receive a message from a message queue
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service