mincore (2)

Leading comments

 Copyright (c) 1991, 1993
	The Regents of the University of California.  All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer.
 2. Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following...

(The comments found at the beginning of the groff file "man2/mincore.2freebsd".)

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.

MINCORE_SUPER

Page is part of a "super" page. (only i386 & amd64)

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