Return to msgctl CVS log

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

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

1.1     ! root        1: 
        !             2: 
        !             3: msgctl()               COHERENT System Call              msgctl()
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Message control operations
        !             9: 
        !            10: #include <sys/msg.h>
        !            11: iinntt mmssggccttll(_m_s_q_i_d, _c_m_d, _b_u_f)
        !            12: iinntt _m_s_q_i_d; iinntt _c_m_d; ssttrruucctt mmssqqiidd_ddss *_b_u_f;
        !            13: 
        !            14: msgctl performs the  message-control operations specified by cmd.
        !            15: The following cmds are available:
        !            16: 
        !            17: IIPPCC_SSTTAATT   Place the  current value  of each  member of  the data
        !            18:           structure  associated  with  msqid into  the  structure
        !            19:           pointed to by buf.
        !            20: 
        !            21: IIPPCC_SSEETT    Set the  value of  the following  members of  the data
        !            22:           structure  associated with  msqid to  the corresponding
        !            23:           value found in the structure pointed to by buf:
        !            24: 
        !            25:           msg_perm.uid
        !            26:           msg_perm.gid
        !            27:           msg_perm.mode /* only low 9 bits */
        !            28:           msg_qbytes
        !            29: 
        !            30:           This  cmd can only be executed by a process that has an
        !            31:           effective-user identifier  equal to either  that of su-
        !            32:           peruser  or to  the value of  msg_perm.uid in  the data
        !            33:           structure  associated with  msqid.  Only  superuser can
        !            34:           raise the value of msg_qbytes.
        !            35: 
        !            36: IIPPCC_RRMMIIDD  Remove  the system  identifier specified by  msqid from
        !            37:           the  system  and destroy  the  message  queue and  data
        !            38:           structure associated with it.  This cmd can only be ex-
        !            39:           ecuted by  a process  that has an  effective-user iden-
        !            40:           tifier  equal to  either that  of  superuser or  to the
        !            41:           value of msg_perm.uid  in the data structure associated
        !            42:           with msqid.
        !            43: 
        !            44: msgctl fails if any of the following are true:
        !            45: 
        !            46: *  msqid  is not a  valid message queue  identifier.  msgctl sets
        !            47:    the global variable errno to EINVAL.
        !            48: 
        !            49: *  cmd is not a valid command (EEIINNVVAALL).
        !            50: 
        !            51: *  cmd is equal to IPC_STAT and operation permission is denied to
        !            52:    the calling process (EEAACCCCEESS).
        !            53: 
        !            54: *  cmd  is equal to  IPC_RMID or IPC_SET,  and the effective-user
        !            55:    identifier of the calling process  is not equal to that of su-
        !            56:    peruser and  it is not  equal to the value  of msg_perm.uid in
        !            57:    the data structure associated with msqid (EEPPEERRMM).
        !            58: 
        !            59: *  cmd is equal to IPC_SET,  an attempt is being made to increase
        !            60:    to the value  of msg_qbytes, and the effective-user identifier
        !            61:    of  the calling  process is  not equal to  that of  super user
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: msgctl()               COHERENT System Call              msgctl()
        !            70: 
        !            71: 
        !            72: 
        !            73:    (EEPPEERRMM).
        !            74: 
        !            75: *  buf points to an illegal address (EEFFAAUULLTT).
        !            76: 
        !            77: ***** Return Value *****
        !            78: 
        !            79: Upon successful  completion, msgctl  returns zero.  If  a problem
        !            80: occurs, it returns -1 and sets eerrrrnnoo to an appropriate value.
        !            81: 
        !            82: ***** Files *****
        !            83: 
        !            84: /usr/include/sys/ipc.h
        !            85: /usr/include/sys/msg.h
        !            86: /dev/msg
        !            87: 
        !            88: ***** See Also *****
        !            89: 
        !            90: COHERENT system calls, msg, msgget(), msgrcv(), msgsnd()
        !            91: 
        !            92: ***** Notes *****
        !            93: 
        !            94: To improve portability,  COHERENT implements the mmssgg functions as
        !            95: a device driver rather than as an actual system call.
        !            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.