Man page - s390_sthyi(2)

Packages contains this manual

Available languages:

en fr ru ro

Manual

s390_sthyi

НАИМЕНОВАНИЕ
БИБЛИОТЕКА
ОБЗОР
ОПИСАНИЕ
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
ОШИБКИ
СТАНДАРТЫ
ИСТОРИЯ
ПРИМЕЧАНИЯ
СМОТРИТЕ ТАКЖЕ
ПЕРЕВОД

НАИМЕНОВАНИЕ

s390_sthyi - эмулирует инструкцию STHYI

БИБЛИОТЕКА

Стандартная библиотека языка C ( libc , -lc )

ОБЗОР

#include <asm/sthyi.h> /* определения констант STHYI_* */
#include <sys/syscall.h>
/* определения констант SYS_* */
#include <unistd.h>

int syscall(SYS_s390_sthyi, unsigned long function_code ,
void *
resp_buffer , uint64_t * return_code ,
unsigned long
flags );

Примечание : glibc не предоставляет оболочку для s390_sthyi (), что требует использования syscall (2).

ОПИСАНИЕ

Системный вызов s390_sthyi () эмулирует инструкцию STHYI (Store Hypervisor Information). Он предоставляет информацию о ресурсах машины и её уровни виртуализации. В частности, возвращается тип ЦП и ёмкость, а также модель машины и другие свойства.

В аргументе function_code указывается какую функцию нужно выполнить. Поддерживаются следующие коды:
STHYI_FC_CP_IFL_CAP

Вернуть информацию о CP (Central Processor) и ёмкости IFL (Integrated Facility for Linux).

В аргументе resp_buffer указывается адрес буфера результата. При function_code равном STHYI_FC_CP_IFL_CAP , размер буфера должен быть равен странице (4K). Если системный вызов вернул 0, то буфер результата будет заполнен информацией о ёмкости ЦП. В противном случае содержимое буфера результата не меняется.

В аргументе return_code хранится код возврата инструкции STHYI; возможно одно из следующих значений:

0

Успешно.

4

Неподдерживаемый код функции.

Дополнительную информацию о return_code , function_code и resp_buffer смотрите по ссылкам, приведённым в ЗАМЕЧАНИЯХ.

Аргумент flags предназначен для будущих расширений, а пока его значение должно быть равно 0.

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

При успешном выполнении (т. е. эмуляция прошла успешно), возвращаемое s390_sthyi () значение совпадает с кодом условия инструкций STHYI — значением в диапазоне [0..3]. Возвращаемое значение 0 означает, что информация о ёмкости ЦП сохранена в *resp_buffer . Возвращаемое значение 3 указывает на «неподдерживаемый код функции» и содержимое *resp_buffer не изменяется. Значения 1 и 2 зарезервированы.

В случае ошибки возвращается -1, а errno устанавливается в значение ошибки.

ОШИБКИ

EFAULT

Значение, указанное в resp_buffer или return_code , содержит некорректный адрес.

EINVAL

Значение, указанное в flags , не равно нулю.

ENOMEM

Не удалось выделить память для обработки информации о ёмкости ЦП.

EOPNOTSUPP

Некорректное значение в function_code .

СТАНДАРТЫ

Linux на s390.

ИСТОРИЯ

Linux 4.15.

ПРИМЕЧАНИЯ

Описание инструкции STHYI смотрите на странице документации .

При использовании интерфейса системного вызова буфер результата не имеет требований по выравниванию, описанных в инструкции STHYI.

Ядро кэширует результат (в Linux 4.16 каждую секунду). Последующие запуски системного вызова могут вернуть кэшированный ответ.

СМОТРИТЕ ТАКЖЕ

syscall (2)

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) 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> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков .