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