MADVISE(2)                OpenBSD Programmer's Manual               MADVISE(2)

NAME
     madvise - give advice about use of memory

SYNOPSIS
     #include <sys/types.h>
     #include <sys/mman.h>

     int
     madvise(void *addr, size_t len, int behav);

DESCRIPTION
     The madvise() system call allows a process that has knowledge of its mem-
     ory behavior to describe it to the system.  The possible behaviors are:

     MADV_NORMAL      No further special treatment needed.

     MADV_RANDOM      Expect random page access patterns.

     MADV_SEQUENTIAL  Expect sequential page references.

     MADV_WILLNEED    The pages will be referenced soon.

     MADV_DONTNEED    The pages will not be referenced soon.

     MADV_SPACEAVAIL  Ensure that resources are reserved.

     MADV_FREE        The pages don't contain any useful data and can be recy-
                      cled.

RETURN VALUES
     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of -1 is returned and errno is set to indicate the error.

SEE ALSO
     mincore(2), minherit(2), mprotect(2), msync(2), munmap(2)

HISTORY
     The madvise function first appeared in 4.4BSD.

OpenBSD 3.5                      June 9, 1993                                1
