إغلاق كل واصفات الملفات المفتوحة¶

لتجنب إغلاق واصفات الملفات بشكل أعمى في نطاق واصفات الملفات الممكنة، يُنفذ هذا أحيانًا (على لينكس) بسرد واصفات الملفات المفتوحة في /proc/self/fd/ واستدعاء close(2) على كل واحد. close_range() يمكنه التعامل مع هذا دون الحاجة إلى /proc وداخل استدعاء نظام واحد، مما يوفر فوائد أداء كبيرة.

إغلاق واصفات الملفات قبل التنفيذ¶

يمكن إغلاق واصفات الملفات بأمان باستخدام

/* we don't want anything past stderr here */
close_range(3, ~0U, CLOSE_RANGE_UNSHARE);
execve(....);

CLOSE_RANGE_UNSHARE مكافئ من الناحية المفاهيمية لـ

unshare(CLONE_FILES);
close_range(first, last, 0);

لكنه يمكن أن يكون أكثر كفاءة: إذا امتد النطاق المفصول إلى ما بعد الحد الأقصى الحالي لعدد واصفات الملفات المخصصة في جدول واصفات ملفات المستدعي (الحالة الشائعة عندما يكون last هو ~0U)، سيفصل النواة جدول واصفات ملفات جديد للمستدعي حتى first، ناسخًا أقل عدد ممكن من واصفات الملفات. هذا يتجنب استدعاءات close(2) اللاحقة تمامًا؛ تكتمل العملية بأكملها بمجرد فصل الجدول.

إغلاق الملفات عند التنفيذ¶

هذا مفيد بشكل خاص في الحالات حيث خطوات الإعداد المتعددة قبل exec تخاطر بالتعارض مع بعضها البعض. على سبيل المثال، إعداد تشكيلة seccomp(2) يمكن أن يتعارض مع استدعاء close_range(): إذا أغلقت واصفات الملفات قبل إعداد تشكيلة seccomp(2)، لا يمكن لإعداد التشكيلة استخدامها بنفسها، أو التحكم في إغلاقها؛ إذا أغلقت واصفات الملفات بعد ذلك، لا يمكن لتشكيلة seccomp حظر استدعاء close_range() أو أي بدائل. استخدام CLOSE_RANGE_CLOEXEC يتجنب هذا: يمكن وضع علامة على الواصفات قبل إعداد تشكيلة seccomp(2)، ويمكن للتشكيلة التحكم في الوصول إلى close_range() دون التأثير على عملية الاستدعاء.

مصدر البرنامج¶

#define _GNU_SOURCE
#include <dirent.h>
#include <fcntl.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <unistd.h>
/* إظهار محتويات الروابط الرمزية في /proc/self/fd */
static void
show_fds(void)
{


    DIR            *dirp;


    char           path[PATH_MAX], target[PATH_MAX];


    ssize_t        len;


    struct dirent  *dp;


    dirp = opendir("/proc/self/fd");


    if (dirp  == NULL) {


        perror("opendir");


        exit(EXIT_FAILURE);


    }


    for (;;) {


        dp = readdir(dirp);


        if (dp == NULL)


            break;


        if (dp->d_type == DT_LNK) {


            snprintf(path, sizeof(path), "/proc/self/fd/%s",


                     dp->d_name);


            len = readlink(path, target, sizeof(target));


            printf("%s ==> %.*s\n", path, (int) len, target);


        }


    }


    closedir(dirp);
}
int
main(int argc, char *argv[])
{


    int  fd;


    for (size_t j = 1; j < argc; j++) {


        fd = open(argv[j], O_RDONLY);


        if (fd == -1) {


            perror(argv[j]);


            exit(EXIT_FAILURE);


        }


        printf("%s opened as FD %d\n", argv[j], fd);


    }


    show_fds();


    printf("========= About to call close_range() =======\n");


    if (close_range(3, ~0U, 0) == -1) {


        perror("close_range");


        exit(EXIT_FAILURE);


    }


    show_fds();


    exit(EXIT_FAILURE);
}