posix_fallocate − Allouer de l’espace pour un fichier.

#define _XOPEN_SOURCE 600
#include <stdlib.h>

int posix_fallocate(int fd, off_t offset, off_t len);

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.

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

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.

posix_fallocate() est disponible depuis la glibc 2.1.94.

POSIX.1-2001.

lseek(2), posix_fadvise(2)

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 12 août 2006.

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