НАИМЕНОВАНИЕ

close_range - закрыть все файловые дескрипторы в указанном диапазоне

БИБЛИОТЕКА

Стандартная библиотека языка C (libc, -lc)

ОБЗОР

#define _GNU_SOURCE         /* см. feature_test_macros(7) */
#include <unistd.h>

#include <linux/close_range.h> /* Definition of CLOSE_RANGE_*
                                  constants */

int close_range(unsigned int first, unsigned int last, int flags);

ОПИСАНИЕ

Системный вызов close_range() закрывает все открытые файловые дескрипторы от first до last (включительно).

Ошибки закрытия указанного файлового дескриптора в настоящее время игнорируются.

flags - это битовая маска, содержащая 0 или более из следующих:

CLOSE_RANGE_CLOEXEC (начиная с Linux 5.11)

Установить флаг close-on-exec для указанных файловых дескрипторов, вместо того, чтобы немедленно их закрыть.

CLOSE_RANGE_UNSHARE

Unshare the specified file descriptors from any other processes before closing them, avoiding races with other threads sharing the file descriptor table.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

В случае успеха close_range() возвращает 0. В случае ошибки возвращается -1 и errno устанавливается для указания ошибки.

ОШИБКИ

EINVAL

flags недействителен, или first больше, чем last.

Следующее может произойти с CLOSE_RANGE_UNSHARE (при построении новой таблицы дескрипторов):

EMFILE

The number of open file descriptors exceeds the limit specified in /proc/sys/fs/nr_open (see proc(5)). This error can occur in situations where that limit was lowered before a call to close_range() where the CLOSE_RANGE_UNSHARE flag is specified.

ENOMEM

Недостаточное количество памяти ядра.

СТАНДАРТЫ

Отсутствуют.

ИСТОРИЯ

FreeBSD. Linux 5.9, glibc 2.34.

ПРИМЕЧАНИЯ

/* нам не нужно ничего после stderr */
close_range(3, ~0U, CLOSE_RANGE_UNSHARE);
execve(....);

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

ПРИМЕРЫ

The program shown below opens the files named in its command-line arguments, displays the list of files that it has opened (by iterating through the entries in /proc/PID/fd), uses close_range() to close all file descriptors greater than or equal to 3, and then once more displays the process's list of open files. The following example demonstrates the use of the program:

$ touch /tmp/a /tmp/b /tmp/c
$ ./a.out /tmp/a /tmp/b /tmp/c
/tmp/a opened as FD 3
/tmp/b opened as FD 4
/tmp/c opened as FD 5
/proc/self/fd/0 ==> /dev/pts/1
/proc/self/fd/1 ==> /dev/pts/1
/proc/self/fd/2 ==> /dev/pts/1
/proc/self/fd/3 ==> /tmp/a
/proc/self/fd/4 ==> /tmp/b
/proc/self/fd/5 ==> /tmp/b
/proc/self/fd/6 ==> /proc/9005/fd
========= About to call close_range() =======
/proc/self/fd/0 ==> /dev/pts/1
/proc/self/fd/1 ==> /dev/pts/1
/proc/self/fd/2 ==> /dev/pts/1
/proc/self/fd/3 ==> /proc/9005/fd

Обратите внимание, что строки, показывающие имя пути /proc/9005/fd, являются результатом вызовов opendir(3).

#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>
/* Show the contents of the symbolic links in /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);
}

СМОТРИТЕ ТАКЖЕ

close(2)

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.