.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2017, Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getentropy 3 "10 ноября 2022 г." "Linux man\-pages 6.03" .SH ИМЯ getentropy \- заполнение буфера случайными байтами .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint getentropy(void \fP\fIbuffer\fP\fB[.\fP\fIlength\fP\fB], size_t \fP\fIlength\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBgetentropy\fP(): .nf _DEFAULT_SOURCE .fi .SH ОПИСАНИЕ Функция \fBgetentropy\fP() записывает \fIlength\fP байт высококачественных случайных данных в буфер, начинающийся в области, указанной в \fIbuffer\fP. Максимально разрешенное значение аргумента \fIlength\fP равно 256. .PP Успешный вызов \fBgetentropy\fP() всегда предоставляет затребованное число байт энтропии. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" On success, this function returns zero. On error, \-1 is returned, and \fIerrno\fP is set to indicate the error. .SH ОШИБКИ .TP \fBEFAULT\fP Часть или весь буфер, указанный в \fIbuffer\fP и \fIlength\fP, не является валидной адресуемой памятью. .TP \fBEIO\fP Значение \fIlength\fP больше 256. .TP \fBEIO\fP При попытке перезаписать \fIbuffer\fP случайными данными произошла ошибка. .TP \fBENOSYS\fP Данная версия ядра не имеет реализации системного вызова \fBgetrandom\fP(2), необходимого для реализации данной функции. .SH ВЕРСИИ Функция \fBgetentropy\fP() впервые появилась в glibc 2.25. .SH СТАНДАРТЫ Эта функция является нестандартной. Она также присутствует в OpenBSD. .SH ЗАМЕЧАНИЯ Функция \fBgetentropy\fP() реализована через вызов \fBgetrandom\fP(2). .PP Whereas the glibc wrapper makes \fBgetrandom\fP(2) a cancelation point, \fBgetentropy\fP() is not a cancelation point. .PP Функция \fBgetentropy\fP() также объявлена в \fB\fP (для получения этого объявления из заголовочного файла макроса тестирования свойств не требуется). .PP Вызов \fBgetentropy\fP() может блокировать работу, если система только что загрузилась и ядро ещё не успело набрать достаточно случайных событий для инициализации пула энтропии. В этом случае \fBgetentropy\fP() продолжает блокировать работу даже при обработке сигнала и вернёт управление только после завершения инициализации пула энтропии. .SH "СМ. ТАКЖЕ" \fBgetrandom\fP(2), \fBurandom\fP(4), \fBrandom\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitry Bolkhovskikh , 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 .