close_range(2freebsd)

close_range2freebsd

Delete open file descriptors

Usage

#include <unistd.h>

void

closefrom(int lowfd);

int

close_range(u_int lowfd, u_int highfd, int flags);

Library

Standard C Library (libc, -lc)

Overview

The closefrom() system call deletes all open file descriptors greater than or equal to lowfd from the per-process object reference table. Any errors encountered while closing file descriptors are ignored.

The close_range() system call deletes all open file descriptors between lowfd and highfd inclusive, clamped to the range of open file descriptors. Any errors encountered while closing file descriptors are ignored. There are currently no defined flags.

Return values

Upon successful completion, close_range() returns a value of 0. Otherwise, a value of -1 is returned and the global variable errno is set to indicate the error.

Errors

The close_range() system call will fail if:

[EINVAL]

The highfd argument is lower than the lowfd argument.

[EINVAL]

An invalid flag was set.

Releases

Unchanged in 3 releases since Debian 11 (Bullseye).

  1. 11–13

History

The closefrom() function first appeared in FreeBSD 8.0.

From freebsd-manpages 12.2-2 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.