mincore.2freebsd

Langue: en

Autres versions - même langue

Version: 315745 (ubuntu - 07/07/09)

Section: 2 (Appels système)


BSD mandoc

NAME

mincore - determine residency of memory pages

LIBRARY

Lb libc

SYNOPSIS

In sys/mman.h Ft int Fn mincore const void *addr size_t len char *vec

DESCRIPTION

The Fn mincore system call determines whether each of the pages in the region beginning at Fa addr and continuing for Fa len bytes is resident. The status is returned in the Fa vec array, one character per page. Each character is either 0 if the page is not resident, or a combination of the following flags (defined in In sys/mman.h ) :
MINCORE_INCORE
Page is in core (resident).
MINCORE_REFERENCED
Page has been referenced by us.
MINCORE_MODIFIED
Page has been modified by us.
MINCORE_REFERENCED_OTHER
Page has been referenced.
MINCORE_MODIFIED_OTHER
Page has been modified.

The information returned by Fn mincore may be out of date by the time the system call returns. The only way to ensure that a page is resident is to lock it into memory with the mlock(2) system call.

RETURN VALUES

Rv -std mincore

ERRORS

The Fn mincore system call will fail if:
Bq Er ENOMEM
The virtual address range specified by the Fa addr and Fa len arguments is not fully mapped.
Bq Er EFAULT
The Fa vec argument points to an illegal address.

SEE ALSO

madvise(2), mlock(2), mprotect(2), msync(2), munmap(2), getpagesize(3)

HISTORY

The Fn mincore system call first appeared in BSD 4.4