Return to msgget CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/msgget, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: msgget()               COHERENT System Call              msgget()
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Get message queue
        !             9: 
        !            10: #include <sys/msg.h>
        !            11: mmssggggeett(_k_e_y, _m_s_g_f_l_g)
        !            12: kkeeyy_tt _k_e_y; iinntt _m_s_g_f_l_g;
        !            13: 
        !            14: msgget returns the  message queue identifier associated with key,
        !            15: should it exist.  If key has no message queue associated with it,
        !            16: msgget checks  whether (_m_s_g_f_l_g  & IIPPCC_CCRREEAATT)  is true; if  it is,
        !            17: then  msgget creates  a message  queue identifier  and associated
        !            18: message queue and data structure for _k_e_y.
        !            19: 
        !            20: Upon creation, the data structure associated with the new message
        !            21: queue identifier is initialized as follows:
        !            22: 
        !            23: *  msg_perm.cuid,  msg_perm.uid, msg_perm.cgid,  and msg_perm.gid
        !            24:    are set  to, respectively,  the effective user  identifier and
        !            25:    effective group identifier of the calling process.
        !            26: 
        !            27: *  The  low-order nine bits of msg_perm.mode are  set to the low-
        !            28:    order nine bits of msgflg.  These nine bits define access per-
        !            29:    missions: the  top three bits specify  the owner's access per-
        !            30:    missions (read, write, execute), the middle three bits specify
        !            31:    the owning group's  access permissions, and the low three bits
        !            32:    specify access permissions for others.
        !            33: 
        !            34: *  msg_ctime is set to the current time.
        !            35: 
        !            36: *  msg_qbytes is set equal to the system limit, as defined by the
        !            37:    kernel variable NMSQB.
        !            38: 
        !            39: msgget fails  if any of  the following is true.   The term within
        !            40: parentheses  gives  the  value to  which  msgget  sets errno,  as
        !            41: defined in the header file errno.h:
        !            42: 
        !            43: *  A  message queue identifier exists for  key but operation per-
        !            44:    mission  as specified  by the  low-order  nine bits  of msgflg
        !            45:    would not be granted (EEAACCCCEESS).
        !            46: 
        !            47: *  A message queue identifier  does not exist for key and (_m_s_g_f_l_g
        !            48:    & IIPPCC_CCRREEAATT) is false (EENNOOEENNTT).
        !            49: 
        !            50: *  A message queue identifier is  to be created but the number of
        !            51:    message queue identifiers system-wide exceeds the system limit
        !            52:    as specified in the kernel variable NMSQID (EENNOOSSPPCC).
        !            53: 
        !            54: *   A message  queue identifier  exists for  key, but  ((_m_s_g_f_l_g &
        !            55:    IIPPCC_CCRREEAATT) && (_m_s_g_f_l_g & IIPPCC_EEXXCCLL)) is true (EEEEXXIISSTT).
        !            56: 
        !            57: ***** Return Value *****
        !            58: 
        !            59: Upon  successful  completion,  msgget returns  the  message-queue
        !            60: identifier, which  is always a  non-negative integer.  Otherwise,
        !            61: it returns -1 and sets eerrrrnnoo to an appropriate value.
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: msgget()               COHERENT System Call              msgget()
        !            70: 
        !            71: 
        !            72: 
        !            73: 
        !            74: ***** Files *****
        !            75: 
        !            76: /usr/include/sys/ipc.h
        !            77: /usr/include/sys/msg.h
        !            78: /dev/msg
        !            79: 
        !            80: ***** See Also *****
        !            81: 
        !            82: COHERENT system calls, msg, msgctl(), msgrcv(), msgsnd()
        !            83: 
        !            84: ***** Notes *****
        !            85: 
        !            86: To  improve  portability, the  mmssgg  functions  are presently  im-
        !            87: plemented  as a  device driver  rather than  as an  actual system
        !            88: call.
        !            89: 
        !            90: 
        !            91: 
        !            92: 
        !            93: 
        !            94: 
        !            95: 
        !            96: 
        !            97: 
        !            98: 
        !            99: 
        !           100: 
        !           101: 
        !           102: 
        !           103: 
        !           104: 
        !           105: 
        !           106: 
        !           107: 
        !           108: 
        !           109: 
        !           110: 
        !           111: 
        !           112: 
        !           113: 
        !           114: 
        !           115: 
        !           116: 
        !           117: 
        !           118: 
        !           119: 
        !           120: 
        !           121: 
        !           122: 
        !           123: 
        !           124: 
        !           125: 
        !           126: 
        !           127: 
        !           128: 
        !           129: 
        !           130: COHERENT Lexicon                                           Page 2
        !           131: 
        !           132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.