.\" -*- coding: UTF-8 -*- .\" Copyright 2006, International Business Machines Corp. .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH spu_create 2 "8. februar 2026" "Linux man\-pages 6.18" .SH NAVN spu_create \- opret en ny spu\-kontekst .SH BIBLIOTEK Standard C library (\fIlibc\fP,\ \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP /* Definition af \fBSPU_*\fP\-konstanter */ \fB#include \fP /* Definition af \fBSYS_*\fP\-konstanter */ \fB#include \fP .P \fBint syscall(SYS_spu_create, const char *\fP\fIpath\fP\fB, unsigned int \fP\fIflag\fP\fB,\fP \fB mode_t \fP\fImode\fP\fB, int \fP\fIneighbor_fd\fP\fB);\fP .fi .P \fIBemærk\fP: glibc tilbyder intet omslag for \fBspu_create\fP(), hvilket nødvendiggør brugen af \fBsyscall\fP(2). .SH BESKRIVELSE Systemkaldet \fBspu_create\fP() bruges på PowerPC\-maskiner, der implementerer Cell Broadband Engine Architecture for at tilgå Synergistic Processor Units (SPU'er. Opretter en ny logisk kontekst for en SPU i \fIsti\fP og returnerer en fildeskriptor associeret med den. \fIsti\fP skal referere til en ikkeeksisterende mappe på monteringspunktet for SPU\-filsystemet (\fBspufs\fP). Hvis \fBspu_create\fP() er succesfuld så oprettes en mappe på \fIsti\fP og udfyldes med filerne beskrevet i \fBspufs\fP(7). .P Når en kontekst oprettes kan den returnerede fildeskriptor kun sendes til \fBspu_run\fP(2), brugt som argumentet \fIdirfd\fP til \fB*at\fP\-systemkaldsfamilien (f.eks. \fBopenat\fP(2)), eller lukket; andre operationer er ikke defineret. En logisk SPU\-kontekst ødelægges (sammen med alle filer oprettet i kontekstens \fIsti\fP\-mappe) når først den sidste reference til konteksten er væk; dette sker normalt når fildeskriptoren returneret af \fBspu_create\fP() lukkes. .P Argumentet \fImode\fP (minus bit angivet i processens \fBumask\fP(2)) angiver rettighederne brugt til at oprette den nye mappe i \fBspufs\fP. Se \fBstat\fP(2) for en fuld liste over muligt \fImode\fP\-værdier. .P \fIneighbor_fd\fP bruges kun når flaget \fBSPU_CREATE_AFFINITY_SPU\fP er angivet; se nedenfor. .P Argumentet \fIflag\fP kan være nul eller enhver bitwise OR\-ed kombination af de følgende konstanter: .TP \fBSPU_CREATE_EVENTS_ENABLED\fP Frem for at bruge signaler til at rapportere DMA\-fejl, så brug \fIevent\fP\-argumentet for \fBspu_run\fP(2). .TP \fBSPU_CREATE_GANG\fP Opret en SPU\-gang i stedet for en kontekst. (En gang er en gruppe af SPU\-kontekster der er funktionelt relateret til hinanden og der deler fælles planlægningsparametre\[em]prioritet og politik. I fremtiden kan gang\-planlægning måske blive implementeret som medførende at gruppen skiftes ind og ud som en enkelt enhed). .IP En ny mappe vil blive oprettet på placeringen angivet af \fIsti\fP\-argumentet. Denne gang kan bruges til at indeholde andet SPU\-indhold, ved at tilbyde et stinavn der er i gang\-mappen for yderligere kald til \fBspu_create\fP(). .TP \fBSPU_CREATE_NOSCHED\fP Opret en kontekst der ikke er påvirket af SPU\-planlæggeren. Når konteksten er afviklet, så vil den ikke blive planlagt, indtil den er ødelagt af den skabende proces. .IP Da konteksten ikke kan fjernes fra SPU'en, så bliver nogen funktionalitet deaktiveret for \fBSPU_CREATE_NOSCHED\fP\-konteksterne. Kun et undersæt af filerne vil være tilgængelige i denne kontekstmappe i \fBspufs\fP. Derudover kan \fBSPU_CREATE_NOSCHED\fP\-kontekster ikke dumpe en kernefil, når den går ned. .IP Oprettelse af \fBSPU_CREATE_NOSCHED\fP\-kontekster kræver \fBCAP_SYS_NICE\fP\-funktionaliteten. .TP \fBSPU_CREATE_ISOLATE\fP Opret en isoleret SPU\-kontekst. Isolerede kontekster er beskyttet fra nogle PPE\-operationer (PowerPC Processing Element), såsom adgang til SPU'ets lokale lager og NPC\-registeret. .IP Opretttelse af \fBSPU_CREATE_ISOLATE\fP\-kontekster kræver også flaget \fBSPU_CREATE_NOSCHED\fP. .TP \fBSPU_CREATE_AFFINITY_SPU\fP (siden Linux 2.6.23) .\" commit 8e68e2f248332a9c3fd4f08258f488c209bd3e0c Opret en kontekst med affinitet til en anden SPU\-kontekst. Denne affinitet\-information bruges i SPU\-planlægningsalgoritmen. Brug af dette flag kræver at en fildeskriptor, der refererer til den anden SPU\-kontekst sendes til argumentet \fIneighbor_fd\fP. .TP \fBSPU_CREATE_AFFINITY_MEM\fP (siden Linux 2.6.23) .\" commit 8e68e2f248332a9c3fd4f08258f488c209bd3e0c Opret en kontekst med affinitet til systemhukommelsen. Denne affinitet\-information bruges i SPU\-planlægningsalgoritmen. .SH RETURVÆRDI Ved succes returnerer \fBspu_create\fP() en ny fildeskriptor. Ved fejl returneres \-1 og \fIerrno\fP angives for at indikere fejlen. .SH FEJL .TP \fBEACCES\fP Den nuværende bruger har ikke skriveadgang til monteringspunktet for \fBspufs\fP(7). .TP \fBEEXIST\fP En SPU\-kontekst findes allerede på det angivne stinavn. .TP \fBEFAULT\fP \fIsti\fP er ikke en gyldig strengpeger i den kaldende proces' adressserum. .TP \fBEINVAL\fP \fIsti\fP er ikke en mappe i monteringspunktet \fBspufs\fP(7), eller ugyldige flag er blevet angivet. .TP \fBELOOP\fP For mange symbolske henvisninger blev fundet under opslaget af \fIsti\fP. .TP \fBEMFILE\fP Begrænsningen per proces for antallet af åbne fildeskriptorer er blevet nået. .TP \fBENAMETOOLONG\fP \fIsti\fP er for lang. .TP \fBENFILE\fP Systemets begrænsning på det samlede antal åbne filer er nået. .TP \fBENODEV\fP Der blev anmodt om en isoleret kontekst, mne udstyret understøtter ikke SPU\-isolering. .TP \fBENOENT\fP En del af \fIsti\fP kunne ikke slås op. .TP \fBENOMEM\fP Kernen kunne ikke allokere alle de krævede ressourcer. .TP \fBENOSPC\fP Der er ikke nok SPU\-ressourcer tilgængelige til at oprette en ny kontekst eller den brugerspecifikke begrænsning for antallet af SPU\-kontekster er blevet nået. .TP \fBENOSYS\fP Funktionaliteten er ikke tilbudt af det nuværende system, da hverken udstyret tilbyder SPU'er eller spufs\-modulet er indlæst. .TP \fBENOTDIR\fP En del af \fIsti\fP er ikke en mappe. .TP \fBEPERM\fP Flaget \fBSPU_CREATE_NOSCHED\fP er angivet, men brugeren har ikke \fBCAP_SYS_NICE\fP\-funktionaliteten. .SH FILER \fIsti\fP skal pege på en placering under monteringspunktet for \fBspufs\fP. Efter konventionen bliver den monteret i \fI/spu\fP. .SH STANDARDER Linux på PowerPC. .SH HISTORIK Linux 2.6.16. .P Før tilføjelsen af flaget \fBSPU_CREATE_AFFINITY_SPU\fP i Linux 2.6.23 brugte systemkaldet \fBspu_create\fP() kun tre tre argumenter (dvs. der var ikke et \fIneighbor_fd\fP\-argument). .SH NOTER \fBspu_create\fP() er lavet til brug fra biblioteker, der implementerer en mere abstrakt grænseflade til SPU'er, ikke til brug fra normale programmer. Se .UR http:\://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/ .UE for anbefalede biblioteker. .SH EKSEMPLER Se \fBspu_run\fP(2) for et eksempel på brugen af \fBspu_create\fP() .SH "SE OGSÅ" \fBclose\fP(2), \fBspu_run\fP(2), \fBcapabilities\fP(7), \fBspufs\fP(7) .PP .SH OVERSÆTTELSE Oversættere af denne manual til dansk Joe Hansen . .PP Denne oversættelse er gratis dokumentation; læs .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE eller nyere for ophavsretbetingelser. Der er INGEN ANSVAR. .PP Hvis du støder på fejl i oversættelsen af ​​denne vejledning, skal du sende en besked til .MT debian-l10n-danish@lists.debian.org .ME .