.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2012, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" See also https://lwn.net/Articles/519085/ .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getauxval 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getauxval \- استرداد قيمة من المتجه المساعد .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBunsigned long getauxval(unsigned long \fP\fItype\fP\fB);\fP .fi .SH الوصف الدالة \fBgetauxval\fP() تسترد القيم من المتجه المساعد، وهي آلية يستخدمها محمل الثنائيات ELF في النواة لتمرير معلومات معينة إلى مساحة المستخدم عند تنفيذ برنامج. .P يتكون كل إدخال في المتجه المساعد من زوج من القيم: نوع يحدد ما يمثله هذا الإدخال، وقيمة لذلك النوع. عند إعطاء المعامل \fItype\fP، تُرجع \fBgetauxval\fP() القيمة المقابلة. .P القيمة المُعادة لكل \fItype\fP مذكورة في القائمة التالية. ليست كل قيم \fItype\fP موجودة في جميع البنى. .TP \fBAT_BASE\fP العنوان الأساسي لمفسر البرنامج (عادةً، الرابط الديناميكي). .TP \fBAT_BASE_PLATFORM\fP .\" commit e585b768da111f2c2d413de6214e83bbdfee8f22 مؤشر إلى سلسلة محارف (فقط PowerPC و MIPS). في PowerPC، يُحدد هذا المنصة الحقيقية؛ قد يختلف عن \fBAT_PLATFORM\fP. في MIPS، يُحدد هذا مستوى ISA (منذ Linux 5.7). .TP \fBAT_CLKTCK\fP التردد الذي يحسب به \fBtimes\fP(2). يمكن الحصول على هذه القيمة أيضًا عبر \fIsysconf(_SC_CLK_TCK)\fP. .TP \fBAT_DCACHEBSIZE\fP حجم كتلة خبيئة البيانات. .TP \fBAT_EGID\fP معرف المجموعة الفعّال للخيط. .TP \fBAT_ENTRY\fP عنوان الدخول للملف التنفيذي. .TP \fBAT_EUID\fP معرف المستخدم الفعّال للخيط. .TP \fBAT_EXECFD\fP واصف ملف البرنامج. .TP \fBAT_EXECFN\fP مؤشر إلى سلسلة محارف تحتوي على اسم المسار المستخدم لتنفيذ البرنامج. .TP \fBAT_FLAGS\fP أعلام (غير مستخدمة). .TP \fBAT_FPUCW\fP كلمة تحكم FPU المستخدمة (فقط لمعمارية SuperH). يعطي هذا بعض المعلومات عن تهيئة FPU التي نفذها النواة. .TP \fBAT_GID\fP معرف المجموعة الحقيقي للخيط. .TP \fBAT_HWCAP\fP قناع بتات يعتمد على المعمارية وواجهة ABI، تشير إعداداته إلى قدرات المعالج التفصيلية. محتويات قناع البتات تعتمد على العتاد (على سبيل المثال، انظر ملف مصدر النواة \fIarch/x86/include/asm/cpufeature.h\fP للتفاصيل المتعلقة بمعمارية Intel x86؛ القيمة المعادة هي أول كلمة 32 بت من المصفوفة الموصوفة هناك). نسخة قابلة للقراءة البشرية من نفس المعلومات متاحة عبر \fI/proc/cpuinfo\fP. .TP \fBAT_HWCAP2\fP (منذ glibc 2.18) تلميحات إضافية تعتمد على الآلة حول قدرات المعالج. .TP \fBAT_ICACHEBSIZE\fP .\" .TP .\" .BR AT_IGNORE .\" .TP .\" .BR AT_IGNOREPPC .\" .TP .\" .BR AT_NOTELF حجم كتلة خبيئة التعليمات. .TP .\" Kernel commit 98a5f361b8625c6f4841d6ba013bbf0e80d08147 \fBAT_L1D_CACHEGEOMETRY\fP هندسة خبيئة البيانات L1، مُرمَّزة بحجم سطر الخبيئة بالبايتات في البتات الـ16 السفلية وترابطية الخبيئة في البتات الـ16 التالية. الترابطية بحيث إذا كانت N هي القيمة 16 بت، فإن الخبيئة هي ترابطية مجموعة ذات N مسار. .TP \fBAT_L1D_CACHESIZE\fP حجم خبيئة البيانات L1. .TP \fBAT_L1I_CACHEGEOMETRY\fP هندسة خبيئة التعليمات L1، مُرمَّزة كما في \fBAT_L1D_CACHEGEOMETRY\fP. .TP \fBAT_L1I_CACHESIZE\fP حجم خبيئة التعليمات L1. .TP \fBAT_L2_CACHEGEOMETRY\fP هندسة خبيئة L2، مُرمَّزة كما في \fBAT_L1D_CACHEGEOMETRY\fP. .TP \fBAT_L2_CACHESIZE\fP حجم خبيئة L2. .TP \fBAT_L3_CACHEGEOMETRY\fP هندسة خبيئة L3، مُرمَّزة كما في \fBAT_L1D_CACHEGEOMETRY\fP. .TP \fBAT_L3_CACHESIZE\fP حجم خبيئة L3. .TP \fBAT_PAGESZ\fP حجم صفحة النظام (نفس القيمة التي يُرجعها \fIsysconf(_SC_PAGESIZE)\fP). .TP \fBAT_PHDR\fP عنوان رؤوس البرنامج للملف التنفيذي. .TP \fBAT_PHENT\fP حجم مدخل رأس البرنامج. .TP \fBAT_PHNUM\fP عدد رؤوس البرنامج. .TP \fBAT_PLATFORM\fP مؤشر إلى سلسلة محارف تحدد منصة العتاد التي يعمل عليها البرنامج. يستخدم الرابط الديناميكي هذا في تفسير قيم \fIrpath\fP. .TP \fBAT_RANDOM\fP عنوان ستة عشر بايتًا تحتوي على قيمة عشوائية. .TP \fBAT_SECURE\fP له قيمة غير صفرية إذا كان يجب معالجة هذا الملف التنفيذي بشكل آمن. في الغالب، تشير القيمة غير الصفرية إلى أن العملية تنفذ ملفًا ثنائيًا set\-user\-ID أو set\-group\-ID (بحيث تختلف معرفات المستخدم أو المجموعة الحقيقية والفعلية عن بعضها البعض)، أو أنها اكتسبت صلاحيات بتنفيذ ملف ثنائي له صلاحيات (انظر \fBcapabilities\fP(7)). بدلاً من ذلك، قد تُثار قيمة غير صفرية بواسطة وحدة أمان لينكس. عندما تكون هذه القيمة غير صفرية، يعطل الرابط الديناميكي استخدام متغيرات بيئة معينة (انظر \fBld\-linux.so\fP(8)) ويغير glibc جوانب أخرى من سلوكه. (انظر أيضًا \fBsecure_getenv\fP(3).) .TP \fBAT_SYSINFO\fP نقطة الدخول إلى دالة استدعاء النظام في vDSO. غير موجودة/مطلوبة على جميع البنى (مثلًا، غائبة على x86\-64). .TP \fBAT_SYSINFO_EHDR\fP عنوان صفحة تحتوي على الكائن المشترك الديناميكي الافتراضي (vDSO) الذي ينشئه النواة لتوفير تطبيقات سريعة لبعض استدعاءات النظام. .TP \fBAT_UCACHEBSIZE\fP حجم كتلة الخبيئة الموحدة. .TP \fBAT_UID\fP معرف المستخدم الحقيقي للخيط. .SH "قيمة الإرجاع" عند النجاح، تُرجع \fBgetauxval\fP() القيمة المقابلة لـ \fItype\fP. إذا لم يُعثر على \fItype\fP، تُرجع 0. .SH الأخطاء .TP \fBENOENT\fP (منذ glibc 2.19) .\" commit b9ab448f980e296eac21ac65f53783967cc6037b لم يُعثر على إدخال مقابل لـ \fItype\fP في المتجه المساعد. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBgetauxval\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير GNU. .SH التاريخ glibc 2.16. .SH ملاحظات المستهلك الرئيسي للمعلومات في المتجه المساعد هو الرابط الديناميكي، \fBld\-linux.so\fP(8). المتجه المساعد هو اختصار ملائم وفعال يسمح للنواة بإيصال مجموعة معينة من المعلومات القياسية التي يحتاجها الرابط الديناميكي عادةً أو دائمًا. في بعض الحالات، يمكن الحصول على نفس المعلومات بواسطة استدعاءات النظام، لكن استخدام المتجه المساعد أرخص. .P يقع المتجه المساعد مباشرة فوق قائمة الوسائط والبيئة في مساحة عنوان العملية. يمكن عرض المتجه المساعد المقدم لبرنامج بتعيين متغير البيئة \fBLD_SHOW_AUXV\fP عند تشغيل برنامج: .P .in +4n .EX $ LD_SHOW_AUXV=1 sleep 1 .EE .in .P يمكن الحصول على المتجه المساعد لأي عملية (رهنا بأذونات الملف) عبر \fI/proc/\fPpid\fI/auxv\fP؛ انظر \fBproc\fP(5) لمزيد من المعلومات. .SH العلل قبل إضافة خطأ \fBENOENT\fP في glibc 2.19، لم تكن هناك طريقة للتمييز بشكل لا لبس فيه بين الحالة التي لا يمكن فيها العثور على \fItype\fP والحالة التي كانت فيها القيمة المقابلة لـ \fItype\fP صفرًا. .SH "انظر أيضًا" \fBexecve\fP(2)، \fBsecure_getenv\fP(3)، \fBvdso\fP(7)، \fBld\-linux.so\fP(8) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .