.\" This is _*_ nroff _*_ source. Emacs, gimme all those colors :)
.\"
.\" Copyright (c) International Business Machines Corp., 2006
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
.\" the GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston,
.\" MA 02111-1307 USA
.\"
.\" HISTORY:
.\" 2005-09-28, created by Arnd Bergmann <arndb@de.ibm.com>,
.\"   Mark Nutter <mnutter@us.ibm.com> and
.\"   Ulrich Weigand <Ulrich.Weigand@de.ibm.com>
.\" 2006-06-16, revised by Eduardo M. Fleury <efleury@br.ibm.com>
.\" 2007-07-10, quite a lot of polishing by mtk
.\"
.TH SPUFS 7 2007-07-10 "Linux" "Linux Programmer's Manual"
.SH ̾
spufs \- SPU ե륷ƥ
.SH 
SPU ե륷ƥϡCell Broadband Engine ƥ
PowerPC ޥˤơSynergistic Processor Unit (SPU) ˥
˻Ѥ롣

Υե륷ƥǤϡPOSIX ͭå塼
֤̾󶡤롣
ե륷ƥ˽񤭹ߵĤĥ桼
.BR spu_create (2)
Ȥä spufs Υ롼ȥǥ쥯ȥ SPU ƥȤǤ롣

 SPU ƥȤϡ餫줿ե뷲ޤ
ǥ쥯ȥȤɽ롣
ΥեȤäơ SPU ξ֤Ǥ롣
桼ϤΥեΥĤѹ뤳ȤϤǤ뤬
եɲáԤȤϤǤʤ
.SS ޥȥץ
.TP
.B uid=<uid>
ޥȥݥȤͭ桼ꤹ롣
ǥեȤ 0 (root) Ǥ롣
.TP
.B gid=<gid>
ޥȥݥȤͭ륰롼פꤹ롣
ǥեȤ 0 (root) Ǥ롣
.SS ե
.I spufs
ΥեϡۤȤɤξ
.BR read (2)

.BR write (2)
Ȥä̾ΥƥॳФɸŪʿ񤤤򼨤
¿ξ̾Υե륷ƥǥݡȤƤΰʬ
ݡȤƤ롣ʲΥꥹȤǤϡݡȤƤ
줾Υޥ˥奢ڡ˽񤫤ƤɸŪʿ񤤤Ȥΰ㤤
Ĥ롣

.BR read (2)
бƤƤΥե
.BR readv (2)
ˤбƤ롣ޤ
.BR write (2)
бƤƤΥե
.BR writev (2)
ˤбƤ롣

ƤΥեϡ
.BR access (2)

.BR stat (2)
ϤбƤ뤬
.BR stat (2)
ǤϡƤӽФݤ֤
.I stat
¤ΤΥեɤΤǤäƤΤ
.IR st_mode ,
.IR st_nlink ,
.IR st_uid ,
.I st_gid
Ǥ롣

ƤΥե
.BR chmod (2)/ fchmod (2)

.BR chown (2)/ fchown (2)
бƤ뤬
Υե뤬бƤ̷⤹륢Ĥ
Ϳ뤳ȤϤǤʤ (㤨С
.I wbox
եФɤ߽Фʤ)

ǤΥեϰʲ̤Ǥ롣
.TP
.B /mem
SPU Υ륹ȥ졼ơ
Υե̾ζͭեƱͤ˥Ǥ
SPU Υɥ쥹֤ˤϥɤȥǡξǼǤ롣
ץ󤵤줿
.I mem
ե˲ǽϰʲǤ롣
.RS
.TP
.BR read "(2), " pread "(2), " write "(2), " pwrite "(2), " lseek (2)
̤̾ư뤬
եۤƤ
.BR lseek (2),
.BR write (2),
.BR pwrite (2)
бƤʤۤʤ롣
ե륵 SPU Υ륹ȥ졼ΥǤꡢ
̾ 256 ХȤǤ롣
.TP
.BR mmap (2)
.I mem
ץΥɥ쥹֤˥ޥåԥ󥰤ȡ
ץΥɥ쥹֤ΰȤ
SPU Υ롦ȥ졼˥Ǥ褦ˤʤ롣
.RE
.TP
.B /mbox
SPU  CPU ؤ̿ѤΰܤΥ᡼ܥå
Υեɤ߽ФѤǡɤ߽Ф 32ӥåñ̤ǹԤ
Υե (non-blocking) ⡼ɤǤΤ߻ѤǤ
.BR poll (2)
ǤäƤ⤳Υե (block) 뤳ȤϤʤ
ץ󤵤줿
.I mbox
ե˲ǽϰʲǤ롣
.RS
.TP
.BR read (2)
.I count
 4 꾮硢
.BR read (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
᡼ܥå˥ǡʤ硢\-1 ֤ꡢ
.I errno

.B EAGAIN
ꤵ롣ǡɤ߽Ф硢
4 ХȤǡХåե˳Ǽ졢֤ͤȤ 4 ֤롣
.RE
.TP
.B /ibox
SPU  CPU ؤ̿ѤܤΥ᡼ܥåǤ롣
ΥեϰܤΥ᡼ܥåեȻƤ뤬
 (blocking) I/O ⡼ɤǤɤ߽ФǽǤ롣äơ
.BR poll (2)
ƱͤΥƥॳȤäơΥեƻ뤹뤳ȤǤ롣
ץ󤵤줿
.I ibox
ե˲ǽϰʲǤ롣
.RS
.TP
.BR read (2)
.I count
 4 꾮硢
.BR read (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
᡼ܥå˥ǡʤ硢եǥץ
.B O_NONBLOCK
ǥץ󤵤ƤС֤ͤ \-1 Ȥʤꡢ
.I errno

.B EAGAIN
ꤵ롣

᡼ܥå˥ǡʤǡեǥץ
.B O_NONBLOCK
ʤǥץ󤵤ƤС
SPU ʬγߥ᡼ܥåͥ (interrupt mailbox channel)
˽񤭹ߤԤޤ
.BR read (2)
 (block) 롣
ǡɤ߽Ф硢
4 ХȤǡХåե˳Ǽ졢֤ͤȤ 4 ֤롣
.TP
.BR poll (2)
.I ibox
եФ
.BR poll (2)
ϡɤ߽ФǡѲǽˤʤ٤
.I "(POLLIN | POLLRDNORM)"
֤
.RE
.TP
.B /wbox
CPU  SPU ؤ̿ѤΥ᡼ܥå
ΥեϽ񤭹Ѥǡ񤭹ߤ 32ӥåñ̤ǹԤ
᡼ܥåդξ硢
.BR write (2)
 (block) 
.BR poll (2)
Ȥäƥ᡼ܥå˺ٶǤޤԤĤȤǤ롣
ץ󤵤줿
.I wbox
ե˲ǽϰʲǤ롣
.RS
.TP
.BR write (2)
.I count
 4 꾮硢
.BR write (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
᡼ܥå˶ΰ褬ʤ硢եǥץ
.B O_NONBLOCK
ǥץ󤵤ƤС֤ͤ \-1 Ȥʤꡢ
.I errno

.B EAGAIN
ꤵ롣

᡼ܥå˶ΰ褬ʤǡեǥץ
.B O_NONBLOCK
ʤǥץ󤵤ƤС
SPU ʬ PPE ᡼ܥåͥ뤫ɤ߽ФԤޤ
.BR write (2)
 (block) 롣
ǡν񤭹ߤ硢֤ͤȤ 4 ֤롣
.TP
.BR poll (2)
.I wbox
եФ
.BR poll (2)
ϡ񤭹Ѥζ֤Ѳǽˤʤ٤
.I "(POLLOUT | POLLWRNORM)"
֤
.RE
.TP
.BR /mbox_stat ", " /ibox_stat ", " /wbox_stat
Υեɤ߽ФѤǡ
ƥ᡼ܥåθߤΥ塼Ĺݻ롣
Ūˤϡ (blocking) ˡ
.IR mbox "  " ibox
鲿ɤɤ߽ФȤǤ
.I wbox
˲ɤ񤭹ळȤǤ뤫ȤȤǤ롣
Υե 4 Хñ̤ǤΤɤ߽Фǽǡ
ӥåǥ֤ͤ
ץ󤵤줿
.I *box_stat
ե˲ǽϰʲǤ롣
.RS
.TP
.BR read (2)
.I count
 4 꾮硢
.BR read (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
ʳξ硢ǡХåե 4 ХȤͤ񤭹ޤ롣
ͤϡƥ᡼ܥåˤߤˡޤ
.B EAGAIN
顼ʤǡɤ߽Фǽʥȿ
.RI ( mbox_stat

.I ibox_stat
ξ)񤭹߲ǽʥȿ
.RI ( wbox_stat
ξ) Ǥ롣
.RE
.TP
.BR /npc ", " /decr ", " /decr_status ", " /spu_tag_mask ", " \
/event_mask ", " /srr0
Υե SPU 쥸ΤǤ롣
ͤϡƥ쥸οͤޤॢʸɽ롣
ΥեϥǥХåѤȤɤ߽Ф/񤭹ߤξ⡼ɤѤǤ뤬
ץ̾ϤΥե˰¸٤ǤϤʤ
ʤʤ顢ΥեΤ
.I npc
ʳؤΥǤ SPU ƥȤ¸ɬܤǤꡢ
SPU ƥȤ¸˸ΨǤ롣
.IP
ΥեƤϰʲ̤ꡣ
.RS
.TP 16
.I npc
Υץ५
.TP
.I decr
SPU Decrementer
.TP
.I decr_status
Decrementer ξ
.TP
.I spu_tag_mask
SPU  DMA Ѥ MFA ޥ
.TP
.I event_mask
SPU γߤΥ٥ȥޥ
.TP
.I srr0
ߥ꥿󥢥ɥ쥹쥸
.RE
.IP
ΥեФƲǽϰʲǤ롣
.RS
.TP
.BR read (2)
.BR read (2)
Ϥ줿
.I count
쥸ͤȲ (newline) ʸ 1 ĤǼΤɬפĹû硢
Ʊեǥץ³ read 뤳ȤǡʸΤɤ߽Ф
Ǥ롣κݡ¹ SPU ˤ쥸ͤѹαƶϼʤ
ʸΤɤ߽Фȡʹߤ read Ǥ 0 ХȤ֤졢
ͤɤ߽ФˤϿեǥץ򥪡ץ󤹤ɬפ롣
.TP
.BR write (2)
Υեؤ
.BR write (2)
ϥ쥸ͤʸǻꤵ줿ͤꤹ롣
ʸβƬ鳫Ϥ졢ʳʸо줹뤫
ХåեãޤǹԤ롣
Ʊեǥץ³ write Ԥȡ
 write ˤ꤬񤭤롣
.RE
.TP
.B /fpcr
Υեˤ Floating Point Status and Control Register 
Ǥ롣Υե礭 4 ХȤǤ롣
.I fpcr
ե˲ǽϰʲǤ롣
.RS
.TP
.BR read (2)
.I count
 4 꾮硢
.BR read (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
ʳξ硢ǡХåե 4 ХȤͤ񤭹ޤ롣
񤭹ޤͤ
.I fpcr
쥸θߤͤǤ롣
.TP
.BR write (2)
.I count
 4 꾮硢
.BR write (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
ʳξ硢 4 ХȤͤǡХåե饳ԡ졢
.I fpcr
쥸ͤ롣
.RE
.TP
.BR /signal1 ", " /signal2
Υեˤ
SPU ĤΥʥΥͥ (signal notification channel) 
Ǥ롣
 32 ӥåñ̤ɤ߽񤭤Ǥ롣
ΥեΰĤ˽񤭹ߤԤȡ SPU γߤ
ȯȥꥬȤʤ롣
ʥեؽ񤭹ޤ줿ͤϡͥͳ SPU ɤ߽Фꡢ
ΥեͳǥۥȤΥ桼֤ɤ߽ФǤ롣
SPU ͤɤ߽ФǤϡͤ 0 ˥ꥻåȤ롣
ץ󤵤줿
.I signal1

.I signal2
ե˲ǽϰʲǤ롣
.RS
.TP
.BR read (2)
.I count
 4 꾮硢
.BR read (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
ʳξ硢ǡХåե 4 ХȤͤ񤭹ޤ롣
񤭹ޤͤϡꤵ줿ʥΥ쥸θߤͤǤ롣
.TP
.BR write (2)
.I count
 4 꾮硢
.BR write (2)
 \-1 ֤
.I errno

.B EINVAL
ꤹ롣
ʳξ硢 4 ХȤͤǡХåե饳ԡ졢
ꤵ줿ʥΥ쥸ͤ롣
ʥΥ쥸ιˤϡ쥸ͤϥǡ֤⡼ɤ
ͤϥǡΥӥåñ̤ OR Ȥäͤ˹⡼ɤ롣
ɤΥ⡼ɤˤʤ뤫ϡ줾
.IR signal1_type ,
.I signal2_type
եƤˤäƷޤ롣
.RE
.TP
.BR /signal1_type ", " /signal2_type
ΥեϡʥΥե
.I signal1

.I signal2
ưѹ롣
ΥեϿͤɽʸݻ
ɤ߽Ф "1"  "0" Τɤ餫롣
⡼ 0 (񤭥⡼) ǤϡϡɥϥʥͥƤ
ʥͥ˽񤭹ޤ줿ǡ֤롣
⡼ 1 ( OR ⡼) Ǥϡϡɥϥʥͥ
񤭹ޤ줿ӥåȤѻƤ
ץ󤵤줿
.I signal1_type

.I signal2_type
ե˲ǽϰʲǤ롣
.RS
.TP
.BR read (2)
.BR read (2)
Ϥ줿
.I count
쥸οͤȲ (newline) ʸ 1 ĤǼΤɬפĹ
û硢Ʊեǥץ³ read 뤳Ȥǡ
ʸΤɤ߽ФȤǤ롣
ʸΤɤ߽Фȡʹߤ read Ǥ 0 ХȤ֤졢
ͤɤ߽ФˤϿեǥץ򥪡ץ󤹤ɬפ롣
.TP
.BR write (2)
Υեؤ
.BR write (2)
ϥ쥸ͤʸǻꤵ줿ͤꤹ롣
ʸβƬ鳫Ϥ졢ʳʸо줹뤫
ХåեãޤǹԤ롣
Ʊեǥץ³ write Ԥȡ
 write ˤ꤬񤭤롣
.RE
.SH 
.TP
.IR /etc/fstab "  entry"
none  	/spu  	spufs  	gid=spu  	0	0
.\" .SH AUTHORS
.\" Arnd Bergmann <arndb@de.ibm.com>,
.\" Mark Nutter <mnutter@us.ibm.com> and
.\" Ulrich Weigand <Ulrich.Weigand@de.ibm.com>
.SH Ϣ
.BR close (2),
.BR spu_create (2),
.BR spu_run (2)