.\" -*- coding: UTF-8 -*- .\" Copyright 2015, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH posix_madvise 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم posix_madvise \- تقديم نصح حول أنماط استخدام الذاكرة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint posix_madvise(\fPsize_t size; \fB void \fP\fIaddr\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB, int \fP\fIadvice\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBposix_madvise\fP(): .nf _POSIX_C_SOURCE >= 200112L .fi .SH الوصف تسمح الدالة \fBposix_madvise\fP() للتطبيق بتقديم نصح للنظام حول أنماط استخدامه المتوقعة للذاكرة في نطاق العناوين الذي يبدأ من \fIaddr\fP ويستمر لـ \fIsize\fP بايت. النظام حر في استخدام هذا النصح لتحسين أداء الوصولات إلى الذاكرة (أو تجاهل النصح بالكامل)، لكن استدعاء \fBposix_madvise\fP() لا يؤثر على دلالات الوصول إلى الذاكرة في النطاق المحدد. .P المعامل \fIadvice\fP هو أحد ما يلي: .TP \fBPOSIX_MADV_NORMAL\fP ليس لدى التطبيق نصح خاص بخصوص أنماط استخدامه للذاكرة لنطاق العناوين المحدد. هذا هو السلوك المبدئي. .TP \fBPOSIX_MADV_SEQUENTIAL\fP يتوقع التطبيق الوصول إلى نطاق العناوين المحدد بشكل تسلسلي، منتقلاً من العناوين المنخفضة إلى العناوين المرتفعة. وبالتالي، يمكن قراءة الصفحات في هذه المنطقة بشكل استباقي، وقد تُحرر بعد الوصول إليها بفترة قصيرة. .TP \fBPOSIX_MADV_RANDOM\fP يتوقع التطبيق الوصول إلى نطاق العناوين المحدد بشكل عشوائي. وبالتالي، قد تكون القراءة الاستباقية أقل فائدة من المعتاد. .TP \fBPOSIX_MADV_WILLNEED\fP يتوقع التطبيق الوصول إلى نطاق العناوين المحدد في المستقبل القريب. وبالتالي، قد تكون القراءة الاستباقية مفيدة. .TP \fBPOSIX_MADV_DONTNEED\fP يتوقع التطبيق أنه لن يصل إلى نطاق العناوين المحدد في المستقبل القريب. .SH "قيمة الإرجاع" عند النجاح، تُرجع \fBposix_madvise\fP() 0. عند الفشل، تُرجع رقم خطأ موجب. .SH الأخطاء .TP \fBEINVAL\fP \fIaddr\fP ليس مضاعفاً لحجم صفحة النظام أو \fIsize\fP سالب. .TP \fBEINVAL\fP \fIadvice\fP غير صالح. .TP \fBENOMEM\fP العناوين في النطاق المحدد جزئياً أو كلياً خارج مساحة عناوين المستدعي. .SH الإصدارات يسمح POSIX.1 للتنفيذ بتوليد خطأ إذا كان \fIsize\fP يساوي 0. في لينكس، يُسمح بتحديد \fIsize\fP كـ 0 (كعملية لا شيء ناجحة). .P في glibc، تُنفَّذ هذه الدالة باستخدام \fBmadvise\fP(2). لكن، منذ glibc 2.6، يُعامل \fBPOSIX_MADV_DONTNEED\fP كعملية عدمية، لأن القيمة المقابلة في \fBmadvise\fP(2)، \fBMADV_DONTNEED\fP، لها دلالات تدميرية. .SH المعايير POSIX.1\-2008. .SH التاريخ glibc 2.2. POSIX.1\-2001. .SH "انظر أيضًا" \fBmadvise\fP(2)، \fBposix_fadvise\fP(2) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .