table of contents
other versions
- wheezy 3.44-1
- jessie 3.74-1
- jessie-backports 4.10-2~bpo8+1
- testing 4.10-2
- unstable 4.10-2
other sections
MINCORE(2) | Linux Programmer's Manual | MINCORE(2) |
NAME¶
mincore - determine whether pages are resident in memorySYNOPSIS¶
#include <unistd.h>Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
DESCRIPTION¶
mincore() returns a vector that indicates whether pages of the calling process's virtual memory are resident in core (RAM), and so will not cause a disk access (page fault) if referenced. The kernel returns residency information about the pages starting at the address addr, and continuing for length bytes.RETURN VALUE¶
On success, mincore() returns zero. On error, -1 is returned, and errno is set appropriately.ERRORS¶
EAGAIN kernel is temporarily out of resources.- EFAULT
- vec points to an invalid address.
- EINVAL
- addr is not a multiple of the page size.
- ENOMEM
- length is greater than (TASK_SIZE - addr). (This could occur if a negative value is specified for length, since that value will be interpreted as a large unsigned integer.) In Linux 2.6.11 and earlier, the error EINVAL was returned for this condition.
- ENOMEM
- addr to addr + length contained unmapped memory.
VERSIONS¶
Available since Linux 2.3.99pre1 and glibc 2.2.CONFORMING TO¶
mincore() is not specified in POSIX.1-2001, and it is not available on all UNIX implementations.BUGS¶
Before kernel 2.6.21, mincore() did not return correct information for MAP_PRIVATE mappings, or for nonlinear mappings (established using remap_file_pages(2)).SEE ALSO¶
mlock(2), mmap(2)COLOPHON¶
This page is part of release 3.44 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.2008-04-22 | Linux |