mincore(2)
mincore --
determine residency of memory pages
Synopsis
#include <unistd.h>
int mincore(caddr_t addr, size_t len, char vec);
Description
mincore
returns the primary memory
residency status of pages in the address space
covered by mappings in the range
[addr, addr + len).
The status is returned as a character-per-page in the
character array referenced by
vec
(which the system assumes to be large enough to encompass
all the pages in the address range).
The least significant bit of each
character is set to 1 to indicate that the referenced page is in primary
memory, 0 if it is not.
The settings of other bits in each character are
undefined and may contain other information in future implementations.
mincore
returns residency information that is accurate at an instant in time.
Because the system may frequently adjust the set of pages in memory,
this information may quickly be outdated.
Only locked pages are guaranteed to remain in memory; see
memcntl(2).
Return values
On success, mincore returns 0.
On failure, mincore returns -1 and sets errno to identify the error.
Errors
In the following conditions, link fails and sets errno to:
EFAULT-
vec
includes an out-of-range or otherwise inaccessible address.
EINVAL-
addr
is not a multiple of the page size as returned by
sysconf(3C).
ENOMEM-
The argument
len
has a value less than or equal to 0.
ENOMEM-
Addresses in the range
[addr, addr + len)
are invalid for the address space of a process, or specify
one or more pages which are not mapped.
References
memcntl(2),
mlock(3C),
mmap(2),
sysconf(3C)
Notices
Considerations for threads programming
Sibling threads share (by definition) the same address space.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004