.\" -*- coding: UTF-8 -*-
.\" Copyright 2020, 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 PR_SVE_SET_VL 2const "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
PR_SVE_SET_VL \- تعيين طول متجه SVE للخيط
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <linux/prctl.h>\fP  /* تعريف ثوابت \fBPR_*\fP */
\fB#include <sys/prctl.h>\fP
.P
\fBint prctl(PR_SVE_SET_VL, unsigned long \fP\fIval\fP\fB);\fP
.fi
.SH الوصف
تكوين طول متجه SVE للخيط، كما هو محدد بواسطة \fIval\fP.
.P
يجب تعيين بتات \fIval\fP المقابلة لـ \fBPR_SVE_VL_LEN_MASK\fP إلى طول المتجه
المطلوب بالبايت. يُفسر هذا كحد أعلى: ستختار النواة أكبر طول متجه متاح لا
يتجاوز القيمة المحددة. على وجه الخصوص، تحديد \fBSVE_VL_MAX\fP (المعرف في
\fI<asm/sigcontext.h>)\fP لبتات \fBPR_SVE_VL_LEN_MASK\fP يطلب أقصى طول
متجه مدعوم.
.P
بالإضافة إلى ذلك، يجب تعيين البتات الأخرى من \fIval\fP إلى إحدى تركيبات الأعلام
التالية:
.TP 
\fB0L\fP
تنفيذ التغيير فورًا. عند استدعاء \fBexecve\fP(2) التالي في الخيط، سيتم إعادة
تعيين طول المتجه إلى القيمة المكونة في
\fI/proc/\:sys/\:abi/\:sve_default_vector_length\fP.
.TP 
\fBPR_SVE_VL_INHERIT\fP
تنفيذ التغيير فورًا. استدعاءات \fBexecve\fP(2) اللاحقة ستحافظ على طول المتجه
الجديد.
.TP 
\fBPR_SVE_SET_VL_ONEXEC\fP
تأجيل التغيير، بحيث يتم تنفيذه عند استدعاء \fBexecve\fP(2) التالي في
الخيط. استدعاءات \fBexecve\fP(2) اللاحقة ستعيد تعيين طول المتجه إلى القيمة
المكونة في \fI/proc/\:sys/\:abi/\:sve_default_vector_length\fP.
.TP 
\fBPR_SVE_SET_VL_ONEXEC | PR_SVE_VL_INHERIT\fP
تأجيل التغيير، بحيث يتم تنفيذه عند استدعاء \fBexecve\fP(2) التالي في
الخيط. استدعاءات \fBexecve\fP(2) اللاحقة ستحافظ على طول المتجه الجديد.
.P
في جميع الحالات، يتم إلغاء أي تغيير مؤجل معلق سابقًا.
.P
عند النجاح، يتم إرجاع قيمة غير سالبة تصف التهيئة \fIالمختارة\fP. إذا تم تضمين
\fBPR_SVE_SET_VL_ONEXEC\fP في \fIval\fP، فإن التهيئة الموصوفة بقيمة الإرجاع ستصبح
سارية المفعول عند استدعاء \fBexecve\fP(2) التالي. بخلاف ذلك، تكون التهيئة سارية
المفعول بالفعل عند عودة استدعاء \fBPR_SVE_SET_VL\fP. في كلتا الحالتين، يتم
ترميز القيمة بنفس طريقة قيمة إرجاع \fBPR_SVE_GET_VL\fP. لاحظ أنه لا يوجد علم
صريح في قيمة الإرجاع يقابل \fBPR_SVE_SET_VL_ONEXEC\fP.
.P
يتم توريث التهيئة (بما في ذلك أي تغيير مؤجل معلق) عبر \fBfork\fP(2) و
\fBclone\fP(2).
.SH "قيمة الإرجاع"
عند النجاح، يُرجع \fBPR_SVE_SET_VL\fP القيمة غير السالبة الموصوفة أعلاه. عند
الخطأ، يتم إرجاع \-1، ويتم تعيين \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEINVAL\fP
SVE غير متاح على هذه المنصة.
.TP 
\fBEINVAL\fP
القيمة في بتات \fIval\fP المقابلة لـ \fBPR_SVE_VL_LEN_MASK\fP خارج النطاق
[\fBSVE_VL_MIN\fP, \fBSVE_VL_MAX\fP] أو ليست من مضاعفات 16.
.TP 
\fBEINVAL\fP
البتات الأخرى من \fIval\fP غير صالحة أو غير مدعومة.
.SH الملفات
.TP 
\fI/proc/\:sys/\:abi/\:sve_default_vector_length\fP
.SH المعايير
لينكس. arm64 فقط.
.SH التاريخ
.\" commit 2d2123bc7c7f843aa9db87720de159a049839862
.\" linux-5.6/Documentation/arm64/sve.rst
لينكس 4.15 (arm64).
.SH تحذيرات
نظرًا لأن المترجم أو بيئة التشغيل قد تستخدم SVE، فإن استخدام هذا الاستدعاء
بدون علم \fBPR_SVE_SET_VL_ONEXEC\fP قد يتسبب في تعطل العملية المستدعية. شروط
استخدامه بأمان معقدة وتعتمد على النظام. لا تستخدمه إلا إذا كنت تعرف حقًا ما
تفعله.
.SH "انظر أيضًا"
\fBprctl\fP(2), \fBPR_SVE_GET_VL\fP(2const)
.P
لمزيد من المعلومات، راجع ملف مصدر النواة
\fIDocumentation/arch/arm64/sve.rst\fP.
.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 .