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

FreeBSD Manual Pages

  
 
  

home | help
POSIX_FADVISE(2)	    BSD	System Calls Manual	      POSIX_FADVISE(2)

NAME
     posix_fadvise -- hint at the future access	pattern	of a file

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <sys/fcntl.h>

     int
     posix_fadvise(int fd, off_t offset, off_t size, int hint);

DESCRIPTION
     posix_fadvise() hints at the application's	access pattern to the file and
     range given by the	file descriptor, fd, and offset	and size.  If size is
     zero, it means to the end of file.

     hint should be one	of the followings.

	   POSIX_FADV_NORMAL	  No hint.  (default)
	   POSIX_FADV_RANDOM	  Random access.
	   POSIX_FADV_SEQUENTIAL  Sequential access.  (from lower offset to
				  higher offset.)
	   POSIX_FADV_WILLNEED	  Will be accessed.
	   POSIX_FADV_DONTNEED	  Will not be accessed.
	   POSIX_FADV_NOREUSE	  Will be accessed just	once.

     Calling posix_fadvise() doesn't alter the semantics of the	operations, it
     is	only a matter of performance.

RETURN VALUES
     On	success, posix_fadvise() returns 0.  Otherwise,	it returns an error
     number.

SEE ALSO
     errno(2), madvise(2)

BUGS
     For POSIX_FADV_NORMAL, POSIX_FADV_RANDOM, and POSIX_FADV_SEQUENTIAL, the
     current implementation ignores offset and size, and applies the hint to
     the whole file.

BSD				 June 9, 2009				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=posix_fadvise&sektion=2&manpath=NetBSD+6.0>

home | help