#define _XOPEN_SOURCE 600
#include <fcntl.h>

int posix_fadvise(int fd, off_t offset, off_t len, int advice);

L'indication advice s'applique à une région (pas nécessairement existante) débutant à offset et s'étendant sur len octets (ou jusqu'à la fin du fichier si len vaut zéro) dans le fichier référencé par fd . L'indication n'oblige à rien, il s'agit seulement d'une supposition concernant le comportement futur de l'application.

Les valeurs possibles pour advice incluent :

POSIX_FADV_NORMAL

Indique que l'application n'a pas d'indice particulier concernant les accès aux données du fichier. Le noyau appliquera son comportement par défaut.

POSIX_FADV_SEQUENTIAL

L'application pense accéder aux données séquentiellement (dans l'ordre de offsets croissants).

POSIX_FADV_RANDOM

Les accès se feront de manière aléatoire.

POSIX_FADV_NOREUSE

Les données ne seront accédées qu'une seule fois.

POSIX_FADV_WILLNEED

Les données seront accédées dans le futur proche.

POSIX_FADV_DONTNEED

Les données ne seront pas accédées dans le futur proche.

EBADF

L'argument fd n'est pas un descripteur de fichier valide.

EINVAL

L'indication advice est invalide.

ESPIPE

Le descripteur correspond à un tube ou une FIFO. (Linux renvoie en fait EINVAL dans ce cas).

POSIX_FADV_WILLNEED initialise une lecture non bloquante de la région indiquée dans le cache. La quantité de données lues peut être diminuée suivant la charge de la mémoire virtuelle (quelques méga-octets seront en général disponibles et souvent suffisants).

Bans les noyaux précédents le 2.6.18, POSIX_FADV_NOREUSE avait la même sémantique que POSIX_FADV_WILLNEED. C'était probablement un bogue ; depuis le noyau 2.6.18, cet attribut est une instruction ineffective.

POSIX_FADV_DONTNEED essaye de libérer les pages de cache associées avec la région indiquée. Ceci est utile par exemple lors du parcours de très gros fichiers. Un programme peut ainsi demander régulièrement au noyau de libérer les pages déjà utilisées, pour éviter que des pages plus utiles ne soient éliminées à leur place.

Les pages qui n'ont pas encore été écrites ne sont pas affectées, ainsi si une application veut s'assurer que les pages seront relâchées, elle devrait appeler fsync(2) ou fdatasync(2) d'abord.  

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 18 juillet 2003 et révisée le 6 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 posix_fadvise ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

VALEUR RENVOYÉE

ERREURS

VERSIONS

CONFORMITÉ

NOTES

BOGUES

VOIR AUSSI

TRADUCTION