OSDN Git Service

(split) Import translated manuals from JM CVS Repository.
[linuxjm/LDP_man-pages.git] / release / man2 / msgget.2
1 .\" Copyright 1993 Giorgio Ciucci <giorgio@crcc.it>
2 .\"
3 .\" Permission is granted to make and distribute verbatim copies of this
4 .\" manual provflags the copyright notice and this permission notice are
5 .\" preserved on all copies.
6 .\"
7 .\" Permission is granted to copy and distribute modified versions of this
8 .\" manual under the conditions for verbatim copying, provided that the
9 .\" entire resulting derived work is distributed under the terms of a
10 .\" permission notice identical to this one.
11 .\"
12 .\" Since the Linux kernel and libraries are constantly changing, this
13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
14 .\" responsibility for errors or omissions, or for damages resulting from
15 .\" the use of the information contained herein.  The author(s) may not
16 .\" have taken the same level of care in the production of this manual,
17 .\" which is licensed free of charge, as they might when working
18 .\" professionally.
19 .\"
20 .\" Formatted or processed versions of this manual, if unaccompanied by
21 .\" the source, must acknowledge the copyright and authors of this work.
22 .\"
23 .\" Added correction due to Nick Duffek <nsd@bbc.com>, aeb, 960426
24 .\" Modified Wed Nov  6 04:00:31 1996 by Eric S. Raymond <esr@thyrsus.com>
25 .\" Modified, 8 Jan 2003, Michael Kerrisk, <mtk.manpages@gmail.com>
26 .\"     Removed EIDRM from errors - that can't happen...
27 .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com>
28 .\"     Added notes on capability requirements
29 .\" Modified, 11 Nov 2004, Michael Kerrisk <mtk.manpages@gmail.com>
30 .\"     Language and formatting clean-ups
31 .\"     Added notes on /proc files
32 .\"
33 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
34 .\"         all rights reserved.
35 .\" Translated 1997-02-23, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
36 .\" Modified 2003-07-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
37 .\" Updated 2005-03-04, Akihiro MOTOKI
38 .\"
39 .\"WORD:        message                 ¥á¥Ã¥»¡¼¥¸
40 .\"WORD:        queue                   ¥­¥å¡¼
41 .\"WORD:        identifier              ¼±ÊÌ»Ò
42 .\"WORD:        argument                °ú¤­¿ô
43 .\"WORD:        owner                   ½êÍ­¼Ô
44 .\"WORD:        group                   ¥°¥ë¡¼¥×
45 .\"WORD:        other                   Â¾¿Í
46 .\"WORD:        initialize              ½é´ü²½
47 .\"WORD:        effective user ID       ¼Â¸ú¥æ¡¼¥¶¡¼ID
48 .\"WORD:        effective group ID      ¼Â¸ú¥°¥ë¡¼¥×ID
49 .\"WORD:        current time            ¸½ºß»þ¹ï
50 .\"WORD:        destruction             ÇË´þ
51 .\"WORD:        policy                  Êý¿Ë
52 .\"
53 .TH MSGGET 2 2004-05-27 "Linux" "Linux Programmer's Manual"
54 .SH Ì¾Á°
55 msgget \- ¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¼±Ê̻Ҥò¼èÆÀ¤¹¤ë
56 .SH ½ñ¼°
57 .nf
58 .B #include <sys/types.h>
59 .B #include <sys/ipc.h>
60 .B #include <sys/msg.h>
61
62 .BI "int msgget(key_t " key ", int " msgflg );
63 .fi
64 .SH ÀâÌÀ
65 .BR msgget ()
66 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï
67 .I key
68 °ú¤­¿ô¤ÎÃͤËÂбþ¤¹¤ë¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤Î¼±Ê̻ҤòÊÖ¤¹¡£
69 .I key
70 ¤ÎÃͤ¬
71 .B IPC_PRIVATE
72 ¤Î¾ì¹ç¡¢¤Þ¤¿¤Ï
73 .I key
74 ¤¬
75 .B IPC_PRIVATE
76 ¤Ç¤Ê¤¯¤Æ¤â¡¢
77 .I key
78 ¤ËÂбþ¤¹¤ë¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤¬Â¸ºß¤»¤º¡¢
79 .I msgflg
80 ¤Ë
81 .B IPC_CREAT
82 ¤¬»ØÄꤵ¤ì¤Æ¤¤¤ë¾ì¹ç¡¢
83 ¿·¤·¤¤¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤¬ºîÀ®¤µ¤ì¤ë¡£
84 .PP
85 .I msgflg
86 ¤Ë
87 .B IPC_CREAT
88 ¤È
89 .B IPC_EXCL
90 ¤ÎξÊý¤¬»ØÄꤵ¤ì¤¿¾ì¹ç¡¢
91 .I key
92 ¤ËÂбþ¤¹¤ë¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤¬´û¤Ë¸ºß¤¹¤ë¤È¡¢
93 .BR msgget ()
94 ¤Ï¼ºÇÔ¤·¡¢
95 .I errno
96 ¤Ë
97 .B EEXIST
98 ¤¬ÀßÄꤵ¤ì¤ë¡£
99 (¤³¤ì¤Ï
100 .BR open (2)
101 ¤Ë
102 .B O_CREAT | O_EXCL
103 ¤ò»ØÄꤷ¤¿¾ì¹ç¤ÎÆ°ºî¤ÈƱ¤¸¤Ç¤¢¤ë)
104 .PP
105 ¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤ÎºîÀ®»þ¤Ë¡¢
106 .I msgflg
107 °ú¤­¿ô¤Î²¼°Ì 9 ¥Ó¥Ã¥È¤Ï¡¢
108 ¤½¤Î¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤Î¥¢¥¯¥»¥¹µö²Ä¤ÎÄêµÁ¤È¤·¤Æ»ÈÍѤµ¤ì¤ë¡£
109 ¤³¤ì¤é¤Îµö²Ä¥Ó¥Ã¥È¤Ï
110 .BR open (2)
111 ¤Î°ú¤­¿ô
112 .I mode
113 ¤ÈƱ¤¸·Á¼°¤ÇƱ¤¸°ÕÌ£¤Ç¤¢¤ë¡£
114 ¤ä
115 .BR creat (2)
116 ¥·¥¹¥Æ¥à¡¦¥³¡¼¥ë¤Î¥¢¥¯¥»¥¹µö²Ä¥Ñ¥é¥á¡¼¥¿¤ÈƱ¤¸·Á¼°¤Ç¡¢Æ±¤¸°ÕÌ£¤ò»ý¤Ä¡£
117 (⤷¡¢¼Â¹Ô (execute) µö²Ä¤Ï»ÈÍѤµ¤ì¤Ê¤¤¡£)
118 .PP
119 ¿·µ¬¤Î¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤òºîÀ®¤¹¤ëºÝ¡¢
120 .BR msgget ()
121 ¥·¥¹¥Æ¥à¡¦¥³¡¼¥ë¤Ï¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤Î¥Ç¡¼¥¿¹½Â¤ÂÎ
122 .I msqid_ds
123 ¤ò°Ê²¼¤Î¤è¤¦¤Ë½é´ü²½¤¹¤ë
124 .RI ( msqid_ds
125 ¤Ë¤Ä¤¤¤Æ¤Ï
126 .BR msgctl (2)
127 ¤ò»²¾È):
128 .IP
129 .I msg_perm.cuid
130 ¤È
131 .I msg_perm.uid
132 ¤Ë¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¼Â¸ú (effective) ¥æ¡¼¥¶¡¼ID ¤òÀßÄꤹ¤ë¡£
133 .IP
134 .I msg_perm.cgid
135 ¤È
136 .I msg_perm.gid
137 ¤Ë¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¼Â¸ú (effective) ¥°¥ë¡¼¥×ID ¤òÀßÄꤹ¤ë¡£
138 .IP
139 .I msg_perm.mode
140 ¤Î²¼°Ì 9 ¥Ó¥Ã¥È¤Ï
141 .I msgflg
142 ¤Î²¼°Ì 9 ¥Ó¥Ã¥È¤òÀßÄꤹ¤ë¡£
143 .IP
144 .IR msg_qnum ,
145 .IR msg_lspid ,
146 .IR msg_lrpid ,
147 .IR msg_stime ,
148 .I msg_rtime
149 ¤Ë 0 ¤òÀßÄꤵ¤ì¤ë¡£
150 .IP
151 .I msg_ctime
152 ¤Ë¸½ºß¤Î»þ¹ï¤òÀßÄꤹ¤ë¡£
153 .IP
154 .I msg_qbytes
155 ¤Ë¡¢¥·¥¹¥Æ¥à¤Ç·è¤á¤é¤ì¤¿¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤ÎºÇÂ祵¥¤¥º
156 .B MSGMNB
157 ¤òÀßÄꤹ¤ë¡£
158 .PP
159 ¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤¬¤¹¤Ç¤Ë¸ºß¤¹¤ë¾ì¹ç¤Ï¡¢¥¢¥¯¥»¥¹µö²Ä¤Î¸¡ºº¤È¡¢
160 ÇË´þ (destruction) ¥Þ¡¼¥¯¤¬¤Ê¤¤¤«¤Î³Îǧ¤¬¹Ô¤ï¤ì¤ë¡£
161 .SH ÊÖ¤êÃÍ
162 À®¸ù¤·¤¿¾ì¹ç¡¢ÊÖ¤êÃͤϥá¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¼±Ê̻Ҡ(ÈóÉé¤ÎÀ°¿ô) ¤È¤Ê¤ë¡£
163 ¼ºÇÔ¤·¤¿¾ì¹ç¤Ï \-1 ¤¬ÊÖ¤µ¤ì¡¢
164 .I errno
165 ¤Ë¤½¤Î¥¨¥é¡¼¤¬¼¨¤µ¤ì¤ë¡£
166 .SH ¥¨¥é¡¼
167 ¼ºÇÔ¤·¤¿¾ì¹ç¡¢
168 .I errno
169 ¤Ë°Ê²¼¤ÎÃͤΤ¤¤º¤ì¤«°ì¤Ä¤¬ÀßÄꤵ¤ì¤ë:
170 .TP
171 .B EACCES
172 .I key
173 ¤ËÂбþ¤¹¤ë¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤Ï¸ºß¤¹¤ë¤¬¡¢
174 ¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Ï¤½¤Î¥­¥å¡¼¤ËÂФ¹¤ë¥¢¥¯¥»¥¹µö²Ä¤¬¤Ê¤¯¡¢
175 .B CAP_IPC_OWNER
176 ¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£¤â»ý¤Ã¤Æ¤¤¤Ê¤¤¡£
177 .TP
178 .B EEXIST
179 .I key
180 ¤ËÂбþ¤¹¤ë¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤¬Â¸ºß¤·¡¢
181 .I msgflg
182 ¤Ë
183 .B IPC_CREAT
184 ¤È
185 .B IPC_EXCL
186 ¤¬»ØÄꤵ¤ì¤Æ¤¤¤¿¡£
187 .TP
188 .B ENOENT
189 .I key
190 ¤ËÂбþ¤¹¤ë¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤¬Â¸ºß¤»¤º¡¢
191 .I msgflg
192 ¤Ë
193 .B IPC_CREAT
194 ¤¬»ØÄꤵ¤ì¤Æ¤¤¤Ê¤«¤Ã¤¿¡£
195 .TP
196 .B ENOMEM
197 ¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤òºîÀ®¤·¤è¤¦¤È¤·¤¿¤¬¡¢¿·¤·¤¤¥Ç¡¼¥¿¹½Â¤ÂΤòºîÀ®
198 ¤¹¤ë¤Î¤Ë½½Ê¬¤Ê¥á¥â¥ê¤¬¥·¥¹¥Æ¥à¤Ë¸ºß¤·¤Ê¤¤¡£
199 .TP
200 .B ENOSPC
201 ¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤òºîÀ®¤·¤è¤¦¤È¤·¤¿¤¬¡¢ºîÀ®¤¹¤ë¤È
202 ¥·¥¹¥Æ¥àÁ´ÂΤΥá¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¿ô¤ÎºÇÂçÃÍ
203 .RB ( MSGMNI )
204 ¤òĶ¤¨¤Æ¤·¤Þ¤¦¡£
205 .SH ½àµò
206 SVr4, POSIX.1-2001.
207 .SH Ãí°Õ
208 .B IPC_PRIVATE
209 ¤Ï¥Õ¥é¥°¤Ç¤Ï¤Ê¤¯¡¢
210 .I key_t
211 ·¿¤Ç¤¢¤ë¡£
212 ¤³¤ÎÆÃÊ̤ÊÃͤ¬
213 .I key
214 ¤È¤·¤Æ»ÈÍѤµ¤ì¤¿¾ì¹ç¡¢
215 .BR msgget ()
216 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï
217 .I msgflg
218 ¤Î²¼°Ì 9 ¥Ó¥Ã¥È°Ê³°¤ÎÁ´¤Æ¤ò̵»ë¤·¤Æ
219 (À®¸ù¤·¤¿¾ì¹ç¤Ï) ¿·¤·¤¤¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤òºîÀ®¤¹¤ë¡£
220 .PP
221 .BR msgget ()
222 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë±Æ¶Á¤òµÚ¤Ü¤¹¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤Î»ñ¸»¤Î
223 ¥·¥¹¥Æ¥à¤È¤·¤Æ¤ÎÀ©¸Â¤ò°Ê²¼¤Ë¼¨¤¹:
224 .TP
225 .B MSGMNI
226 ¥·¥¹¥Æ¥àÁ´ÂΤΥá¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¿ô¤ÎºÇÂçÃÍ: Êý¿Ë°Í¸
227 (Linux ¤Ç¤Ï¡¢¤³¤ÎÀ©¸ÂÃͤÏ
228 .I /proc/sys/kernel/msgmni
229 ·Ðͳ¤Ç»²¾È¤·¤¿¤ê¡¢Êѹ¹¤·¤¿¤ê¤Ç¤­¤ë)¡£
230 .SS Linux ¤Ç¤ÎÃí°Õ
231 Linux 2.3.20 ¤Þ¤Ç¤Ï¡¢ºï½ü¤¬Í½Äꤵ¤ì¤Æ¤¤¤ë¥á¥Ã¥»¡¼¥¸¡¦¥­¥å¡¼¤ËÂФ·¤Æ
232 .BR msgget ()
233 ¤ò¹Ô¤¦¤È
234 .B EIDRM
235 ¤¬¥¨¥é¡¼¤È¤·¤ÆÊÖ¤µ¤ì¤ë¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤¿¡£
236 .SH ¥Ð¥°
237 .B IPC_PRIVATE
238 ¤È¤¤¤¦Ì¾Á°¤òÁª¤ó¤À¤Î¤Ï¤ª¤½¤é¤¯¼ºÇԤǤ¢¤í¤¦¡£
239 .B IPC_NEW
240 ¤ÎÊý¤¬¤è¤êÌÀ³Î¤Ë¤½¤Îµ¡Ç½¤òɽ¤·¤Æ¤¤¤ë¤À¤í¤¦¡£
241 .SH ´ØÏ¢¹àÌÜ
242 .BR msgctl (2),
243 .BR msgrcv (2),
244 .BR msgsnd (2),
245 .BR ftok (3),
246 .BR capabilities (7),
247 .BR mq_overview (7),
248 .BR svipc (7)