Return to README CVS log

Up to [MW Coherent from dump] / coherent / b / bin / ipcs

Annotation of coherent/b/bin/ipcs/README, revision 1.1

1.1     ! root        1: 12/30/92       Version 0.02    Vlad
        !             2: 
        !             3: Fixed minor output bugs. Made ipcs work with SVR3 compatible
        !             4: shared memory and message queues. Semaphore part is still working
        !             5: with old 286 semaphores. Output layaout for semaphores may be wrong.
        !             6: 
        !             7: shmemul.c is included because the proper interface was not
        !             8: included in libc.a. It should be removed as soon as libc.a will
        !             9: be fixed.
        !            10: 
        !            11: 
        !            12: 09/22/92:      Version 0.01
        !            13: 
        !            14: This ipcs command does not yet support the Corefile option.
        !            15: 
        !            16: ipcs will grok /autoboot by default for the symbols NSEMID, NSHMID and
        !            17: NMSQID, which are the max allowable semaphores, shared memory segments
        !            18: and message queues. It does not touch /dev/kmem. I see no reason for this.
        !            19: 
        !            20: Next, it will then perform msgctl()s, semctl()s and/or shmctl()s as necessary
        !            21: to get the stats for any active message queues, semaphores and
        !            22: shared memory segments.
        !            23: 
        !            24: It will then print out the information based upon the arguments passed
        !            25: on the command line.
        !            26: 
        !            27: This ipcs has on flag that is not part of SV, the 'V' or 'version'
        !            28: flag, which will print the internal version number of the ipcs command.
        !            29: 
        !            30: Warning: when requesting information on active message queues, the command
        !            31: will run noticeably slower. This is due to the message queue sequence
        !            32: numbering scheme used by our message driver. Vlad is working on a new
        !            33: message driver, and ipcs will be updated to snarf msg information
        !            34: more quickly when the new driver is available.
        !            35: 
        !            36: 
        !            37: Docs:
        !            38: 
        !            39: ipcs [ options ]
        !            40: 
        !            41: ipcs prints certain information about active message queues, semaphores
        !            42: and shared memory segments. The information printed is based upon the
        !            43: options passed to the command. The options are:
        !            44: 
        !            45: -q     print info about active message queues
        !            46: -m     print info about active shared memory segments
        !            47: -s     print info about active semaphores
        !            48: 
        !            49: If none of the above options are specified, information about each active
        !            50: ipc driver will be printed.
        !            51: 
        !            52: -b     message queues:  max. allowable bytes on message queue
        !            53:        shared memory:   size of shared memory segment
        !            54:        semaphores:      number of semaphores in each set
        !            55: 
        !            56: -c     (all):           print creator's login name and group
        !            57: 
        !            58: -o     message queues:  number of messages, total bytes in messages on
        !            59:                         queue.
        !            60: -p     message queues:  last process to send message, last process
        !            61:                         to receive message.
        !            62:        shared memory:   id of creating process, last process
        !            63:                         to attach or detach (Not available)
        !            64: -t     message queues:  time of last msgsend() and msgrcv()
        !            65:        shared memory:   time of last shmat() or shmdt() (Not available)
        !            66:        semaphores:      time of last semop()
        !            67: 
        !            68: -a     use all print (above) options 
        !            69: 
        !            70: -C corefile:           specify corefile to use in place of /autoboot
        !            71: -N namelist:           specify name of alternate kernel (/autoboot default)
        !            72: 
        !            73: 
        !            74: 
        !            75: ipcs column headings:
        !            76: 
        !            77: T      type of facility:       q = message queue
        !            78:                                m = shared memory segment
        !            79:                                s = semaphore segment
        !            80: 
        !            81: ID     Identifier for facility entry. This is the 'id' argument
        !            82:        passed from shmctl(), msgctl() or semctl() a user program
        !            83:        would use to access the facility.
        !            84: 
        !            85: KEY    This is the key used by msgget(), semget() or shmget() to
        !            86:        create the facility.
        !            87: 
        !            88: MODE   The permissions associated with the shared memory segment, message
        !            89:        queue or semaphore. This field may contain additional characters
        !            90:        when printing the statistics of a message queue:
        !            91:                R       A process is waiting on a msgrcv()
        !            92:                W       A process is waiting on a msgsnd()
        !            93:                -       msgrcv()/msgsnd() flag is not set
        !            94: 
        !            95:        The octal number in this field represents the permissions. Please
        !            96:        refer to the lexicon article on chmod for information on the
        !            97:        values in this field.
        !            98: 
        !            99: OWNER  The login name if the person who owns the facility
        !           100: 
        !           101: GROUP  The group that the owner belongs to
        !           102: 
        !           103: CREATOR        The login name of the creator of the facility
        !           104: 
        !           105: CGROUP The group that the creator of the facility belongs to
        !           106: 
        !           107: CBYTES The number of bytes currently used in the message queue
        !           108: 
        !           109: QNUM   The number of messages in the message queue
        !           110: 
        !           111: QBYTES The maximimum number of bytes in the message queue
        !           112: 
        !           113: LSPID  The process id of the last process to send a message to the queue
        !           114: 
        !           115: LRPID  The process id of the last process to reveive a message from the queue
        !           116: 
        !           117: STIME  The last time a message was sent to the message queue
        !           118: 
        !           119: RTIME  The last time a messge was received from the message queue
        !           120: 
        !           121: CTIME  (shared memory and message queues) The time the shared memory segement
        !           122:        or message queue was created or last modified.
        !           123: 
        !           124: NATTCH Number of processes attached to the associated shared memory segment
        !           125:        (Not available)
        !           126: 
        !           127: SEGSZ  Size of the shared memory segment
        !           128: 
        !           129: CPID   The process id that created the shared memory segment
        !           130: 
        !           131: LPID   The process id of the last attach or detach from the
        !           132:        shared memory segment (Not available)
        !           133: 
        !           134: ATIME  Time of last attach to the shared memory segment (Not available)
        !           135: 
        !           136: DTIME  Time of last detach from the shared memory segment (Not available)
        !           137: 
        !           138: NSEMS  The number of semaphore elements in the semaphore
        !           139: 
        !           140: OTIME  The time that the semaphore was created or last modified

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