MINCORE

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
BOGUES
CONFORMITÉ
HISTORIQUE
DISPONIBILITÉ
VOIR AUSSI
TRADUCTION

NOM

mincore - Savoir quelles pages se trouvent en mémoire physique

SYNOPSIS

#include <unistd.h>
#include <sys/mman.h>
int mincore(void *start, size_t length, unsigned char *vec);

DESCRIPTION

La fonction mincore() réclame un vecteur (une table) indiquant quelles pages d'un fichier se trouvent en mémoire physique et peuvent être lues sans accès disque. Le noyau fournira les données concernant les length octets à partir de l'adresse start. En retour, le noyau aura rempli la zone vec avec des octets dont le bit de poids faible indique si la page est en mémoire physique. (Les autres bits sont indéfinis, réservés pour une possible utilisation ultérieure.) Bien sûr, ce n'est qu'un instantané --- les pages qui ne sont pas verrouillées en mémoire peuvent aller et venir à tout moment, et le contenu de vec peut être déjà périmé au retour de l'appel.
Pour que mincore() réussisse, start doit être alignée sur une frontière de page. C'est la responsabilité de l'appelant d'arrondir l'adresse à la page la plus proche. Le paramètre length n'est pas nécessairement un multiple de la taille de page. Le vecteur vec doit être assez grand pour contenir (length+PAGE_SIZE-1)/PAGE_SIZE octets. On peut connaître la taille de page en invoquant getpagesize(2).

VALEUR RENVOYÉE

Si elle réussit, la fonction mincore() renvoie zéro. En cas d'erreur, elle renvoie -1 et remplit errno avec la valeur d'erreur.

ERREURS

EAGAIN Le noyau manque temporairement de ressources.

EFAULT: vec pointe vers une adresse illégale.
EINVAL: start n'est pas un multiple de la taille de page.
ENOMEM: len est plus grand que (TASK_SIZE - start). Ceci peut se produire si len a une valeur négative, car cette valeur sera interprétée comme un entier non signé. Sous Linux 2.6.11 et précédents, cette condition renvoyait l'erreur EINVAL.
ENOMEM: La zone entre address et address + length contient de la mémoire autre qu'une projection de fichier.

BOGUES

Jusqu'à présent (Linux 2.6.5), mincore() ne renvoie pas d'information correcte pour une projection MAP_PRIVATE.

CONFORMITÉ

mincore() n'est pas décrite par POSIX.1-2001, et n'est pas disponible sur toutes les variantes Unix.

HISTORIQUE

La fonction mincore() est apparue dans BSD 4.4.

DISPONIBILITÉ

Depuis Linux 2.3.99pre1 et glibc 2.2.

VOIR AUSSI

getpagesize(2), mlock(2), mmap(2)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».

Création : octobre 2007