Return to msgctl.3l CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/msgctl.3l, revision 1.1.1.1

1.1       root        1: .TH MSGCTL 3L "630 MTG"
                      2: .XE "msgctl()"
                      3: .SH NAME
                      4: msgctl \- message control operations
                      5: .SH SYNOPSIS
                      6: .B #include <message.h>
                      7: .sp
                      8: .B int msgctl (msqid, cmd, buf)
                      9: .br
                     10: .B long msqid;
                     11: .br
                     12: .B int cmd;
                     13: .br
                     14: .B struct msqid_ds \(**buf;
                     15: .SH DESCRIPTION
                     16: .I Msgctl
                     17: provides a variety of message control operations as
                     18: specified by
                     19: .IR cmd.
                     20: The following
                     21: .I cmds
                     22: are available:
                     23: .sp
                     24: .B IPC_STAT
                     25: .br
                     26: .RS 6
                     27: Place the current value of each member of the
                     28: data structure associated with
                     29: .I msqid
                     30: into the structure pointed to by
                     31: .IR buf .
                     32: .RE
                     33: .PP
                     34: .B IPC_SET
                     35: .br
                     36: .RS 6
                     37: Set the value of the following members of the
                     38: data structure associated with
                     39: .I msqid
                     40: to the corresponding value found in the structure
                     41: pointed to by
                     42: .IR buf:
                     43: .ft B
                     44: .RS 6
                     45: msg_qbytes
                     46: .br
                     47: cid
                     48: .br
                     49: state
                     50: .ft R
                     51: .sp
                     52: .RE
                     53: The creator process id can be changed.
                     54: This is done so that when this
                     55: process is deleted, the queue will be deleted with it.
                     56: .RE
                     57: .PP
                     58: .B IPC_RMID
                     59: .br
                     60: .RS 6
                     61: Remove the message queue identifier specified by
                     62: .I msqid
                     63: from the system and destroy the
                     64: message queue and data structure associated
                     65: with it. This can be executed by any process.
                     66: .RE
                     67: .PP
                     68: .I Msgctl
                     69: will fail if one or more of the following are true:
                     70: .sp
                     71: .RS 6
                     72: .I Msqid
                     73: is not a valid message queue identifier.
                     74: .sp
                     75: .I Cmd
                     76: is not a valid command.
                     77: .sp
                     78: .I Cmd
                     79: is equal to
                     80: .B IPC_SET
                     81: and an attempt is being made to increase the value of
                     82: .B msg_qbytes
                     83: over
                     84: .B MAX_BYTES
                     85: (8192).
                     86: .RE
                     87: .P
                     88: A side effect of \f2msgctl\f1 is that it clears the MSG
                     89: resource ready condition used by the \f2wait\f1 and \f2own\f1
                     90: resource functions.
                     91: .SS Return Value
                     92: Upon successful completion, a value of 0 is returned.
                     93: Otherwise, a value of -1 is returned.
                     94: .PP
                     95: .SH SEE ALSO
                     96: msgget(3L), msgop(3L), realtime(3R), resources(3R), structures(3R).

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