الاسم¶

stat, fstat, lstat, fstatat - الحصول على حالة الملف

المكتبة¶

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

موجز¶

#include <sys/stat.h>

int stat(const char *restrict pathname,
         struct stat *restrict statbuf);
int fstat(int fd, struct stat *statbuf);
int lstat(const char *restrict pathname,
         struct stat *restrict statbuf);

#include <fcntl.h>           /* تعريف ثوابت AT_* */
#include <sys/stat.h>

int fstatat(int dirfd, const char *restrict pathname,
         struct stat *restrict statbuf, int flags);

lstat():

    /* منذ glibc 2.20 */ _DEFAULT_SOURCE


        || _XOPEN_SOURCE >= 500


        || /* منذ glibc 2.10: */ _POSIX_C_SOURCE >= 200112L


        || /* إصدار glibc 2.19 وما قبله */ _BSD_SOURCE

fstatat():

    منذ glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    قبل glibc 2.10:


        _ATFILE_SOURCE

الوصف¶

تعيد هذه الدوال معلومات حول ملف، في المخزن المؤقت المشار إليه بـ statbuf. لا تتطلب أذونات على الملف نفسه، ولكن—في حالة stat() و fstatat() و lstat()—يتطلب إذن تنفيذ (بحث) على جميع الأدلة في pathname التي تؤدي إلى الملف.

stat() و fstatat() تسترجعان معلومات حول الملف المشار إليه بـ pathname؛ الاختلافات لـ fstatat() موصوفة أدناه.

lstat() مطابق لـ stat()، باستثناء أنه إذا كان pathname رابطاً رمزياً، فإنه يعيد معلومات حول الرابط نفسه، وليس الملف الذي يشير إليه الرابط.

fstat() مطابق لـ stat()، باستثناء أن الملف الذي سيُسترجع معلومات عنه يُحدد بواسطة واصف الملف fd.

قيمة الإرجاع¶

عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء¶

EACCES

رُفض إذن البحث لأحد الأدلة في بادئة مسار pathname. (انظر أيضًا path_resolution(7).)

EBADF

fd ليس واصف ملف مفتوحًا صالحًا.

EBADF

(fstatat()) pathname نسبي ولكن dirfd ليس AT_FDCWD ولا واصف ملف صالح.

EFAULT

عنوان سيء.

EINVAL

(fstatat()) عُلم غير صالح محدد في flags.

ELOOP

صُودف عدد كبير جداً من الروابط الرمزية أثناء اجتياز المسار.

ENAMETOOLONG

مسار الملف pathname طويل جداً.

ENOENT

أحد مكونات pathname غير موجود أو أنه وصلة رمزية معلقة.

ENOENT

pathname سلسلة فارغة ولم يُحدد AT_EMPTY_PATH في flags.

ENOMEM

نفاد الذاكرة (أي ذاكرة نواة الحاسوب).

ENOTDIR

أحد مكونات بادئة المسار لـ pathname ليس دليلاً.

ENOTDIR

(fstatat()) pathname نسبي و dirfd هو واصف ملف يشير إلى ملف غير دليل.

EOVERFLOW

يشير pathname أو fd إلى ملف لا يمكن تمثيل حجمه أو رقم inode أو عدد الكتل فيه في الأنواع off_t أو ino_t أو blkcnt_t على التوالي. يمكن أن يحدث هذا الخطأ عندما، على سبيل المثال، يستدعي تطبيق جُمّع على منصة 32 بت بدون -D_FILE_OFFSET_BITS=64 الدالة stat() على ملف يتجاوز حجمه (1<<31)-1 بايت.

المعايير¶

POSIX.1-2008.

التاريخ¶

stat()

fstat()

lstat()

SVr4، 4.3BSD، POSIX.1-2001.

fstatat()

POSIX.1-2008. لينكس 2.6.16،‏ glibc 2.4.

وفقًا لـ POSIX.1-2001، يجب على lstat() عند استدعائه على وصلة رمزية أن يرجع معلومات صالحة فقط في الحقل st_size ونوع الملف في الحقل st_mode من بنية stat. شددت المواصفة POSIX.1-2008 هذه المتطلبات، حيث ألزمت lstat() بإرجاع معلومات صالحة في جميع الحقول باستثناء بتات الوضع (mode bits) في st_mode.

قد يكون استخدام الحقلين st_blocks و st_blksize أقل قابلية للنقل. (أُدخل هذان الحقلان في BSD. ويختلف تفسيرهما بين الأنظمة، وربما يختلفان في النظام الواحد عند وجود عمليات وصل NFS.)

أمثلة¶

يستدعي البرنامج التالي lstat() ويعرض حقولاً مختارة في هيكل stat المُعاد.

#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
#include <sys/sysmacros.h>
#include <time.h>
int
main(int argc, char *argv[])
{


    struct stat sb;


    if (argc != 2) {


        fprintf(stderr, "Usage: %s <pathname>\n", argv[0]);


        exit(EXIT_FAILURE);


    }


    if (lstat(argv[1], &sb) == -1) {


        perror("lstat");


        exit(EXIT_FAILURE);


    }


    printf("ID of containing device:  [%x,%x]\n",


           major(sb.st_dev),


           minor(sb.st_dev));


    printf("File type:                ");


    switch (sb.st_mode & S_IFMT) {


    case S_IFBLK:  printf("block device\n");            break;


    case S_IFCHR:  printf("character device\n");        break;


    case S_IFDIR:  printf("directory\n");               break;


    case S_IFIFO:  printf("FIFO/pipe\n");               break;


    case S_IFLNK:  printf("symlink\n");                 break;


    case S_IFREG:  printf("regular file\n");            break;


    case S_IFSOCK: printf("socket\n");                  break;


    default:       printf("unknown?\n");                break;


    }


    printf("I-node number:            %ju\n", (uintmax_t) sb.st_ino);


    printf("Mode:                     %jo (octal)\n",


           (uintmax_t) sb.st_mode);


    printf("Link count:               %ju\n", (uintmax_t) sb.st_nlink);


    printf("Ownership:                UID=%ju   GID=%ju\n",


           (uintmax_t) sb.st_uid, (uintmax_t) sb.st_gid);


    printf("Preferred I/O block size: %jd bytes\n",


           (intmax_t) sb.st_blksize);


    printf("File size:                %jd bytes\n",


           (intmax_t) sb.st_size);


    printf("Blocks allocated:         %jd\n",


           (intmax_t) sb.st_blocks);


    printf("Last status change:       %s", ctime(&sb.st_ctime));


    printf("Last file access:         %s", ctime(&sb.st_atime));


    printf("Last file modification:   %s", ctime(&sb.st_mtime));


    exit(EXIT_SUCCESS);
}

انظر أيضًا¶

ls(1)، stat(1)، access(2)، chmod(2)، chown(2)، readlink(2)، statx(2)، utime(2)، stat(3type)، capabilities(7)، inode(7)، symlink(7)

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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