Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
mincore(2)
Edit
PageHistory
Diff
Info
LikePages
You are viewing an old revision of this page.
View the current version
.
MINCORE !!!MINCORE NAME SYNOPSIS DESCRIPTION RETURN VALUE ERRORS BUGS CONFORMING TO HISTORY AVAILABILITY SEE ALSO ---- !!NAME mincore - get information on whether pages are in core !!SYNOPSIS __#include __ #include __ __int mincore(void *__''start''__, size_t__ ''length''__, unsigned char *__ ''vec''__);__ !!DESCRIPTION The __mincore__ function requests a vector describing which pages of a file are in core and can be read without disk access. The kernel will supply data for ''length'' bytes following the ''start'' address. On return, the kernel will have filled ''vec'' with bytes, of which the least significant bit indicates if a page is core resident. For __mincore__ to return successfully, ''start'' must lie on a page boundary. It is the caller's responsibility to round up to the nearest page. The ''length'' parameter need not be a multiple of the page size. The vector ''vec'' must be large enough to contain length/PAGE_SIZE bytes. One may obtain the page size from __getpagesize(2).__ !!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 __EINVAL__ is not a multiple of the page size, or has a non-positive value __EFAULT__ ''vec'' points to an illegal address __ENOMEM__ ''address'' to ''address'' + ''length'' contained unmapped memory, or memory not part of a file. !!BUGS __mincore__ should return a bit vector and not a byte vector. As of Linux 2.4.5, it is not possible to gain information on the core residency of pages which are not backed by a file. In other words, calling __mincore__ on an region returned by an anonymous __mmap(2)__ does not work and sets errno to ENOMEM. Unless pages are locked in memory, the contents of ''vec'' may be stale by the time they reach userspace. !!CONFORMING TO __mincore__ does not appear to be part of POSIX or the Single Unix Specification. !!HISTORY The mincore() function first appeared in 4.4BSD. !!AVAILABILITY Since Linux 2.3.99pre1 and glibc 2.2. !!SEE ALSO getpagesize(2), mmap(2) ----
2 pages link to
mincore(2)
:
Man2m
madvise(2)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
