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);
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
agrandi à 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 valable ou n’est pas
ouvert en écriture.
EFBIG offset+len dépasse la taille maximale du fichier.
EINVAL offset était plus petit que 0 ou len était plus petit ou égal à
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.
POSIX.1-2008 indique qu’une implémentation doit renvoyer l’erreur
EINVAL si len valait 0 ou si offset était inférieur à 0. POSIX.1-2001
indique qu’une implémentation doit renvoyer l’erreur EINVAL était
inférieur à 0 ou si offset était inférieur à 0 et peut renvoyer cette
erreur si len est égal à 0.
VOIR AUSSI
fallocate(2), lseek(2), posix_fadvise(2), feature_test_macros(7)
COLOPHON
Cette page fait partie de la publication 3.23 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
Cette page de manuel a été traduite par Alain Portal <aportal AT
univ-montp2 DOT fr> en 2006, et mise à disposition sur
http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Nicolas François
<nicolas.francois@centraliens.net> et l’équipe francophone de
traduction de Debian.
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> ».