POSIX_FALLOCATE

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 3 mars 2008
Index Menu principal

NOM

posix_fallocate - Allouer de l'espace pour un fichier

SYNOPSIS

#define _XOPEN_SOURCE 600
#include <fcntl.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 l'adresse 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 suffisamment 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

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

Dernière mise à jour : 17 juillet 2008