posix_fallocate

Autres langues

Langue: fr

Version: 1er mars 2006 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

NOM

posix_fallocate - Allouer de l'espace pour un fichier

SYNOPSIS

 #define _XOPEN_SOURCE 600
 #include <stdlib.h>
 
 int posix_fallocate(int fd, off_t offset, off_t len);
 

DESCRIPTION

La fonction posix_fallocate() assure l'allocation d'espace disque pour le fichier référencé par le descripteur fd. L'allocation est de len octets à partir de for the bytes in the range starting at offset. Après un appel réussi à posix_fallocate(), les écritures suivantes dans l'intervalle spécifié sont certaines de ne pas échouer à cause d'un manque d'espace disque.

Si la taille du fichier est inférieure offset+len, le fichier est aggrandi à cette taille ; autrement, la taille du fichier n'est pas modifiée.

VALEUR RENVOYÉE

posix_fallocate() renvoie 0 si elle réussit et un numéro d'erreur si elle échoue. Notez que errno n'est pas écrite.

ERREURS

EBADF
fd n'est pas un descripteur de fichier valide, ou n'est pas ouvert en écriture.
EFBIG
offset+len dépasse la taille maimum du fichier.
EINVAL
offset ou len est plus petit que 0.
ENODEV
fd ne fait pas référence à un fichier régulier.
ENOSPC
Il n'y a pas suffisament d'espace disponible sur le périphérique où se trouve le fichier référencé par fd.
ESPIPE
fd fait référence à un tube de descripteur de fichier.

VERSIONS

posix_fallocate() est disponible depuis la glibc 2.1.94.

CONFORMITÉ

POSIX.1-2001.

VOIR AUSSI

lseek(2), posix_fadvise(2), feature_test_macros(7)

TRADUCTION

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 23 juillet 2006 et révisée le 19 novembre 2007.

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 3 posix_fallocate ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.