release/man2/spu_create.2

   1 .\" This is _*_ nroff _*_ source. Emacs, gimme all those colors :)
   2 .\"
   3 .\" Copyright (c) International Business Machines Corp., 2006
   4 .\"
   5 .\" This program is free software; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License as
   7 .\" published by the Free Software Foundation; either version 2 of
   8 .\" the License, or (at your option) any later version.
   9 .\"
  10 .\" This program is distributed in the hope that it will be useful,
  11 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
  13 .\" the GNU General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License
  16 .\" along with this program; if not, write to the Free Software
  17 .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston,
  18 .\" MA 02111-1307 USA
  19 .\"
  20 .\" HISTORY:
  21 .\" 2005-09-28, created by Arnd Bergmann <arndb@de.ibm.com>
  22 .\" 2006-06-16, revised by Eduardo M. Fleury <efleury@br.ibm.com>
  23 .\" 2007-07-10, some polishing by mtk
  24 .\"
  25 .TH SPU_CREATE 2 2007-07-10 "Linux" "Linux Programmer's Manual"
  26 .SH Ì¾Á°
  27 spu_create \- ¿·¤·¤¤ SPU ¥³¥ó¥Æ¥¥¹¥È¤òÀ¸À®¤¹¤ë
  28 .SH ½ñ¼°
  29 .nf
  30 .B #include <sys/types.h>
  31 .B #include <sys/spu.h>
  32
  33 .BI "int spu_create(const char *" pathname ", int " flags ", mode_t " mode ");"
  34 .fi
  35 .SH ÀâÌÀ
  36 .BR spu_create ()
  37 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢Cell Broadband Engine ¥¢¡¼¥¥Æ¥¯¥Á¥ã¤ò¼ÂÁõ¤·¤¿
  38 PowerPC ¥Þ¥·¥ó¤Ë¤ª¤¤¤Æ¡¢Synergistic Processor Unit (SPU) ¤Ë¥¢¥¯¥»¥¹¤¹¤ë
  39 ¤¿¤á¤Ë»ÈÍÑ¤µ¤ì¤ë¡£
  40 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢SPU ¤ËÂÐ¤¹¤ë¿·¤·¤¤ÏÀÍý¥³¥ó¥Æ¥¥¹¥È¤ò
  41 .I pathname
  42 ¤ËÀ¸À®¤·¡¢¤½¤Î¥³¥ó¥Æ¥¥¹¥È¤Ë´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
  43 .I pathname
  44 ¤Ï SPU ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à (SPUFS) ¤Î¥Þ¥¦¥ó¥È¥Ý¥¤¥ó¥ÈÆâ¤Î
  45 Â¸ºß¤·¤Ê¤¤¥Ç¥£¥ì¥¯¥È¥ê¤ò»Ø¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  46 .BR spu_create ()
  47 ¤¬À®¸ù¤¹¤ë¤È¡¢
  48 .I pathname
  49 ¤Ë¥Ç¥£¥ì¥¯¥È¥ê¤¬À¸À®¤µ¤ì¡¢¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Ë
  50 .BR spufs (7)
  51 ¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë·²¤¬ÇÛÃÖ¤µ¤ì¤ë¡£
  52
  53 ÊÖ¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ï¥ó¥É¥é¤Ï¡¢
  54 .BR spu_run (2)
  55 ¤ËÅÏ¤¹¤«¡¢¥¯¥í¡¼¥º¤¹¤ë¤«¤·¤«¤Ç¤¤Ê¤¤¡£
  56 Â¾¤ÎÁàºî¤ÏÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
  57 ÏÀÍý SPU ¥³¥ó¥Æ¥¥¹¥È¤¬ÇË´þ¤µ¤ì¤ë¤Î¤Ï¡¢
  58 ¥³¥ó¥Æ¥¥¹¥È¼«¿È¤Ø¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬¥¯¥í¡¼¥º¤µ¤ì¡¢
  59 ¤½¤ÎÃæ¤Î¥Õ¥¡¥¤¥ë¤Ø¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬Á´¤Æ¥¯¥í¡¼¥º¤µ¤ì¤¿¤È¤¤Ç¤¢¤ë¡£
  60 SPU ¥³¥ó¥Æ¥¥¹¥È¤¬ÇË´þ¤µ¤ì¤ë¤È¡¢SPUFS Æâ¤Î¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤ÎÁ´¤Æ¤Î¥¨¥ó¥È¥ê
  61 ¤¬ºï½ü¤µ¤ì¤ë¡£
  62
  63 °ú¤¿ô
  64 .I flags
  65 ¤Ë¤Ï¥¼¥í¤«°Ê²¼¤ÎÄê¿ô¤ò»ØÄê¤Ç¤¤ë¡£
  66 .TP
  67 .B SPU_RAWIO
  68 SPU ¤Î¥Ï¡¼¥É¥¦¥§¥¢¥ì¥¸¥¹¥¿¤Î¤¤¤¯¤Ä¤«¤ò¥æ¡¼¥¶¶õ´Ö¤Ë¥Þ¥Ã¥Ô¥ó¥°¤¹¤ë¤³¤È¤ò
  69 µö²Ä¤¹¤ë¡£¤³¤Î¥Õ¥é¥°¤ò»ØÄê¤¹¤ë¤Ë¤Ï
  70 .B CAP_SYS_RAWIO
  71 ¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£¤¬É¬Í×¤Ç¤¢¤ë¡£
  72 .PP
  73 SPUFS Æâ¤Ë¿·¤·¤¯À¸À®¤µ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¤È¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹µö²Ä¤Ï¡¢
  74 .I mode
  75 °ú¤¿ô¤«¤é¤½¤Î¥×¥í¥»¥¹¤Î
  76 .BR umask (2)
  77 ¤ò°ú¤¤¤¿ÃÍ¤ËÀßÄê¤µ¤ì¤ë¡£
  78 ³Æ¥Õ¥¡¥¤¥ë¤Î¼ÂºÝ¤Î¥¢¥¯¥»¥¹µö²Ä¤Ï¡¢¤½¤Î¥Õ¥¡¥¤¥ë¤¬ÆÉ¤ß½Ð¤·¥¢¥¯¥»¥¹¤ä
  79 ½ñ¤¹þ¤ß¥¢¥¯¥»¥¹¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¤«¤â¹ÍÎ¸¤·¤Æ·è¤Þ¤ë¡£
  80 .SH ÊÖ¤êÃÍ
  81 À®¸ù¤¹¤ë¤È¡¢
  82 .BR spu_create (2)
  83 ¤Ï¿·¤·¤¤¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
  84 ¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
  85 .I errno
  86 ¤Ë°Ê²¼¤Î¥ê¥¹¥È¤ËµºÜ¤Î¥¨¥é¡¼¥³¡¼¥É¤Î¤¤¤º¤ì¤«¤òÀßÄê¤¹¤ë¡£
  87 .SH ¥¨¥é¡¼
  88 .TP
  89 .B EACCES
  90 ¸½ºß¤Î¥æ¡¼¥¶¤¬ SPUFS ¤Î¥Þ¥¦¥ó¥È¥Ý¥¤¥ó¥È¤Ø¤Î½ñ¤¹þ¤ßµö²Ä¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¡£
  91 .TP
  92 .B EEXIST
  93 »ØÄê¤µ¤ì¤¿¥Ñ¥¹Ì¾¤Î SPU ¥³¥ó¥Æ¥¥¹¥È¤¬¤¹¤Ç¤ËÀ¸À®¤µ¤ì¤Æ¤¤¤ë¡£
  94 .TP
  95 .B EFAULT
  96 .I pathname
  97 ¤¬¸½ºß¤Î¥¢¥É¥ì¥¹¶õ´Ö¤ÇÍ¸ú¤ÊÊ¸»úÎó¥Ý¥¤¥ó¥¿¤Ç¤Ï¤Ê¤¤¡£
  98 .TP
  99 .B EINVAL
 100 .I pathname
 101 ¤¬ SPUFS ¥Þ¥¦¥ó¥È¥Ý¥¤¥ó¥¿Æâ¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ï¤Ê¤¤¡£
 102 .TP
 103 .B ELOOP
 104 .I pathname
 105 ¤ò²ò·è¤¹¤ë¤Þ¤Ç¤ËÃ©¤Ã¤¿¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤¬Â¿²á¤®¤¿¡£
 106 .TP
 107 .B EMFILE
 108 ¤½¤Î¥×¥í¥»¥¹¤¬¥ª¡¼¥×¥ó¤Ç¤¤ë¥Õ¥¡¥¤¥ë¿ô¤Î¾å¸Â¤ËÃ£¤·¤Æ¤¤¤¿¡£
 109 .TP
 110 .B ENAMETOOLONG
 111 .I pathname
 112 ¤¬Ä¹²á¤®¤ë¡£
 113 .TP
 114 .B ENFILE
 115 ¥·¥¹¥Æ¥àÁ´ÂÎ¤Ç¥ª¡¼¥×¥ó¤Ç¤¤ë¥Õ¥¡¥¤¥ë¿ô¤Î¾å¸Â¤ËÃ£¤·¤Æ¤¤¤¿¡£
 116 .TP
 117 .B ENOENT
 118 .I pathname
 119 ¤Î°ìÉô¤¬²ò·è¤Ç¤¤Ê¤«¤Ã¤¿¡£
 120 .TP
 121 .B ENOMEM
 122 ¥«¡¼¥Í¥ë¤¬É¬Í×¤Ê¥ê¥½¡¼¥¹¤ÎÁ´¤Æ¤ò³ä¤êÅö¤Æ¤ë¤³¤È¤¬¤Ç¤¤Ê¤«¤Ã¤¿¡£
 123 .TP
 124 .B ENOSPC
 125 ¿·¤·¤¤¥³¥ó¥Æ¥¥¹¥È¤òÀ¸À®¤¹¤ë¤Î¤Ë½½Ê¬¤Ê SPU ¥ê¥½¡¼¥¹¤¬¤Ê¤«¤Ã¤¿¡¢
 126 ¤Þ¤¿¤Ï SPU ¥³¥ó¥Æ¥¥¹¥È¿ô¤¬¤½¤Î¥æ¡¼¥¶¤ÎÆÃÄê¤Î¾å¸Â¤ËÃ£¤·¤Æ¤¤¤¿¡£
 127 .TP
 128 .B ENOSYS
 129 µ¡Ç½¤¬Æ°ºîÃæ¤Î¥·¥¹¥Æ¥à¤ÇÄó¶¡¤µ¤ì¤Æ¤¤¤Ê¤¤¡£ÍýÍ³¤Ï¡¢
 130 ¥Ï¡¼¥É¥¦¥§¥¢¤Ç SPU ¤¬Äó¶¡¤µ¤ì¤Æ¤¤¤Ê¤¤¤«¡¢
 131 spufs ¥â¥¸¥å¡¼¥ë¤¬¥í¡¼¥É¤µ¤ì¤Æ¤¤¤Ê¤¤¤«¡¢¤Î¤É¤Á¤é¤«¤Ç¤¢¤ë¡£
 132 .TP
 133 .B ENOTDIR
 134 .I pathname
 135 ¤Î°ìÉô¤¬¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ï¤Ê¤¤¡£
 136 .SH ¥Õ¥¡¥¤¥ë
 137 .I pathname
 138 ¤Ï SPUFS ¤Î¥Þ¥¦¥ó¥È¥Ý¥¤¥ó¥È¤ÎÇÛ²¼¤Î¾ì½ê¤ò»Ø¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 139 ´·Îã¤Ç¤Ï¡¢SPUFS ¤Ï
 140 .I /spu
 141 ¤Ë¥Þ¥¦¥ó¥È¤µ¤ì¤ë¡£
 142 .SH ¥Ð¡¼¥¸¥ç¥ó
 143 .BR spu_create (2)
 144 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥«¡¼¥Í¥ë 2.6.16 ¤Ç Linux ¤ËÄÉ²Ã¤µ¤ì¤¿¡£
 145 .SH ½àµò
 146 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ¸ÇÍ¤Ç¤¢¤ê¡¢
 147 ppc64 ¥¢¡¼¥¥Æ¥¯¥Á¥ã¤Ç¤Î¤ß¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£
 148 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò»È¤Ã¤¿¥×¥í¥°¥é¥à¤Ï°Ü¿¢À¤¬¤Ê¤¤¡£
 149 .SH Ãí°Õ
 150 glibc ¤Ï¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÂÐ¤¹¤ë¥é¥Ã¥Ñ¡¼´Ø¿ô¤òÄó¶¡¤·¤Æ¤¤¤Ê¤¤¡£
 151 .BR syscall (2)
 152 ¤ò»È¤¦¤³¤È¡£¤¿¤À¤·¡¢
 153 .BR spu_create ()
 154 ¤Ï ¤è¤êÃê¾ÝÅÙ¤Î¹â¤¤ SPU ¤Ø¤Î¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤ò¼ÂÁõ¤¹¤ë¥é¥¤¥Ö¥é¥ê¤«¤é
 155 ÍøÍÑ¤µ¤ì¤ë¤³¤È¤ò°Õ¿Þ¤·¤¿¤â¤Î¤Ç¤¢¤ê¡¢ÄÌ¾ï¤Î¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤«¤é
 156 »ÈÍÑ¤Ï°Õ¿Þ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£¿ä¾©¤Î¥é¥¤¥Ö¥é¥ê¤Ë¤Ä¤¤¤Æ¤Ï
 157 .I http://www.bsc.es/projects/deepcomputing/linuxoncell/
 158 ¤ò»²¾È¤Î¤³¤È¡£
 159 .SH ¥Ð¥°
 160 ¼ÂºÝ¤Î¥³¡¼¥É¤Ç¤Ï¤³¤³¤Ç½Ò¤Ù¤¿Á´¤Æ¤Îµ¡Ç½¤¬´°Á´¤Ë¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¤ï¤±¤Ç¤Ï¤Ê¤¤¡£
 161 .\" .SH AUTHOR
 162 .\" Arnd Bergmann <arndb@de.ibm.com>
 163 .SH ´ØÏ¢¹àÌÜ
 164 .BR close (2),
 165 .BR spu_run (2),
 166 .BR capabilities (7),
 167 .BR spufs (7)