malloc_trim(3)

الاسم
malloc_trim - تحرير الذاكرة الحرة من الكومة

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

موجز
#include <malloc.h>

int malloc_trim(size_t pad);

الوصف
تحاول الدالة malloc_trim() تحرير الذاكرة الحرة من الكومة (باستدعاء sbrk(2) أو madvise(2) بوسائط مناسبة).

يحدد المعامل pad مقدار المساحة الحرة التي تُترك دون تقليم في أعلى الكومة. إذا كان هذا المعامل 0، فتُحتفظ فقط بالحد الأدنى من الذاكرة في أعلى الكومة (أي صفحة واحدة أو أقل). يمكن استخدام معامل غير صفري للاحتفاظ ببعض المساحة الخلفية في أعلى الكومة للسماح بعمليات تخصيص مستقبلية دون الحاجة إلى توسيع الكومة باستخدام sbrk(2).

قيمة الإرجاع
تُرجع الدالة malloc_trim() القيمة 1 إذا وُلدت الذاكرة فعليًا إلى النظام، أو القيمة 0 إذا تعذر تحرير أي ذاكرة.

الأخطاء
لم تُعرّف أي أخطاء.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
malloc_trim() | سلامة الخيوط | MT-Safe

المعايير
GNU.

الإصدارات
glibc 2.0.

ملاحظات
فقط الكومة الرئيسية (باستخدام sbrk(2)) تُكرّم المعامل pad؛ أكوام الخيوط لا تفعل ذلك.

منذ glibc 2.8، تُحرّر هذه الدالة الذاكرة في جميع الساحات وفي جميع القطع ذات الصفحات الحرة الكاملة.

قبل glibc 2.8، كانت هذه الدالة تُحرّر الذاكرة فقط في أعلى الكومة في الساحة الرئيسية.

انظر أيضًا
sbrk(2), malloc(3), mallopt(3)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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