Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

MINCORE(2)		    BSD System Calls Manual		    MINCORE(2)

NAME
     mincore — determine residency of memory pages

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <sys/mman.h>

     int
     mincore(void *addr, size_t len, char *vec);

DESCRIPTION
     The mincore() system call allows a process to obtain information about
     whether pages are core resident.  The status of the memory range is
     returned in the character-per-page array vec.  If the page is resident,
     the least significant bit of the corresponding character in vec will be
     set.  Other bits are reserved for additional information which future
     implementations may return.

     Note that the status of each page may change between the call to
     mincore() and the return of the page status information.  In order to
     guarantee that pages will remain in core, the address range must be
     locked with mlock(2).

RETURN VALUES
     mincore() returns 0 on success, or -1 on failure and sets the variable
     errno to indicate the error.

ERRORS
     The mincore() call will fail if:

     [EFAULT]		vec points to an illegal address.

     [EINVAL]		addr is not a multiple of the system page size.

     [EINVAL]		len is equal to 0.

     [ENOMEM]		The address range specified is invalid for the calling
			process, or one or more of the pages specified in the
			range are not mapped.

SEE ALSO
     madvise(2), mlock(2), mprotect(2), msync(2), munmap(2), sysconf(3)

HISTORY
     The mincore() function first appeared in 4.4BSD.

BSD				 June 6, 1999				   BSD

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome