.\" -*- coding: UTF-8 -*- .\" Copyright 1995, Andries E. Brouwer .\" Copyright 2008-2015, Michael Kerrisk .\" 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 getdents 2 "8 أبريل 2026" "صفحات دليل لينكس 6.18" .SH الاسم getdents, getdents64 \- الحصول على مدخلات الدليل .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP /* تعريف ثوابت \fBSYS_*\fP */ \fB#include \fP .P \fBlong syscall(SYS_getdents, unsigned int \fP\fIfd\fP\fB, struct linux_dirent *\fP\fIdirp\fP\fB,\fP \fB unsigned int \fP\fIcount\fP\fB);\fP .P \fB#define _GNU_SOURCE\fP /* See feature_test_macros(7) */ \fB#include \fP .P \fBssize_t getdents64(\fPsize_t count; \fB int \fP\fIfd\fP\fB, void \fP\fIdirp\fP\fB[\fP\fIcount\fP\fB], size_t \fP\fIcount\fP\fB);\fP .fi .P \fIملاحظة\fP: لا توفر glibc غلافًا لـ \fBgetdents\fP()، مما يستلزم استخدام \fBsyscall\fP(2). .P \fIملاحظة\fP: لا يوجد تعريف لـ \fIstruct linux_dirent\fP في glibc؛ انظر NOTES. .SH الوصف هذه ليست الواجهات التي تهمك. انظر إلى \fBreaddir\fP(3) لواجهة مكتبة C المتوافقة مع POSIX. .SS getdents() يقرأ استدعاء النظام \fBgetdents\fP() عدة بنى \fIlinux_dirent\fP من الدليل المشار إليه بواصف الملف المفتوح \fIfd\fP إلى المخزن المؤقت المشار إليه بـ \fIdirp\fP. تحدد الوسيطة \fIcount\fP حجم ذلك المخزن المؤقت. .P يُصرح عن بنية \fIlinux_dirent\fP كما يلي: .P .in +4n .EX struct linux_dirent { unsigned long d_ino; /* Inode number */ unsigned long d_off; /* Not an offset; see below */ unsigned short d_reclen; /* Length of this \f[I]linux_dirent\fR */ char d_name[]; /* Filename (null\-terminated) */ /* length is actually (d_reclen \- 2 \- offsetof(struct linux_dirent, d_name)) */ /* char pad; // Zero padding byte char d_type; // File type (only since Linux // 2.6.4); offset is (d_reclen \- 1) */ } .EE .in .P \fId_ino\fP هو رقم عقدة (inode). \fId_off\fP هو قيمة خاصة بنظام الملفات ليس لها معنى محدد لمساحة المستخدم، رغم أنها كانت في أنظمة الملفات القديمة المسافة من بداية الدليل إلى بداية \fIlinux_dirent\fP التالي؛ انظر \fBreaddir\fP(3). \fId_reclen\fP هو حجم هذا \fIlinux_dirent\fP بالكامل. \fId_name\fP هو اسم ملف منتهي بقيمة فارغة. .P \fId_type\fP هو بايت في نهاية البنية يشير إلى نوع الملف. يحتوي على إحدى القيم التالية (المعرفة في \fI\fP): .TP 12 \fBDT_BLK\fP هذا جهاز كتلي. .TP \fBDT_CHR\fP هذا جهاز محرفي. .TP \fBDT_DIR\fP هذا دليل. .TP \fBDT_FIFO\fP هذا أنبوب مسمى (FIFO). .TP \fBDT_LNK\fP هذا رابط رمزي. .TP \fBDT_REG\fP هذا ملف عادي. .TP \fBDT_SOCK\fP هذا مقبس نطاق UNIX. .TP \fBDT_UNKNOWN\fP نوع الملف غير معروف. .P حقل \fId_type\fP مطبق منذ Linux 2.6.4. يشغل مساحة كانت سابقًا بايت حشو مملوء بصفر في بنية \fIlinux_dirent\fP. وبالتالي، على النوى حتى Linux 2.6.3 وما يشملها، تؤدي محاولة الوصول إلى هذا الحقل دائمًا إلى القيمة 0 (\fBDT_UNKNOWN\fP). .P .\" kernel 2.6.27 .\" The same sentence is in readdir.2 حاليًا، بعض أنظمة الملفات فقط (من بينها: Btrfs، و ext2، و ext3، و ext4) لديها دعم كامل لإعادة نوع الملف في \fId_type\fP. يجب على جميع التطبيقات التعامل بشكل صحيح مع عودة \fBDT_UNKNOWN\fP. .SS getdents64() لم يعالج استدعاء النظام الأصلي \fBgetdents\fP() أنظمة الملفات الكبيرة وإزاحات الملفات الكبيرة. وبالتالي، أضاف Linux 2.4 \fBgetdents64\fP()، بأنواع أوسع لحقلي \fId_ino\fP و \fId_off\fP. بالإضافة إلى ذلك، يدعم \fBgetdents64\fP() حقل \fId_type\fP صريح. .P استدعاء النظام \fBgetdents64\fP() يشبه \fBgetdents\fP()، باستثناء أن وسيطته الثانية هي مؤشر إلى مخزن مؤقت يحتوي على بنى من النوع التالي: .P .in +4n .EX struct linux_dirent64 { ino64_t d_ino; /* 64\-bit inode number */ off64_t d_off; /* Not an offset; see getdents() */ unsigned short d_reclen; /* Size of this dirent */ unsigned char d_type; /* File type */ char d_name[]; /* Filename (null\-terminated) */ }; .EE .in .SH "قيمة الإرجاع" عند النجاح، يُعاد عدد البايتات المقروءة. عند نهاية الدليل، تُعاد 0. عند الخطأ، يُعاد \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEBADF\fP وصف ملف (file descriptor) غير صالح \fIfd\fP. .TP \fBEFAULT\fP تشير المعطيات (arguments) إلى خارج فضاء عناوين العملية المستدعية. .TP \fBEINVAL\fP مخزن النتائج المؤقت صغير جدًا. .TP \fBENOENT\fP لا يوجد دليل كهذا. .TP \fBENOTDIR\fP واصف الملف لا يشير إلى مجلد. .SH المعايير لا شيء. .SH التاريخ .TP \fBgetdents\fP() .\" SVr4 documents additional ENOLINK, EIO error conditions. SVr4. .TP \fBgetdents64\fP() glibc 2.30. .SH ملاحظات لا توفر glibc غلافًا لـ \fBgetdents\fP()؛ استدع \fBgetdents\fP() باستخدام \fBsyscall\fP(2). في هذه الحالة، ستحتاج إلى تعريف بنية \fIlinux_dirent\fP بنفسك. .P يقبل استدعاء النظام \fBgetdents64\fP() وسيطة \fBunsigned int\fP \fIcount\fP ويفترض أن \fIcount\fP لا يتجاوز \fBINT_MAX\fP. تضبط دالة الغلاف في glibc \fIcount\fP إلى \fBINT_MAX\fP إذا تجاوز \fBINT_MAX\fP. تعرّف glibc بنية \fIdirent64\fP، والتي تشبه \fIlinux_dirent64\fP ولكن مع \fId_name\fP بحجم 256 بايت. .P ربما، تريد استخدام \fBreaddir\fP(3) بدلاً من استدعاءات النظام هذه. .P تحل هذه الاستدعاءات محل \fBreaddir\fP(2). .SH أمثلة .\" FIXME The example program needs to be revised, since it uses the older .\" getdents() system call and the structure with smaller field widths. يوضح البرنامج أدناه استخدام \fBgetdents\fP(). يُظهر الإخراج التالي مثالاً لما نراه عند تشغيل هذا البرنامج على دليل ext2: .P .in +4n .EX $\fB ./a.out /testfs/\fP \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- nread=120 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- inode# file type d_reclen d_off d_name 2 directory 16 12 . 2 directory 16 24 .. 11 directory 24 44 lost+found 12 regular 16 56 a 228929 directory 16 68 sub 16353 directory 16 80 sub2 130817 directory 16 4096 sub3 .EE .in .SS "مصدر البرنامج" .\" SRC BEGIN (getdents.c) \& .EX #define _GNU_SOURCE #include /* Defines DT_* constants */ #include #include #include #include #include #include #include #include \& struct linux_dirent { unsigned long d_ino; off_t d_off; unsigned short d_reclen; char d_name[]; }; \& #define BUF_SIZE 1024 \& int main(int argc, char *argv[]) { int fd; char d_type; char buf[BUF_SIZE]; long nread; struct linux_dirent *d; \& fd = open(argc > 1 ? argv[1] : ".", O_RDONLY | O_DIRECTORY); if (fd == \-1) err(EXIT_FAILURE, "open"); \& for (;;) { nread = syscall(SYS_getdents, fd, buf, BUF_SIZE); if (nread == \-1) err(EXIT_FAILURE, "getdents"); \& if (nread == 0) break; \& printf("\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- nread=%ld \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\[rs]n", nread); printf("inode# file type d_reclen d_off d_name\[rs]n"); for (size_t bpos = 0; bpos < nread;) { d = (struct linux_dirent *) (buf + bpos); printf("%8lu ", d\->d_ino); d_type = *(buf + bpos + d\->d_reclen \- 1); printf("%\-10s ", (d_type == DT_REG) ? "regular" : (d_type == DT_DIR) ? "directory" : (d_type == DT_FIFO) ? "FIFO" : (d_type == DT_SOCK) ? "socket" : (d_type == DT_LNK) ? "symlink" : (d_type == DT_BLK) ? "block dev" : (d_type == DT_CHR) ? "char dev" : "???"); printf("%4d %10jd %s\[rs]n", d\->d_reclen, (intmax_t) d\->d_off, d\->d_name); bpos += d\->d_reclen; } } \& exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "انظر أيضًا" \fBreaddir\fP(2), \fBreaddir\fP(3), \fBinode\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .