L'appel système
spu_create()
est utilisé sur les machines PowerPC à base de processeur
« Cell Broadband Engine » afin d'accéder aux unités synergiques SPU
(Synergistic Processor Units).
Il crée un nouveau contexte pour une SPU dans le répertoire
pathname
et renvoie un descripteur de fichier associé à ce répertoire.
pathname
doit faire référence à un réportoire inexistant sur le point de montage
du système de fichier des SPU
(spufs).
Si
spu_create()
réussit, un répertoire est créé dans
pathname
et est rempli avec les fichiers décrits dans
spufs(7).
Lorsqu'un contexte est créé, le descripteur de fichier
ne peut qu'être passé à
spu_run(2),
utilisé comme l'argument
dirfd
pour les appels système de la famille
*at
(par exemple,
openat(2)),
ou fermé ;
d'autres opérations ne sont pas définies.
Un contexte logique SPU est détruit
(avec tous les fichiers créés dans le répertoire
pathname
du contexte) lorsque la dernière référence au contexte a disparu ;
cela survient généralement lorsque le descripteur de fichier renvoyé par
spu_create()
est fermé.
L'argument
flags
peut être nul ou tout combinaison de OU bit à bit
des constantes suivantes :
-
- SPU_CREATE_EVENTS_ENABLED
-
Plutôt que d'utiliser des signaux pour signaler des erreurs DMA,
utiliser l'argument
event
de
spu_run(2).
-
- SPU_CREATE_GANG
-
Créer un gang SPU plutôt qu'un contexte.
(Un gang est un groupe de contextes SPU qui sont en relation fonctionnelle
entre eux et qui partagent des paramètres d'ordonnancement communs
--- priorité et politique.
Dans le futur, l'ordonnancement de gangs pourra être implémenté
faisant que le groupe soit commuté comme une unité simple.)
Un nouveau répertoire sera créé à l'endroit spécifié par l'argument
pathname.
Le gang peut être utilisé pour tenir d'autres contextes en fournissant un
nom de chemin qui soit à l'intérieur du répertoire du gang pour des
appels ultérieurs à
spu_create().
-
- SPU_CREATE_NOSCHED
-
Crée un contexte qui ne soit pas affecté par l'ordonnanceur SPU.
Une fois que le contexte est lancé, il ne sera pas déplanifié jusqu'à
ce qu'il soit détruit par le processus créateur.
Parce que le contexte ne peut pas être supprimé de la SPU, certaines
fonctionnalités sont désactivées des contextes
SPU_CREATE_NOSCHED.
Seul un sous-ensemble de fichiers sera disponible dans le répertoire
du contexte sur le système de fichiers
spufs.
De plus, les contextes
SPU_CREATE_NOSCHED
ne peuvent pas créer de fichier de vidage lors d'un plantage.
La création de contextes
SPU_CREATE_NOSCHED
nécessite la capacité
CAP_SYS_NICE.
-
- SPU_CREATE_ISOLATE
-
Crée un contexte SPU isolé.
Les contextes isolés sont protégés de certaines opérations PPE
(PowerPC Processing Element), comme l'accès au stockage local de la SPU
ou au registre NPC.
La création de contextes
SPU_CREATE_ISOLATE
nécessite également l'attribut
SPU_CREATE_NOSCHED.
-
- SPU_CREATE_AFFINITY_SPU
-
Crée un contexte avec l'affinité d'un autre contexte SPU.
Cette information d'affinité est utilisée dans l'algorithme
d'ordonnancement de la SPU.
L'utilisation de cet attribut nécessite que le descripteur de fichier
référencant l'autre contexte SPU soit passé dans l'argument
neighbor_fd.
-
- SPU_CREATE_AFFINITY_MEM
-
Crée un contexte avec l'affinité de la mémoire système.
Cette information d'affinité est utilisée dans l'algorithme
d'ordonnancement de la SPU.
L'argument
mode
(moins les bits positionnés dans
l'umask(2)
du processus) spécifie les permissions utilisées pour créer le nouveau
répertoire sur le système de fichier
spufs.
Voir
stat(2)
pour une liste complète des valeurs de
mode.