الاسم¶

getrandom - الحصول على سلسلة من البايتات العشوائية

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

موجز¶

#include <sys/random.h>

ssize_t getrandom(void buf[.buflen], size_t buflen, unsigned int flags);

الوصف¶

استدعاء النظام getrandom() يملأ المخزن المؤقت المشار إليه بـ buf بما يصل إلى buflen بايت عشوائي. يمكن استخدام هذه البايتات لتغذية مولدات الأرقام العشوائية في مساحة المستخدم أو للأغراض التشفيرية.

مبدئيًا، يسحب getrandom() الإنتروبيا من مصدر urandom (أي نفس مصدر الجهاز /dev/urandom). يمكن تغيير هذا السلوك عبر وسيط flags.

إذا يُهيئ مصدر urandom، فإن القراءات التي تصل إلى 256 بايت ستعيد دائمًا عدد البايتات المطلوبة ولن تقاطعها الإشارات. لا تنطبق هذه الضمانات على أحجام المخازن الأكبر. على سبيل المثال، إذا قاطع معالج إشارة الاستدعاء، فقد يعيد مخزنًا ممتلئًا جزئيًا، أو يفشل مع الخطأ EINTR.

إذا لم يُهيئ مصدر urandom بعد، فسيحظر getrandom()، ما لم يتم تحديد GRND_NONBLOCK في flags.

وسيط flags هو قناع بت يمكن أن يحتوي على صفر أو أكثر من القيم التالية مجمعة بـ OR:

GRND_RANDOM

إذا تم تعيين هذه البتة، فسيتم سحب البايتات العشوائية من مصدر random (أي نفس مصدر جهاز /dev/random) بدلاً من مصدر urandom. مصدر random محدود بناءً على الإنتروبيا التي يمكن الحصول عليها من الضوضاء البيئية. إذا كان عدد البايتات المتاحة في مصدر random أقل من المطلوب في buflen، يُرجع الاستدعاء البايتات العشوائية المتاحة فقط. إذا لم تكن هناك بايتات عشوائية متاحة، يعتمد السلوك على وجود GRND_NONBLOCK في وسيط flags.

GRND_NONBLOCK

مبدئيًا، عند القراءة من مصدر random، يحظر getrandom() إذا لم تكن هناك بايتات عشوائية متاحة، وعند القراءة من مصدر urandom، يحظر إذا لم يتم تهيئة تجمع الإنتروبيا بعد. إذا تم تعيين العلم GRND_NONBLOCK، فإن getrandom() لا يحظر في هذه الحالات، بل يعيد فورًا -1 مع تعيين errno إلى EAGAIN.

قيمة الإرجاع¶

عند النجاح، يُرجع getrandom() عدد البايتات التي تم نسخها إلى المخزن المؤقت buf. قد يكون هذا أقل من عدد البايتات المطلوبة عبر buflen إذا تم تحديد GRND_RANDOM في flags وكانت الإنتروبيا غير كافية في مصدر random أو تمت مقاطعة استدعاء النظام بواسطة إشارة.

عند الخطأ، تُعاد القيمة -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء¶

EAGAIN

الإنتروبيا المطلوبة لم تكن متاحة، وكان getrandom() سيحظر إذا لم يتم تعيين العلم GRND_NONBLOCK.

EFAULT

العنوان المشار إليه بـ buf خارج مساحة العنوان القابلة للوصول.

EINTR

قاطع معالج إشارة الاستدعاء؛ انظر وصف كيفية معالجة استدعاءات read(2) المقاطعة على الأجهزة "البطيئة" مع وبدون العلم SA_RESTART في صفحة الدليل signal(7).

EINVAL

تم تحديد علم غير صالح في flags.

ENOSYS

حددت دالة الغلاف glibc لـ getrandom() أن النواة الأساسية لا تنفذ استدعاء النظام هذا.

المعايير¶

لينكس.

التاريخ¶

Linux 3.17, glibc 2.25.

ملاحظات¶

للحصول على نظرة عامة ومقارنة للواجهات المختلفة التي يمكن استخدامها للحصول على العشوائية، راجع random(7).

على عكس /dev/random و /dev/urandom، لا يتضمن getrandom() استخدام أسماء المسارات أو واصفات الملفات. وبالتالي، يمكن أن يكون getrandom() مفيدًا في الحالات التي يجعل فيها chroot(2) أسماء مسارات /dev غير مرئية، وحيث يغلق تطبيق (مثل خفي أثناء بدء التشغيل) واصف ملف لأحد هذه الملفات الذي فتحته مكتبة.

العلل¶

اعتبارًا من Linux 3.19، يوجد الخلل التالي:

•

اعتمادًا على حمل وحدة المعالجة المركزية، لا يستجيب getrandom() للمقاطعات قبل قراءة جميع البايتات المطلوبة.

انظر أيضًا¶

getentropy(3)، random(4)، urandom(4)، random(7)، signal(7)

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.