Return to shmctl CVS log

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

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

1.1     ! root        1: 
        !             2: 
        !             3: shmctl()               COHERENT System Call              shmctl()
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Control shared-memory operations
        !             9: 
        !            10: #include <sys/shm.h>
        !            11: sshhmmccttll(_s_h_m_i_d, _c_m_d, _b_u_f)
        !            12: iinntt _s_h_m_i_d, _c_m_d; ssttrruucctt sshhmmiidd_ddss *_b_u_f;
        !            13: 
        !            14: shmctl  provides  controls  the COHERENT  system's  shared-memory
        !            15: facility.  cmd specifies the operation to perform, as follows:
        !            16: 
        !            17: IIPPCC_SSTTAATT   Place the  current value  of each  member of  the data
        !            18:           structure  associated  with  shmid 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  shmid to  the corresponding
        !            23:           value found in the structure pointed to by buf:
        !            24: 
        !            25:           shm_perm.uid
        !            26:           shm_perm.gid
        !            27:           shm_perm.mode /* only low 9 bits */
        !            28: 
        !            29:           This  cmd  can be executed only by  a process whose ef-
        !            30:           fective user ID  equals either that of the superuser or
        !            31:           shm_perm.uid  in  the  data structure  associated  with
        !            32:           shmid.
        !            33: 
        !            34: IIPPCC_RRMMIIDD  Remove  the system  identifier specified by  shmid from
        !            35:           the system  and destroy  the shared memory  segment and
        !            36:           data structure associated with it.  This cmd can be ex-
        !            37:           ecuted only by a process whose effective user ID equalS
        !            38:           either  that of  the superuser  or shm_perm.uid  in the
        !            39:           data structure associated with shmid.
        !            40: 
        !            41: shmctl fails if any of the following is true:
        !            42: 
        !            43: *  shmid is not a  valid shared memory identifier shmget sets er-
        !            44:    rno to EEIINNVVAALL.
        !            45: 
        !            46: *  cmd is not a valid command (EEIINNVVAALL).
        !            47: 
        !            48: *  cmd equals IPC_STAT  and operation permission is denied to the
        !            49:    calling process (EEAACCCCEESS).
        !            50: 
        !            51: *  cmd  equals IPC_RMID or  IPC_SET and the  effective user iden-
        !            52:    tifier of the calling  process does equals neither that of the
        !            53:    superuser  nor shm_perm.uid in  the data  structure associated
        !            54:    with shmid (EEPPEERRMM).
        !            55: 
        !            56: *  buf points to an illegal address (EEFFAAUULLTT).
        !            57: 
        !            58: ***** Return Value *****
        !            59: 
        !            60: Upon  successful completion, shmctl  returns zero;  otherwise, it
        !            61: returns -1 and sets errno to an appropriate value.
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: shmctl()               COHERENT System Call              shmctl()
        !            70: 
        !            71: 
        !            72: 
        !            73: 
        !            74: ***** Files *****
        !            75: 
        !            76: /usr/include/sys/ipc.h
        !            77: /usr/include/sys/shm.h
        !            78: /dev/shm
        !            79: /drv/shm
        !            80: 
        !            81: ***** See Also *****
        !            82: 
        !            83: COHERENT system calls, shm, shmget()
        !            84: 
        !            85: ***** Notes *****
        !            86: 
        !            87: To  improve  portability,  the  COHERENT  system  implements  its
        !            88: shared-memory functions  as a device driver instead  of as an ac-
        !            89: tual system call.
        !            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.