.\" -*- coding: UTF-8 -*- .\" 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 s390_sthyi 2 "17 мая 2025 г." "Справочные страницы Linux 6.15" .SH НАИМЕНОВАНИЕ s390_sthyi \- эмулирует инструкцию STHYI .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH ОБЗОР .nf \fB#include \fP /* определения констант \fBSTHYI_*\fP */ \fB#include \fP /* определения констант \fBSYS_*\fP */ \fB#include \fP .P \fBint syscall(SYS_s390_sthyi, unsigned long \fP\fIfunction_code\fP\fB,\fP \fB void *\fP\fIresp_buffer\fP\fB, uint64_t *\fP\fIreturn_code\fP\fB,\fP \fB unsigned long \fP\fIflags\fP\fB);\fP .fi .P \fIПримечание\fP: glibc не предоставляет оболочку для \fBs390_sthyi\fP(), что требует использования \fBsyscall\fP(2). .SH ОПИСАНИЕ Системный вызов \fBs390_sthyi\fP() эмулирует инструкцию STHYI (Store Hypervisor Information). Он предоставляет информацию о ресурсах машины и её уровни виртуализации. В частности, возвращается тип ЦП и ёмкость, а также модель машины и другие свойства. .P В аргументе \fIfunction_code\fP указывается какую функцию нужно выполнить. Поддерживаются следующие коды: .TP \fBSTHYI_FC_CP_IFL_CAP\fP Вернуть информацию о CP (Central Processor) и ёмкости IFL (Integrated Facility for Linux). .P В аргументе \fIresp_buffer\fP указывается адрес буфера результата. При \fIfunction_code\fP равном \fBSTHYI_FC_CP_IFL_CAP\fP, размер буфера должен быть равен странице (4K). Если системный вызов вернул 0, то буфер результата будет заполнен информацией о ёмкости ЦП. В противном случае содержимое буфера результата не меняется. .P В аргументе \fIreturn_code\fP хранится код возврата инструкции STHYI; возможно одно из следующих значений: .TP 0 Успешно. .TP 4 Неподдерживаемый код функции. .P Дополнительную информацию о \fIreturn_code\fP, \fIfunction_code\fP и \fIresp_buffer\fP смотрите по ссылкам, приведённым в ЗАМЕЧАНИЯХ. .P Аргумент \fIflags\fP предназначен для будущих расширений, а пока его значение должно быть равно 0. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении (т. е. эмуляция прошла успешно), возвращаемое \fBs390_sthyi\fP() значение совпадает с кодом условия инструкций STHYI — значением в диапазоне [0..3]. Возвращаемое значение 0 означает, что информация о ёмкости ЦП сохранена в \fI*resp_buffer\fP. Возвращаемое значение 3 указывает на «неподдерживаемый код функции» и содержимое \fI*resp_buffer\fP не изменяется. Значения 1 и 2 зарезервированы. .P В случае ошибки возвращается \-1, а \fIerrno\fP устанавливается в значение ошибки. .SH ОШИБКИ .TP \fBEFAULT\fP Значение, указанное в \fIresp_buffer\fP или \fIreturn_code\fP, содержит некорректный адрес. .TP \fBEINVAL\fP Значение, указанное в \fIflags\fP, не равно нулю. .TP \fBENOMEM\fP Не удалось выделить память для обработки информации о ёмкости ЦП. .TP \fBEOPNOTSUPP\fP Некорректное значение в \fIfunction_code\fP. .SH СТАНДАРТЫ Linux на s390. .SH ИСТОРИЯ Linux 4.15. .SH ПРИМЕЧАНИЯ Описание инструкции STHYI смотрите на .UR https://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm странице документации .UE . .P При использовании интерфейса системного вызова буфер результата не имеет требований по выравниванию, описанных в инструкции STHYI. .P Ядро кэширует результат (в Linux 4.16 каждую секунду). Последующие запуски системного вызова могут вернуть кэшированный ответ. .SH "СМОТРИТЕ ТАКЖЕ" \fBsyscall\fP(2) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Alexander Golubev , Azamat Hackimov , Hotellook, Nikita , Spiros Georgaras , Vladislav , Yuri Kozlov , Иван Павлов и Kirill Rekhov . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .