.\" -*- coding: UTF-8 -*- .\" Copyright IBM Corp. 2017 .\" Author: QingFeng Hao .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH s390_sthyi 2 "30 марта 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ s390_sthyi \- эмулирует инструкцию STHYI .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP /* определения констант \fBSTHYI_*\fP */ \fB#include \fP /* определения констант \fBSYS_*\fP */ \fB#include \fP .PP \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 .PP \fINote\fP: glibc provides no wrapper for \fBs390_sthyi\fP(), necessitating the use of \fBsyscall\fP(2). .SH ОПИСАНИЕ Системный вызов \fBs390_sthyi\fP() эмулирует инструкцию STHYI (Store Hypervisor Information). Он предоставляет информацию о ресурсах машины и её уровни виртуализации. В частности, возвращается тип ЦП и ёмкость, а также модель машины и другие свойства. .PP В аргументе \fIfunction_code\fP указывается какую функцию нужно выполнить. Поддерживаются следующие коды: .TP \fBSTHYI_FC_CP_IFL_CAP\fP Вернуть информацию о CP (Central Processor) и ёмкости IFL (Integrated Facility for Linux). .PP В аргументе \fIresp_buffer\fP указывается адрес буфера результата. При \fIfunction_code\fP равном \fBSTHYI_FC_CP_IFL_CAP\fP, размер буфера должен быть равен странице (4K). Если системный вызов вернул 0, то буфер результата будет заполнен информацией о ёмкости ЦП. В противном случае содержимое буфера результата не меняется. .PP В аргументе \fIreturn_code\fP хранится код возврата инструкции STHYI; возможно одно из следующих значений: .TP 0 Успешно. .TP 4 Неподдерживаемый код функции. .PP Дополнительную информацию о \fIreturn_code\fP, \fIfunction_code\fP и \fIresp_buffer\fP смотрите по ссылкам, приведённым в ЗАМЕЧАНИЯХ. .PP Аргумент \fIflags\fP предназначен для будущих расширений, а пока его значение должно быть равно 0. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении (т. е. эмуляция прошла успешно), возвращаемое \fBs390_sthyi\fP() значение совпадает с кодом условия инструкций STHYI — значением в диапазоне [0..3]. Возвращаемое значение 0 означает, что информация о ёмкости ЦП сохранена в \fI*resp_buffer\fP. Возвращаемое значение 3 указывает на «неподдерживаемый код функции» и содержимое \fI*resp_buffer\fP не изменяется. Значения 1 и 2 зарезервированы. .PP В случае ошибки возвращается \-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 on 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 . .PP При использовании интерфейса системного вызова буфер результата не имеет требований по выравниванию, описанных в инструкции STHYI. .PP Ядро кэширует результат (в Linux 4.16 каждую секунду). Последующие запуски системного вызова могут вернуть кэшированный ответ. .SH "СМ. ТАКЖЕ" \fBsyscall\fP(2) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Alexander Golubev , Azamat Hackimov , Hotellook, Nikita , Spiros Georgaras , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .