.\" -*- coding: UTF-8 -*-
.\" Copyright (C) 2017, Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getentropy 3 "2 maja 2024 r." "Linux man\-pages 6.9.1" 
.SH NAZWA
getentropy \- wypełnia bufor losowymi bajtami
.SH BIBLIOTEKA
Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP)
.SH SKŁADNIA
.nf
\fB#include <unistd.h>\fP
.P
\fBint getentropy(void \fP\fIbuffer\fP\fB[.\fP\fIlength\fP\fB], size_t \fP\fIlength\fP\fB);\fP
.fi
.P
.RS -4
Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)):
.RE
.P
\fBgetentropy\fP():
.nf
    _DEFAULT_SOURCE
.fi
.SH OPIS
Funkcja \fBgetentropy\fP() zapisuje liczbę \fIlength\fP bajtów losowych danych o
wysokiej jakości do bufora, zaczynającego się w położeniu, na które wskazuje
\fIbuffer\fP. Maksymalną dozwoloną wartością argumentu \fIlength\fP jest 256.
.P
Pomyślne wywołanie do \fBgetentropy\fP() zawsze zwraca żądaną liczbę bajtów
entropii.
.SH "WARTOŚĆ ZWRACANA"
W przypadku powodzenia funkcja ta zwraca zero. W razie wystąpienia błędu
zwracane jest \-1 i ustawiane \fIerrno\fP, wskazując błąd.
.SH BŁĘDY
.TP 
\fBEFAULT\fP
Część lub całość bufora określonego przez \fIbuffer\fP i \fIlength\fP nie jest
prawidłowo adresowalną pamięcią.
.TP 
\fBEIO\fP
Argument \fIlength\fP jest większy niż 256.
.TP 
\fBEIO\fP
Wystąpił nieokreślony błąd podczas próby nadpisania bufora \fIbuffer\fP
losowymi danymi.
.TP 
\fBENOSYS\fP
Bieżąca wersja jądra nie implementuje wywołania systemowego \fBgetrandom\fP(2),
które jest wymagane do zaimplementowania tej funkcji.
.SH STANDARDY
Brak.
.SH HISTORIA
glibc 2.25.  OpenBSD.
.SH UWAGI
Funkcja \fBgetentropy\fP() jest zaimplementowana za pomocą \fBgetrandom\fP(2).
.P
Tam gdzie opakowanie z glibc czyni \fBgetrandom\fP(2) punktem anulowania,
\fBgetentropy\fP() nie jest punktem anulowania.
.P
\fBgetentropy\fP() jest deklarowane również w \fB<sys/random.h>\fP (do
uzyskania deklaracji z tego pliku nagłówkowego nie jest potrzebne
deklarowanie żadnego makra sprawdzania cech).
.P
Wywołanie do \fBgetentropy\fP() może blokować, jeśli system jest tuż po
rozruchu i jądro nie zebrało jeszcze wystarczająco dużo losowości do
zainicjowania puli entropii. W takim przypadku, \fBgetentropy\fP() będzie
utrzymywało blokowanie nawet wtedy, gdy obsługiwany jest sygnał i powróci
jedynie po zainicjowaniu puli entropii.
.SH "ZOBACZ TAKŻE"
\fBgetrandom\fP(2), \fBurandom\fP(4), \fBrandom\fP(7)
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .