NOMBRE
madvise − aconseja sobre el uso de memoria
SINOPSIS
#include <sys/mman.h>
int madvise(void *start, size_t length, int advice);
DESCRIPCIÓN
La llamada al sistema madvise aconseja al núcleo sobre como manejar la paginación de entrada/salida en el rango de direcciones que comienza en start y tiene de longitud length bytes. Permite a una aplicación decirle al núcleo como espera usar algunas zonas de memoria compartida o mapeada, para que así el núcleo pueda elegir las técnicas apropiadas de pre-lectura y caché. Esta llamada no influye en la semántica de la aplicación (excepto en el caso de MADV_DONTNEED), pero puede influir en su rendimiento. El núcleo puede ignorar libremente este consejo.
El consejo se
indica en el parámetro advice que puede tomar
los valores
MADV_NORMAL
Trato no especial. Éste es el valor por defecto.
MADV_RANDOM
Espera las referencias a páginas en orden aleatorio. (Por tanto, la pre-lectura puede ser menos útil de lo habitual.)
MADV_SEQUENTIAL
Espera las referencias a páginas en orden secuencial. (Por tanto, las páginas en el rango dado pueden ser accedidas con pre-lectura y liberadas poco después del acceso.)
MADV_WILLNEED
Espera algún acceso en un futuro cercano. (Por tanto, sería buena idea leer algunas páginas por adelantado.)
MADV_DONTNEED
No esperes ningún acceso en un futuro cercano (por el momento, la aplicación ha terminado de usar el rango especificado, por lo que el núcleo puede liberar recursos asociados a la misma). Los accesos siguientes a páginas en este rango tendrán exito, pero producirán o bien que se vuelva a cargar el contenido de memoria desde el fichero mapeado subyacente (véase mmap) o bien páginas llenas de ceros para mapeos sin fichero subyacente.
VALOR DEVUELTO
En caso de éxito madvise devuelve cero. En caso de error, devuelve −1 y modifica errno con el valor apropiado.
ERRORES
|
EINVAL |
el valor len es negativo, start no se encuentra en un límite de página, advice no es un valor válido, o la aplicación está intentado liberar páginas bloqueadas o compartidas (con MADV_DONTNEED). | ||
|
ENOMEM |
las direcciones en el rango especificado no están mapeadas actualmente, o están fuera del rango de direcciones del proceso. | ||
|
ENOMEM |
(para MADV_WILLNEED) Memoria insuficiente - paginación fallida. | ||
|
EIO |
(para MADV_WILLNEED) La paginación de esta área excedería el tamaño máximo para el conjunto residente. | ||
|
EBADF |
existe la correspondencia, pero el área mapeada no se corresponde con un fichero. | ||
|
EAGAIN |
un recurso del núcleo está temporalmente no disponible. |
OBSERVACIONES LINUX
La implementación actual de Linux (2.4.0) ve esta llamada al sistema más como una orden que como un consejo y por lo tanto puede devolver un error cuando no puede llevar a cabo lo que habitualmente podría en respuesta a este consejo. (Véase la descripción de ERRORES arriba.) Éste es un comportamiento no éstandar.
La implementación de Linux requiere que la dirección start comienze en un límite de página, y permite que length sea cero. Si algunas partes del rango de direcciones especificado no están mapeadas, la versión de Linux de madvise las ignora y aplica la llamada sobre el resto (pero devuelve ENOMEM como debería ser).
HISTORIA
La función madvise apareció por primera vez en 4.4BSD.
CONFORME A
POSIX.1b (POSIX.4). POSIX 1003.1-2001 describe posix_madvise con las constantes POSIX_MADV_NORMAL, etc., con un comportamiento parecido al descrito aquí. Hay un posix_fadvise similar para acceso a ficheros.
VÉASE TAMBIÉN
getrlimit(2), mmap(2), mincore(2), mprotect(2), msync(2), munmap(2)