posix_fadvise(2)						System Calls Manual						  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 offset. 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)