Annotation of coherent/b/bin/ipcs/README, revision 1.1.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

unix.superglobalmegacorp.com

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