mincore(2)                                                mincore(2)


       NAME
             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.




                           Copyright 1994 Novell, Inc.               Page 1

      mincore(2)                                                mincore(2)


      REFERENCES
            memcntl(2), mlock(3C), mmap(2), sysconf(3C)

      NOTICES
         Considerations for Threads Programming
            Sibling threads share (by definition) the same address space.










































                          Copyright 1994 Novell, Inc.               Page 2