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   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

mincore(2)							    mincore(2)

NAME
       mincore() - determine residency of memory pages

SYNOPSIS
DESCRIPTION
       The  function determines the residency of the memory pages specified by
       the range [addr, addr+len].  The status is returned as a character-per-
       page  in	 the character array referenced by vec.	 The least significant
       bit of each character is set to 1 to indicate the referenced page is in
       memory  and to 0 to indicate that it is not. The settings of other bits
       in each character are undefined and may contain other information about
       a page in future implementations.

       This  system  call  returns  the	 status of all memory pages within the
       range, addr to addr+len.	 The addr parameter is	automatically  rounded
       down  to	 the nearest page size as returned by system call.  If the len
       value is not a multiple of the page size	 as  returned  by  the	system
       call,  the  end	of the range is rounded up to the next multiple of the
       page size.

       The vector vec must be large enough to contain one byte per memory page
       within the address range.

   Warnings
       Because	the  status  of	 a page can change between the time checks and
       returns the information, returned information might be outdated.	  Only
       locked pages are guaranteed to remain in memory.	 See mlock(2).

RETURN VALUE
       Upon  successful	 completion, returns Otherwise, it returns and sets to
       indicate the error.

ERRORS
       The function will fail if:

	      The	     vec argument points to an illegal address	or  an
			     address  for which the caller does not have write
			     mode access.

	      len	     argument has a value less than or equal to 0.

	      Addresses in the range
			     [addr, addr+len] span beyond the address space of
			     a 64-bit process.

	      Addresses in the range
			     [addr,  addr+len]	are  invalid or not mapped for
			     the address space of a process.

SEE ALSO
       mmap(2), mlock(2), plock(2), sysconf(2), <sys/mman.h>.

								    mincore(2)

Vote for polarhome