Provided by: manpages-es_1.55-10_all bug

NOMBRE

       mincore - obtiene informacion de que paginas estan en memoria

SINOPSIS

       #include <unistd.h>
       #include <sys/mman.h>

       int mincore(void *start, size_t length, unsigned char *vec);

DESCRIPCI'ON

       La  funcion  mincore  solicita un vector describiendo que paginas de un
       fichero estan en memoria y pueden ser leidas sin acceder  a  disco.  El
       nucleo  suministrara  los  datos  para los length bytes siguientes a la
       direccion start.  Cuando regrese, el nucleo  habra  rellenado  vec  con
       bytes,  de  los  cuales el bit menos significativo indica si una pagina
       esta residente en memoria.

       Para que mincore tenga exito, start debe estar situada en un limite  de
       pagina.  Es  responsabilidad  del  invocador  redondear este valor a la
       pagina mas cercana. El parametro length no necesita ser un multiplo del
       tamano de pagina. El vector vec debe ser lo suficientemente grande para
       contener length/PAGE_SIZE bytes.  El tamano de pagina  puede  obtenerse
       con getpagesize(2).

VALOR DEVUELTO

       En caso de exito, mincore devuelve cero.  En caso de error, se devuelve
       -1, y errno es modificado con el valor apropiado.

ERRORES

       EAGAIN el nucleo se ha quedado temporalmente sin recursos

       EINVAL start no es multiplo del tamano de pagina, o len tiene un  valor
              no positivo

       EFAULT vec apunta a una direccion invalida

       ENOMEM address  a  address  +  length contiene memoria sin ubicar, o la
              memoria no es parte de un fichero.

FALLOS

       mincore deberia devolver un vector de bits y no un vector de  bytes,  A
       partir  de la version 2.4.5 de Linux, no es posible obtener informacion
       sobre la residencia  en  memoria  de  paginas  no  respaldadas  por  un
       fichero.   En  otras  palabras,  una llamada a mincore sobre una region
       anonima devuelta por mmap(2) no funciona y  asigna  a  errno  el  valor
       ENOMEM.  A  menos  que  las  paginas  esten  bloqueadas  en memoria, el
       contenido de vec puede estar desfasado para cuando alcancen el  espacio
       de usuario.

CONFORME A

       mincore no parece ser parte de POSIX o de la Single Unix Specification.

HISTORIA

       La funcion mincore() aparecio por primera vez en 4.4BSD.

DISPONIBILIDAD

       Presente desde Linux 2.3.99pre1 y glibc 2.2.

V'EASE TAMBI'EN

       getpagesize(2), mmap(2)