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)