CLOSE(2)             INTERACTIVE UNIX System             CLOSE(2)



          NAME
               close - close a file descriptor

          SYNOPSIS
               int close (fildes)
               int fildes;

          DESCRIPTION
               The fildes argument is a file descriptor obtained from a
               creat, open, dup, fcntl, or pipe system call.  The close
               system call closes the file descriptor indicated by fildes.
               All outstanding record locks owned by the process (on the
               file indicated by fildes) are removed.

               If a STREAMS [see intro(2)] file is closed, and the calling
               process had previously registered to receive a SIGPOLL sig-
               nal [see signal(2) and sigset(2)] for events associated with
               that file [see I_SETSIG in streamio(7)], the calling process
               will be unregistered for events associated with the file.
               The last close for a stream causes the stream associated
               with fildes to be dismantled.  If O_NDELAY is not set and
               there have been no signals posted for the stream, close
               waits up to 15 seconds, for each module and driver, for any
               output to drain before dismantling the stream.  If the
               O_NDELAY flag is set or if there are any pending signals,
               close does not wait for output to drain and dismantles the
               stream immediately.

               The named file is closed unless one or more of the following
               is true:

               [EBADF]        The fildes argument is not a valid open file
                              descriptor.

               [EINTR]        A signal was caught during the close system
                              call.

               [ENOLINK]      Fildes is on a remote machine and the link to
                              that machine is no longer active.

          SEE ALSO
               creat(2), dup(2), exec(2), fcntl(2), intro(2), open(2),
               pipe(2), signal(2), sigset(2).
               streamio(7) in the INTERACTIVE UNIX System User's/System
               Administrator's Reference Manual.

          DIAGNOSTICS
               Upon successful completion, a value of 0 is returned.  Oth-
               erwise, a value of -1 is returned, and errno is set to indi-
               cate the error.





          Rev. C Software Development Set                            Page 1