1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux 1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef _UAPI_LINUX_MSG_H 2 #ifndef _UAPI_LINUX_MSG_H
3 #define _UAPI_LINUX_MSG_H 3 #define _UAPI_LINUX_MSG_H
4 4
5 #include <linux/ipc.h> 5 #include <linux/ipc.h>
6 6
7 /* ipcs ctl commands */ 7 /* ipcs ctl commands */
8 #define MSG_STAT 11 8 #define MSG_STAT 11
9 #define MSG_INFO 12 9 #define MSG_INFO 12
10 #define MSG_STAT_ANY 13 <<
11 10
12 /* msgrcv options */ 11 /* msgrcv options */
13 #define MSG_NOERROR 010000 /* no error if 12 #define MSG_NOERROR 010000 /* no error if message is too big */
14 #define MSG_EXCEPT 020000 /* recv any ms 13 #define MSG_EXCEPT 020000 /* recv any msg except of specified type.*/
15 #define MSG_COPY 040000 /* copy (not r 14 #define MSG_COPY 040000 /* copy (not remove) all queue messages */
16 15
17 /* Obsolete, used only for backwards compatibi 16 /* Obsolete, used only for backwards compatibility and libc5 compiles */
18 struct msqid_ds { 17 struct msqid_ds {
19 struct ipc_perm msg_perm; 18 struct ipc_perm msg_perm;
20 struct msg *msg_first; /* fir 19 struct msg *msg_first; /* first message on queue,unused */
21 struct msg *msg_last; /* las 20 struct msg *msg_last; /* last message in queue,unused */
22 __kernel_old_time_t msg_stime; /* las !! 21 __kernel_time_t msg_stime; /* last msgsnd time */
23 __kernel_old_time_t msg_rtime; /* las !! 22 __kernel_time_t msg_rtime; /* last msgrcv time */
24 __kernel_old_time_t msg_ctime; /* las !! 23 __kernel_time_t msg_ctime; /* last change time */
25 unsigned long msg_lcbytes; /* Reu 24 unsigned long msg_lcbytes; /* Reuse junk fields for 32 bit */
26 unsigned long msg_lqbytes; /* dit 25 unsigned long msg_lqbytes; /* ditto */
27 unsigned short msg_cbytes; /* cur 26 unsigned short msg_cbytes; /* current number of bytes on queue */
28 unsigned short msg_qnum; /* num 27 unsigned short msg_qnum; /* number of messages in queue */
29 unsigned short msg_qbytes; /* max 28 unsigned short msg_qbytes; /* max number of bytes on queue */
30 __kernel_ipc_pid_t msg_lspid; /* pid 29 __kernel_ipc_pid_t msg_lspid; /* pid of last msgsnd */
31 __kernel_ipc_pid_t msg_lrpid; /* las 30 __kernel_ipc_pid_t msg_lrpid; /* last receive pid */
32 }; 31 };
33 32
34 /* Include the definition of msqid64_ds */ 33 /* Include the definition of msqid64_ds */
35 #include <asm/msgbuf.h> 34 #include <asm/msgbuf.h>
36 35
37 /* message buffer for msgsnd and msgrcv calls 36 /* message buffer for msgsnd and msgrcv calls */
38 struct msgbuf { 37 struct msgbuf {
39 __kernel_long_t mtype; /* typ 38 __kernel_long_t mtype; /* type of message */
40 char mtext[1]; /* mes 39 char mtext[1]; /* message text */
41 }; 40 };
42 41
43 /* buffer for msgctl calls IPC_INFO, MSG_INFO 42 /* buffer for msgctl calls IPC_INFO, MSG_INFO */
44 struct msginfo { 43 struct msginfo {
45 int msgpool; 44 int msgpool;
46 int msgmap; 45 int msgmap;
47 int msgmax; 46 int msgmax;
48 int msgmnb; 47 int msgmnb;
49 int msgmni; 48 int msgmni;
50 int msgssz; 49 int msgssz;
51 int msgtql; 50 int msgtql;
52 unsigned short msgseg; 51 unsigned short msgseg;
53 }; 52 };
54 53
55 /* 54 /*
56 * MSGMNI, MSGMAX and MSGMNB are default value 55 * MSGMNI, MSGMAX and MSGMNB are default values which can be
57 * modified by sysctl. 56 * modified by sysctl.
58 * 57 *
59 * MSGMNI is the upper limit for the number of 58 * MSGMNI is the upper limit for the number of messages queues per
60 * namespace. 59 * namespace.
61 * It has been chosen to be as large possible 60 * It has been chosen to be as large possible without facilitating
62 * scenarios where userspace causes overflows 61 * scenarios where userspace causes overflows when adjusting the limits via
63 * operations of the form retrieve current lim 62 * operations of the form retrieve current limit; add X; update limit".
64 * 63 *
65 * MSGMNB is the default size of a new message 64 * MSGMNB is the default size of a new message queue. Non-root tasks can
66 * decrease the size with msgctl(IPC_SET), roo 65 * decrease the size with msgctl(IPC_SET), root tasks
67 * (actually: CAP_SYS_RESOURCE) can both incre 66 * (actually: CAP_SYS_RESOURCE) can both increase and decrease the queue
68 * size. The optimal value is application depe 67 * size. The optimal value is application dependent.
69 * 16384 is used because it was always used (s 68 * 16384 is used because it was always used (since 0.99.10)
70 * 69 *
71 * MAXMAX is the maximum size of an individual 70 * MAXMAX is the maximum size of an individual message, it's a global
72 * (per-namespace) limit that applies for all 71 * (per-namespace) limit that applies for all message queues.
73 * It's set to 1/2 of MSGMNB, to ensure that a 72 * It's set to 1/2 of MSGMNB, to ensure that at least two messages fit into
74 * the queue. This is also an arbitrary choice 73 * the queue. This is also an arbitrary choice (since 2.6.0).
75 */ 74 */
76 75
77 #define MSGMNI 32000 /* <= IPCMNI */ /* 76 #define MSGMNI 32000 /* <= IPCMNI */ /* max # of msg queue identifiers */
78 #define MSGMAX 8192 /* <= INT_MAX */ /* m 77 #define MSGMAX 8192 /* <= INT_MAX */ /* max size of message (bytes) */
79 #define MSGMNB 16384 /* <= INT_MAX */ /* d 78 #define MSGMNB 16384 /* <= INT_MAX */ /* default max size of a message queue */
80 79
81 /* unused */ 80 /* unused */
82 #define MSGPOOL (MSGMNI * MSGMNB / 1024) /* si 81 #define MSGPOOL (MSGMNI * MSGMNB / 1024) /* size in kbytes of message pool */
83 #define MSGTQL MSGMNB /* number of 82 #define MSGTQL MSGMNB /* number of system message headers */
84 #define MSGMAP MSGMNB /* number of 83 #define MSGMAP MSGMNB /* number of entries in message map */
85 #define MSGSSZ 16 /* message s 84 #define MSGSSZ 16 /* message segment size */
86 #define __MSGSEG ((MSGPOOL * 1024) / MSGSSZ) / 85 #define __MSGSEG ((MSGPOOL * 1024) / MSGSSZ) /* max no. of segments */
87 #define MSGSEG (__MSGSEG <= 0xffff ? __MSGSEG 86 #define MSGSEG (__MSGSEG <= 0xffff ? __MSGSEG : 0xffff)
88 87
89 88
90 #endif /* _UAPI_LINUX_MSG_H */ 89 #endif /* _UAPI_LINUX_MSG_H */
91 90
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.