Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

posix_fadvise(2)					      posix_fadvise(2)

NAME
       posix_fadvise(), posix_fadvise64() - file advisory information

SYNOPSIS

   Parameters
       fd	 The  open  file  descriptor  to  which	 the fadvise operation
		 applies.

       offset	 The begining of the specified range as a positive, byte  off‐
		 set.

       len	 The length of the specified range in bytes.

       advice	 Specifies advice to be applied to range.

DESCRIPTION
       The  function  is used to advise the system about the expected behavior
       of the application with respect to the data in the file associated with
       the open file descriptor, fd, starting at offset and continuing for len
       bytes.  The specified range need not currently exist in the  file.   If
       len is zero, all data following offset is specified.

       It  should  be  noted  that the effect of all hints is cumulative for a
       given file object.  All hints will be removed on	 processing  the  last
       close of the file object.

       The  function may be used for large file access by a 32-bit application
       built with set to 64.

       The advice parameter is used to convey the hint to be  applied  to  the
       data and may be one of the following values:

       Specifies  that	the  application has no advice to give on its behavior
       with respect to the specified data.  It is the  default	characteristic
       if no advice is given for an open file.

       Specifies that the application expects to access the specified range of
       data
	      sequentially from the lower offsets to higher offsets.

       Specifies that the application will expect to access the specified
	      specified range of data in a random order.

       Specifies that the application will expect to access the specified
	      range of data in the near future.

       Specifies that the application will expect that it will not
	      access the specified range of data in the near future.

       Specifies that the application will  expect  to	access	the  specified
       range
	      of data once and then not reuse it thereafter.

       These values will be defined in

RETURN VALUE
	      Successful completion.
	      Failure.
		     is set to indicate the error.

ERRORS
       If the service fails, is set to one of the following values:

       The	      fd argument is not a valid file descriptor.

       The	      fd argument is associated with a pipe or FIFO.

       The  posix_fadvise  operation  is  not supported by the underlying file
       system.

       The value of   advice or one of the other input values has  been	 found
		      to be invalid.

       A designated hint is not supported by the underlying file object.

EXAMPLES
AUTHOR
       was derived by HP from the IEEE POSIX 1003.1-2001 Standard.

SEE ALSO
       fadvise(2), fcntl(2), fadvise(5), fcntl(5).

STANDARDS CONFORMANCE
							      posix_fadvise(2)

Vote for polarhome