close()

Close a file

Synopsis:

#include <unistd.h>

int close( int filedes );

Library:

libc

Description:

The close() function closes the file specified by the file descriptor specified by filedes.

The filedes argument can be a file descriptor returned by a successful call to creat(), dup(), dup2(), fcntl(), modem_open(), open(), shm_open(), socket() or sopen() functions.

Returns:

Zero for success, or -1 if an error occurs (errno is set).

Errors:

EBADF

Invalid file descriptor filedes.

EINTR

The close() call was interrupted by a signal.

EIO

An I/O error occurred while updating the directory information.

ENOSPC

A previous buffered write call has failed.

ENOSYS

The close() function isn't implemented for the filesystem specified by filedes.

Examples:

#include <fcntl.h>
#include <unistd.h>
#include <stdlib.h>

int main( void )
{
    int filedes;

    filedes = open( "file", O_RDONLY );
    if( filedes != -1 ) {
        /* process file */
        close( filedes );

        return EXIT_SUCCESS;
    }

    return EXIT_FAILURE;
}

Classification:

POSIX 1003.1

See also:

creat(), dup(), dup2(), errno, fcntl(), modem_open(), open(), shm_open(), socket(), sopen()