Scroll to navigation

SPU_RUN(2) Руководство программиста Linux SPU_RUN(2)

ИМЯ

spu_run - выполняет контекст SPU

СИНТАКСИС

#include <sys/spu.h>
int spu_run(int fd, unsigned int *npc, unsigned int *event);

Замечание: В glibc нет обёрточной функции для данного системного вызова; смотрите ЗАМЕЧАНИЯ.

ОПИСАНИЕ

Системный вызов spu_run() используется на машинах PowerPC с архитектурой Cell Broadband Engine для получения доступа к Synergistic Processor Unit (SPU). Аргумент fd представляет собой файловый дескриптор, возвращаемый вызовом spu_create(2) и указывающий на определённый контекст SPU. Когда контекст планируется на физическом SPU, он запускается на выполнение начиная с инструкции, на которую указывает значение npc.

Выполнение кода SPU происходит синхронно, то есть spu_run() блокируется на время работы SPU. Если требуется параллельное выполнение кода SPU и кода на основном процессоре или других SPU, то сначала нужно создать новую нить выполнения (например с помощью pthread_create(3)).

При завершении работы spu_run() текущее значение программного счётчика SPU записывается в npc, что позволяет использовать тот же указатель npc в последующих вызовах spu_run().

В аргументе event указывается буфер для расширенного кода состояния. Если контекст SPU создан с флагом SPU_CREATE_EVENTS_ENABLED, то ядро Linux заполняет этот буфер перед возвратом из spu_run().

Код состояния может быть одной (или несколькими) из следующих констант:

Произошла ошибка выравнивания DMA.
Попытка выполнить неверную команду MFC DMA.
Произошла ошибка хранилища DMA.
Выполнена недопустимая инструкция.

Для аргумента event допускается значение NULL. В этом случае информация о событиях не будет поступать в вызывающий процесс.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении spu_run() возвращается значение регистра spu_status. При ошибке возвращается -1, а в errno содержится один из кодов ошибки, описанных далее.

Значение регистра spu_status представляет собой битовую маску кодов состояния и необязательный 14-битный код, возвращаемый при выполнении инструкции stop-and-signal SPU. Битовые маски кодов состояний:

0x02
SPU остановлен инструкцией stop-and-signal.
0x04
SPU остановлен инструкцией halt.
0x08
SPU ожидает канала.
0x10
SPU в пошаговом режиме.
0x20
SPU пытался выполнить неверную инструкцию.
0x40
SPU пытался получить доступ к неверному каналу.
0x3fff0000
При наложении этой маски получается код, возвращаемый инструкцией stop-and-signal. Полученные биты корректны только, если установлен бит 0x02.

Если spu_run() не вернул ошибку, то один или более младших восьми битов всегда установлены.

ОШИБКИ

Значение fd не является правильным файловым дескриптором.
Задан неправильный указатель в npc или значение event не равно NULL и является неправильным указателем.
При выполнении spu_run() получен сигнал; см. signal(7). При необходимости, значение npc обновляется до нового значения программного счётчика.
Значение fd не является правильным файловым дескриптором, возвращённым spu_create(2).
Недостаточно памяти для обработки страничного сбоя в результате прямого доступа Memory Flow Controller (MFC).
Возможность не предоставляется текущей системой, так как или аппаратура не предоставляет SPU, или не загружен модуль spufs.

ВЕРСИИ

Системный вызов spu_run() был добавлен в ядро Linux версии 2.6.16.

СООТВЕТСТВИЕ СТАНДАРТАМ

Данный вызов существует только в Linux и реализован только для архитектуры PowerPC. Программы, использующие данный вызов, не переносимы.

ЗАМЕЧАНИЯ

В glibc нет обёртки для этого системного вызова; запускайте его с помощью syscall(2). Однако заметим, что spu_run() предназначен для работы в библиотеках, которые реализуют более абстрактный интерфейс к SPU и не должен вызываться из обычных приложений. Рекомендуемые библиотеки приведены на странице http://www.bsc.es/projects/deepcomputing/linuxoncell/.

ПРИМЕРЫ

В следующем примере реализована простая программа, состоящая из одной инструкции SPU и системного вызова spu_run().

#include <stdlib.h>
#include <stdint.h>
#include <unistd.h>
#include <stdio.h>
#include <sys/types.h>
#include <fcntl.h>
#define handle_error(msg) \


    do { perror(msg); exit(EXIT_FAILURE); } while (0)
int main(void)
{


    int context, fd, spu_status;


    uint32_t instruction, npc;


    context = spu_create("/spu/example-context", 0, 0755);


    if (context == -1)


        handle_error("spu_create");


    /* записать инструкцию 'stop 0x1234' в локальное хранилище


       памяти SPU


     */


    instruction = 0x00001234;


    fd = open("/spu/example-context/mem", O_RDWR);


    if (fd == -1)


        handle_error("open");


    write(fd, &instruction, sizeof(instruction));


    /* присвоить npc адрес начальной инструкции программы


     * SPU. Так как мы записали инструкцию в начало


     * файла mem, точка входа будет равна 0x0


     */


    npc = 0;


    spu_status = spu_run(context, &npc, NULL);


    if (spu_status == -1)


        handle_error("open");


    /* мы должны получить код состояния 0x1234002:


     *   0x00000002 (spu остановлен из-за stop-and-signal)


     * | 0x12340000 (код stop-and-signal)


     */


    printf("Состояние SPU: %#08x\n", spu_status);


    exit(EXIT_SUCCESS);
}

СМ. ТАКЖЕ

close(2), spu_create(2), capabilities(7), spufs(7)

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.

1 ноября 2020 г. Linux