table of contents
POSIX_FADVISE(2) | Manuel du programmeur Linux | POSIX_FADVISE(2) |
NOM¶
posix_fadvise - Prédéclarer des accès aux données d'un fichierSYNOPSIS¶
#include <fcntl.h>int posix_fadvise(int fd, off_t offset, off_t len, int advice);
Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :
_XOPEN_SOURCE >= 600 ||
_POSIX_C_SOURCE >= 200112L
DESCRIPTION¶
Les programmes peuvent utiliser posix_fadvise() pour annoncer leur intention d'accéder aux données d'un fichier suivant un certain ordre, permettant ainsi au noyau de réaliser les optimisations appropriées.- 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 des 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.
VALEUR RENVOYÉE¶
L'appel renvoie zéro s'il réussit. S'il échoue, il renvoie un code d'erreur.ERREURS¶
- EBADF
- L'argument fd n'est pas un descripteur de fichier valable.
- EINVAL
- L'indication advice est invalide.
- ESPIPE
- Le descripteur correspond à un tube ou une FIFO (Linux renvoie en fait EINVAL dans ce cas).
VERSIONS¶
La prise en charge par le noyau est d'abord apparue dans Linux 2.5.60 ; l'appel système sous-jacent est appelé fadvise64(). La prise en charge dans l'espace utilisateur est disponible depuis la glibc 2.2, à travers la fonction posix_fadvise().CONFORMITɶ
POSIX.1-2001. Veuillez noter que le type du paramètre len a été modifié de size_t en off_t dans la spécification POSIX.1-2003 TC1.NOTES¶
Sous Linux, POSIX_FADV_NORMAL configure la fenêtre de lecture anticipée à sa taille par défaut pour le périphérique concerné. POSIX_FADV_SEQUENTIAL double cette taille, et POSIX_FADV_RANDOM désactive la lecture anticipée. Ces modifications affectent le fichier entier, pas seulement la région indiquée (mais les autres descripteurs ouverts sur le même fichier ne sont pas modifiés).arm_fadvise()¶
L'architecture ARM nécessite que les paramètres 64 bits soient alignés dans une paire de registres adéquate. Sur cette architecture, la signature d'appel de posix_fadvise() est défectueuse, puisqu'elle impose le gaspillage d'un registre comme remplissage entre les paramètres fd et len. Pour cette raison, depuis Linux 2.6.14, ARM définit un appel système différent qui réordonne correctement les paramètres :long arm_fadvise64_64(int fd, int advice, loff_t offset, loff_t len);
À part cela, le comportement de cet appel système est strictement identique à celui de posix_fadvise(). Aucun support utilisateur n'est disponible dans la glibc pour cet appel système.
BOGUES¶
Dans les noyaux antérieurs à 2.6.6, si le paramètre len était nul, la valeur était interprétée comme « zéro octets », et non comme « tous les octets jusqu'à la fin du fichier ».VOIR AUSSI¶
readahead(2), sync_file_range(2), posix_fallocate(3), posix_madvise(3)COLOPHON¶
Cette page fait partie de la publication 3.44 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <http://www.kernel.org/doc/man-pages/>.TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>. Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009). Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou 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> ».9 octobre 2010 | Linux |