.\" -*- coding: UTF-8 -*-
.\" 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 listmount 2 "6 سبتمبر 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
listmount \- الحصول على قائمة بمعرفات نقاط الوصل
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <linux/mount.h>\fP  /* تعريف ثوابت struct mnt_id_req */
\fB#include <unistd.h>\fP
.P
\fBint syscall(\fPsize_t n;
\fB            SYS_listmount, struct mnt_id_req *\fP\fIreq\fP\fB,\fP
\fB            uint64_t \fP\fImnt_ids\fP\fB[\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP
\fB            unsigned long \fP\fIflags\fP\fB);\fP
.P
\fB#include <linux/mount.h>\fP
.P
\fBstruct mnt_id_req {\fP
\fB    __u32  size;\fP    /* sizeof(struct mnt_id_req) */
\fB    __u64  mnt_id;\fP  /* معرف نقطة الوصل الأب الذي يتم البحث عنه */
\fB    __u64  param;\fP   /* معرف نقطة الوصل التالي الذي نريد إيجاده */
\fB};\fP
.fi
.P
\fIملاحظة\fP: لا توفر glibc غلافًا لـ \fBlistmount\fP()، مما يستلزم استخدام
\fBsyscall\fP(2).
.SH الوصف
للوصول إلى نقاط الوصل في نطاق الأسماء الخاص بك، يجب أن تمتلك صلاحية
CAP_SYS_ADMIN في نطاق أسماء المستخدم.
.P
ترجع هذه الدالة قائمة بمعرفات نقاط الوصل تحت \fBreq.mnt_id\fP.  يُقصد استخدامها
بالتزامن مع \fBstatmount\fP(2) لتوفير طريقة للتكرار واكتشاف أنظمة الملفات
الموصولة.
.SS "هيكل mnt_id_req"
يستخدم النواة \fIreq.size\fP لتحديد أي struct \fImnt_id_req\fP يتم تمريره، ويجب
دائمًا تعيينه إلى \fI\%sizeof(struct\ mnt_id_req)\fP.
.P
\fIreq.mnt_id\fP هو معرف نقطة الوصل الأب الذي سنقوم بالإدراج منه، والذي يمكن أن
يكون إما \fBLSMT_ROOT\fP الذي يعني نقطة الوصل الجذرية لنطاق أسماء الوصل الحالي،
أو معرف نقطة وصل تم الحصول عليه إما من \fBstatx\fP(2) باستخدام
\fBSTATX_MNT_ID_UNIQUE\fP أو من \fBlistmount\fP(2)\fB.\fP
.P
يستخدم \fIreq.param\fP لإخبار النواة بأي معرف نقطة وصل لبدء القائمة منه.  هذا
مفيد إذا كانت هناك حاجة لاستدعاءات متعددة لـ \fBlistmount\fP(2).  يمكن تعيين
هذا إلى آخر معرف نقطة وصل تم إرجاعه لاستئناف من موضع سابق في القائمة.
.SH "قيمة الإرجاع"
عند النجاح، يتم إرجاع عدد الإدخالات المملوءة في \fImnt_ids\fP؛ 0 إذا لم يتبق أي
نقاط وصل.  عند الخطأ، يتم إرجاع \-1، ويتم تعيين \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEPERM\fP
لا يمتلك المستدعي صلاحية \fBCAP_SYS_ADMIN\fP في نطاق أسماء المستخدم.
.TP 
\fBEFAULT\fP
يشير \fIreq\fP أو \fImnt_ids\fP إلى موقع خارج مساحة العنوان القابلة للوصول
للعملية.
.TP 
\fBEINVAL\fP
راية غير صالحة محددة في \fIflags\fP.
.TP 
\fBEINVAL\fP
حجم \fIreq\fP غير كافٍ لاستخدامه.
.TP 
\fBE2BIG\fP
\fIreq\fP كبير جدًا، الحد الأقصى هو حجم صفحة المعمارية.
.TP 
\fBENOENT\fP
\fIreq.mnt_id\fP المحدد غير موجود.
.TP 
\fBENOMEM\fP
نفاد الذاكرة (أي ذاكرة نواة الحاسوب).
.SH المعايير
لينكس.
.SH "انظر أيضًا"
\fBstatmount\fP(2), \fBstatx\fP(2)
.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 .