.\" -*- coding: UTF-8 -*-
.de  Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de  Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de  Ve \" End verbatim text
.ft R
.fi
..
.ie  n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.de  IX
..
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.nr rF 0
.if  \n(.g .if rF .nr rF 1
.if  (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.if  n .ds AD l
.\"
.\" Required to disable full justification in groff 1.23.0.
.\" ========================================================================
.\"
.IX Title "RAND_LOAD_FILE 3ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH RAND_LOAD_FILE 3ssl "7 أبريل 2026" 3.6.2 OpenSSL
.if  n .ad l
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.nh
.SH الاسم
RAND_load_file, RAND_write_file, RAND_file_name \- ملف بذرة PRNG
.SH موجز
.IX Header موجز
.Vb 1
\& #include <openssl/rand.h>
\&
\& int RAND_load_file(const char *filename, long max_bytes);
\&
\& int RAND_write_file(const char *filename);
\&
\& const char *RAND_file_name(char *buf, size_t num);
.Ve
.SH الوصف
.IX Header الوصف
\&\fBRAND_load_file()\fP يقرأ عددًا من البايتات من الملف \fBfilename\fP ويُضيفها
إلى PRNG. إذا كان \fBmax_bytes\fP غير سالب، فتُقرأ حتى \fBmax_bytes\fP بايت؛ إذا
كان \fBmax_bytes\fP يساوي \-1، فُيقرأ الملف بالكامل (إلا إذا لم يكن الملف ملفًا
عاديًا، ففي هذه الحالة تُحاول قراءة عدد ثابت من البايتات، 256 في التنفيذ
الحالي).  يمكن لـ \&\fBRAND_load_file()\fP قراءة أقل من الملف الكامل أو العدد
المطلوب من البايتات إذا لم يتسع في نوع قيمة الإرجاع.  لا تُحمّل نفس الملف
عدة مرات إلا إذا تم تحديث محتوياته بواسطة \fBRAND_write_file()\fP بين
القراءات.  أيضًا، لاحظ أن \fBfilename\fP يجب أن يكون محميًا بشكل كافٍ بحيث لا
يستطيع المهاجم استبدال المحتويات أو فحصها.  إذا لم يكن \fBfilename\fP ملفًا
عاديًا، فُيعتبر المستخدم مسؤولًا عن أي آثار جانبية، مثل الحظر غير المتوقع أو
الاستيلاء على الطرفية المسيطرة.
.PP
\&\fBRAND_write_file()\fP يكتب عددًا من البايتات العشوائية (حاليًا 128) إلى
الملف \fBfilename\fP والتي يمكن استخدامها لتهيئة PRNG عن طريق استدعاء
\&\fBRAND_load_file()\fP في جلسة لاحقة.
.PP
\&\fBRAND_file_name()\fP يُنشئ مسارًا مبدئيًا لملف البذرة العشوائية. يُشير
\fBbuf\fP إلى مخزن مؤقت بحجم \fBnum\fP لتخزين اسم الملف فيه.
.PP
على جميع الأنظمة، إذا كان المتغير البيئي \fBRANDFILE\fP مُعيَّنًا، فُستُستخدم
قيمته كاسم ملف البذرة. وإلا، فُيسمى الملف \f(CW\*(C`.rnd\*(C'\fP، ويُوجد في
مواقع تعتمد على المنصة:
.IP "على ويندوز (حسب الأفضلية)" 4
.IX Item "على ويندوز (حسب الأفضلية)"
.Vb 1
\& %HOME%, %USERPROFILE%, %SYSTEMROOT%, C:\e
.Ve
.IP "على VMS" 4
.IX Item "على VMS"
.Vb 1
\& SYS$LOGIN:
.Ve
.IP "على جميع الأنظمة الأخرى" 4
.IX Item "على جميع الأنظمة الأخرى"
.Vb 1
\& $HOME
.Ve
.PP
إذا لم يكن \f(CW$HOME\fP (على نظام غير ويندوز وغير VMS) مُعيَّنًا أيضًا، أو كان
\&\fBnum\fP صغيرًا جدًا لاسم المسار، فُيحدث خطأ.
.SH "القيم المُرجعة"
.IX Header "القيم المُرجعة"
\&\fBRAND_load_file()\fP يُرجع عدد البايتات المقروءة أو \-1 عند الخطأ.
.PP
\&\fBRAND_write_file()\fP يُرجع عدد البايتات المكتوبة، أو \-1 إذا كانت البايتات
المكتوبة قد وُلدت بدون بذر مناسب.
.PP
\&\fBRAND_file_name()\fP يُرجع مؤشرًا إلى \fBbuf\fP عند النجاح، وNULL عند الخطأ.
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBRAND_add\fP\|(3)، \&\fBRAND_bytes\fP\|(3)، \&\fBRAND\fP\|(7)
.SH "حقوق النسخ"
.IX Header "حقوق النسخ"
حقوق النشر 2000\-2025 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.
.PP
مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“).  لا يجوز لك
استخدام هذا الملف إلا وفقًا لشروط الرخصة.  يمكنك الحصول على نسخة منها في
الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط
<https://www.openssl.org/source/license.html>.
.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 .