.\" -*- coding: UTF-8 -*-
.\" Copyright 2017, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getentropy 3 "21 أبريل 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
getentropy \- ملء خبيئة بمحارف عشوائية
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <unistd.h>\fP
.P
\fBint getentropy(\fPsize_t length;
\fB               void \fP\fIbuffer\fP\fB[\fP\fIlength\fP\fB], size_t \fP\fIlength\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBgetentropy\fP():
.nf
    _DEFAULT_SOURCE
.fi
.SH الوصف
تكتب دالة \fBgetentropy\fP() \fIlength\fP بايت من بيانات عشوائية عالية الجودة إلى
الخبيئة ابتداءً من الموقع المشار إليه بواسطة \fIbuffer\fP.  القيمة القصوى
المسموح بها لمعامل \fIlength\fP هي 256.
.P
يوفر استدعاء ناجح لـ \fBgetentropy\fP() دائمًا العدد المطلوب من بايتات
الإنتروبيا.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع هذه الدالة صفرًا.  عند الخطأ، يُرجع \-1، ويُضبط \fIerrno\fP
للإشارة إلى الخطأ.
.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 المعايير
POSIX.1\-2024.
.SH التاريخ
OpenBSD 5.6, glibc 2.25, FreeBSD 12.0, POSIX.1\-2024.
.SH ملاحظات
تُنفذ دالة \fBgetentropy\fP() باستخدام \fBgetrandom\fP(2).
.P
بينما يجعل غلاف glibc \fBgetrandom\fP(2) نقطة إلغاء، فإن \fBgetentropy\fP() ليست
نقطة إلغاء.
.P
تُصرح \fBgetentropy\fP() أيضًا في \fB<sys/random.h>\fP.  (لا حاجة لتعريف
كلي اختبار الميزة للحصول على التصريح من ملف الرأس ذلك.)
.P
قد يحجب استدعاء \fBgetentropy\fP() إذا كان النظام قد أُقلع للتو ولم تجمع النواة
بعد ما يكفي من العشوائية لتهيئة مجمع الإنتروبيا.  في هذه الحالة، سيبقى
\fBgetentropy()\fP محجوبًا حتى لو عُولجت إشارة، ولن يُرجع إلا بعد تهيئة مجمع
الإنتروبيا.
.SH "انظر أيضًا"
\fBgetrandom\fP(2), \fBurandom\fP(4), \fBrandom\fP(7)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .