Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
close(2)		      System Calls Manual		      close(2)

NAME
       close - close a file descriptor

SYNOPSIS
DESCRIPTION
       closes  the  file descriptor indicated by fildes.  fildes is a file de-
       scriptor	obtained from a	or system call.	 All associated	file  segments
       which  have  been locked	by this	process	with the function are released
       (i.e., unlocked).

RETURN VALUE
       Upon successful completion, returns a value of 0; otherwise, it returns
       -1 and sets to indicate the error.

ERRORS
       fails if	the any	of following conditions	are encountered:

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

	      [EINTR]	     An	 attempt  to close a slow device or connection
			     or	file with pending aio requests was interrupted
			     by	 a signal. The file descriptor still points to
			     an	open device or connection or file.

	      [ENOSPC]	     Not enough	space on the file system.  This	 error
			     can occur when closing a file on an NFS file sys-
			     tem.  [When a system call is executed on a	 local
			     file system and if	a new buffer needs to be allo-
			     cated to hold the data, the buffer	is mapped onto
			     the  disk	at that	time.  A full disk is detected
			     at	this time and returns an error.	 When the sys-
			     tem  call	is executed on an NFS file system, the
			     new buffer	 is  allocated	without	 communicating
			     with  the NFS server to see if there is space for
			     the buffer	(to improve NFS	performance).	It  is
			     only when the buffer is written to	the server (at
			     file close	or the buffer is full) that the	 disk-
			     full condition is detected.]

SEE ALSO
       creat(2),   dup(2),  exec(2),  fcntl(2),	 lockf(2),  open(2),  pipe(2),
       thread_safety(5).

STANDARDS CONFORMANCE
								      close(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=close&sektion=2&manpath=HP-UX+11.22>

home | help