getentropy(3)              Library Functions Manual              getentropy(3)

NAZWA
       getentropy - wypelnia bufor losowymi bajtami

BIBLIOTEKA
       Standardowa biblioteka C (libc, -lc)

SKLADNIA
       #include <unistd.h>

       int getentropy(void buffer[.length], size_t length);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       getentropy():
           _DEFAULT_SOURCE

OPIS
       Funkcja getentropy() zapisuje liczbe length bajtow losowych danych o
       wysokiej jakosci do bufora, zaczynajacego sie w polozeniu, na ktore
       wskazuje buffer. Maksymalna dozwolona wartoscia argumentu length jest
       256.

       Pomyslne wywolanie do getentropy() zawsze zwraca zadana liczbe bajtow
       entropii.

WARTOSC ZWRACANA
       W przypadku powodzenia funkcja ta zwraca zero. W razie wystapienia
       bledu zwracane jest -1 i ustawiane errno, wskazujac blad.

BLEDY
       EFAULT Czesc lub calosc bufora okreslonego przez buffer i length nie
              jest prawidlowo adresowalna pamiecia.

       EIO    Argument length jest wiekszy niz 256.

       EIO    Wystapil nieokreslony blad podczas proby nadpisania bufora
              buffer losowymi danymi.

       ENOSYS Biezaca wersja jadra nie implementuje wywolania systemowego
              getrandom(2), ktore jest wymagane do zaimplementowania tej
              funkcji.

STANDARDY
       Brak.

HISTORIA
       glibc 2.25.  OpenBSD.

UWAGI
       Funkcja getentropy() jest zaimplementowana za pomoca getrandom(2).

       Tam gdzie opakowanie z glibc czyni getrandom(2) punktem anulowania,
       getentropy() nie jest punktem anulowania.

       getentropy() jest deklarowane rowniez w <sys/random.h> (do uzyskania
       deklaracji z tego pliku naglowkowego nie jest potrzebne deklarowanie
       zadnego makra sprawdzania cech).

       Wywolanie do getentropy() moze blokowac, jesli system jest tuz po
       rozruchu i jadro nie zebralo jeszcze wystarczajaco duzo losowosci do
       zainicjowania puli entropii. W takim przypadku, getentropy() bedzie
       utrzymywalo blokowanie nawet wtedy, gdy obslugiwany jest sygnal i
       powroci jedynie po zainicjowaniu puli entropii.

ZOBACZ TAKZE
       getrandom(2), urandom(4), random(7)

TLUMACZENIE
       Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Michal
       Kulach <michal.kulach@gmail.com>

       Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o
       warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public
       License w wersji 3 <https://www.gnu.org/licenses/gpl-3.0.html> lub
       nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI.

       Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy
       dyskusyjnej <manpages-pl-list@lists.sourceforge.net>.

Linux man-pages 6.9.1           2 maja 2024 r.                   getentropy(3)