عرض مصدر Ruby/Process/setrlimit

<noinclude>{{DISPLAYTITLE: التابع <code>Process.setrlimit</code> في روبي}}</noinclude>
يضبط التابع <code>setrlimit</code> قيد المورد (resource limit) للعملية. 

اطلع على الدليل man لدالة النظام <code>setrlimit(2)‎</code> لمزيد من التفاصيل.

==البنية العامة==
<syntaxhighlight lang="ruby">setrlimit(resource, cur_limit, max_limit) → nil click to toggle source
setrlimit(resource, cur_limit) → nil</syntaxhighlight>

== المعاملات ==

=== <code>resource</code> ===
يشير إلى نوع المورد المراد ضبط قيوده. يُحدَّد برمزٍ مثل <code>CORE:</code>، أو سلسلة نصية مثل <code>"CORE"</code>، أو ثابت مثل <code>Process::RLIMIT_CORE</code>. الموارد المتاحة تتعلق بنظام التشغيل. قد تدعم روبي الموارد التالية:
{| class="wikitable"
!المورد
!الوصف
|-
|AS
|الذاكرة الكلية المتاحة بالبايت.
(SUSv3، و NetBSD، و FreeBSD، و OpenBSD باستثناء 4.4BSD-Lite)
|-
|CORE
|حجم النواة بالبايت.
(SUSv3)
|-
|CPU
|زمن المعالجة (CPU time، أو زمن العملية) بالثانية.
(SUSv3)
|-
|DATA
|قطعة البيانات (data segment) بالبايت.
(SUSv3)
|-
|FSIZE
|حجم الملف بالبايت.
(SUSv3)
|-
|MEMLOCK
|الحجم الكلي من أجل mlock(2) بالبايت.
(4.4BSD، و GNU/Linux)
|-
|MSGQUEUE
|الحجم المحجوز من أجل طوابير رسائل POSIX بالبايت.
(GNU/Linux)
|-
|NICE
|عدد يمثِّل الحد الأعلى في قيمة <code>nice(2)‎</code> للعملية.
(GNU/Linux)
|-
|NOFILE
|عدد يمثِّل واصفات الملفات.
(SUSv3)
|-
|NPROC
|عدد العمليات للمستخدم.
(4.4BSD، و GNU/Linux)
|-
|RSS
|حجم الذاكرة المثبَّتة (resident memory size) بالبايت.
(4.2BSD، و GNU/Linux)
|-
|RTPRIO
|عدد يمثِّل الحد الأعلى للأولوية في الوقت الفعلي (real-time priority) في العملية.
(GNU/Linux)
|-
|RTTIME
|توقيت المعالج (CPU time) من أجل العملية في الوقت الفعلي بالميكروثانية.
(GNU/Linux)
|-
|SBSIZE
|حجم جميع المخازن المؤقتة للمقبس (socket buffers) بالبايت.
(NetBSD، و FreeBSD)
|-
|SIGPENDING
|عدد الإشارات المنتظرة في الطابور المسموحة.
(GNU/Linux)
|-
|STACK
|حجم المكدس بالبايت.
(SUSv3)
|}

=== <code>cur_limit</code> ===
يحدِّد هذا المعامل القيد الحالي (الرخو [soft]) المراد ضبطه. يمكن أن تكون قيمة هذا المعامل ‎<code>:INFINITY</code>، أو <code>"INFINITY"</code> أو  <code>Process::RLIM_INFINITY</code> الذي يعني أن المورد ليس محدودًا (غير مقيد). يمكن أن يكون أيضًا <code>Process::RLIM_SAVED_MAX</code>، أو <code>Process::RLIM_SAVED_CUR</code> أو ما مايقابلهما من [[Ruby/Symbol|رموز]] أو [[Ruby/String|سلاسل نصية]]. 

=== <code>max_limit</code> ===
يحدِّد هذا المعامل القيد الأقصى (الصارم [hard]) المراد ضبطه. إن لم يُعطَ هذا المعامل، فستُستعمَل قيمة المعامل <code>cur_limit</code> عوضًا عنه. يمكن أن تكون قيمة هذا المعامل ‎<code>:INFINITY</code>، أو <code>"INFINITY"</code> أو  <code>Process::RLIM_INFINITY</code> الذي يعني أن المورد ليس محدودًا. يمكن أن يكون أيضًا <code>Process::RLIM_SAVED_MAX</code>، أو <code>Process::RLIM_SAVED_CUR</code> أو ما مايقابلهما من [[Ruby/Symbol|رموز]] أو [[Ruby/String|سلاسل نصية]].

==القيم المعادة==
تعاد القيمة <code>nil</code> بعد اكتمال تنفيذ العملية.
==أمثلة==
المثال الآتي يرفع قيمة الحد الحالي للعملية الأساسية CORE إلى أقصى حد، وذلك لكي يصبح تفريغ محتويات العملية ممكنًا عند انهيارها:<syntaxhighlight lang="ruby">
Process.setrlimit(:CORE, Process.getrlimit(:CORE)[1])

</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Process/getrlimit|getrlimit]]</code>: يجلب قيد المورد (resource limit) للعملية.
*التابع <code>[[Ruby/Process/setpriority|setpriority]]</code>: يضبط قيمة أولوية الجدولة (scheduling priority) لعملية محدَّدة أو لمجموعة مالكة أو مستخدم مالك لعملية.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Process.html#method-c-setrlimit قسم التابع setrlimit في الصنف Process في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Process]]