CLOSEDIR(3C) Standard C Library Functions CLOSEDIR(3C)

NAME

closedir - close a directory stream

SYNOPSIS

#include <sys/types.h>
#include <dirent.h>

int
closedir(DIR *dirp);

DESCRIPTION

The closedir() function closes the directory stream referred to by the
argument dirp, which generally came from calling opendir(3C) or
fdopendir(3C). Upon return, the value of dirp will no longer point to
an accessible object of the type DIR. The underlying file descriptor
for the directory stream will be closed. This includes a DIR created
by passing a file descriptor to fdopendir(3C).

When the directory stream is closed, any memory that is associated with
the stream will no longer be valid. Most notably, the dirent
structures returned from readdir(3C) use memory associated with the
corresponding DIR * argument. Each directory stream has its own
independent memory. Closing one stream does not impact the validity of
other streams.

RETURN VALUES

Upon successful completion, the closedir() function returns 0.
Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS

The closedir() function may fail if:

EBADF The dirp argument does not refer to an open
directory stream.

EINTR The closedir() function was interrupted by a signal.

INTERFACE STABILITY

Standard

MT-LEVEL
Safe

SEE ALSO

fdopendir(3C), opendir(3C), readdir(3C), attributes(7)

illumos February 25, 2021 illumos