*** UNIX MANUAL PAGE BROWSER ***

madvise(2) System Calls Manual madvise(2) NAME madvise - Advise the system of the expected paging behavior of a process SYNOPSIS #include <sys/types.h> #include <sys/mman.h> int madvise ( caddr_t addr, size_t len, int behav ); PARAMETERS Specifies the address of the region to which the advice refers. Speci- fies the length in bytes of the region specified by the addr parameter. Specifies the behavior of the region. The following values for the be- hav parameter are defined in the sys/mman.h header file: No further special treatment Expect random page references Expect sequential ref- erences Will need these pages Do not need these pages The system will free any whole pages in the specified region. All mod- ifications will be lost and any swapped out pages will be discarded. Subsequent access to the region will result in a zero-fill-on-demand fault as though it is being accessed for the first time. Reserved swap space is not affected by this call. Ensure that resources are reserved DESCRIPTION The madvise() function permits a process to advise the system about its expected future behavior in referencing a mapped file or shared memory region. NOTES Only a few values of the behav parameter values are operational on DIG- ITAL UNIX systems. Non-operational values cause the system to always return success (zero). RETURN VALUES Upon successful completion, the madvise() function returns zero. Oth- erwise, -1 is returned and errno is set to indicate the error. ERRORS If the madvise() function fails, errno may be set to one of the follow- ing values: The behav parameter is invalid. The behav parameter speci- fies MADV_SPACEAVAIL and resources cannot be reserved. RELATED INFORMATION Functions: mmap(2) delim off madvise(2)