.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH FALLOCATE 1 "septembre 2011" util\-linux "Commandes utilisateur"
.SH NOM
fallocate \- Réserver ou rendre de l'espace pour un fichier
.SH SYNOPSIS
\fBfallocate\fP [\fB\-c\fP] [\fB\-n\fP] [\fB\-p\fP] [\fB\-z\fP] [\fB\-o\fP \fIposition\fP] \fB\-l\fP
\fItaille\fP \fIfichier\fP
.PP
\fBfallocate \-d\fP [\fB\-o\fP \fIposition\fP] [\fB\-l\fP \fItaille\fP] \fIfichier\fP
.SH DESCRIPTION
\fBfallocate\fP sert à manipuler l’espace disque alloué à un fichier, soit pour
le réserver, soit pour le rendre. Pour les systèmes de fichiers qui
permettent l'appel système \fBfallocate\fP(2), la réservation est réalisée
rapidement en allouant des blocs et en les marquant comme non initialisés,
sans nécessiter d'échange (entrée ou sortie) avec les blocs de
données. C'est bien plus rapide que de créer un fichier en le remplissant de
zéros.
.PP
Le code de retour renvoyé par \fBfallocate\fP est \fB0\fP en cas de réussite et
\fB1\fP en cas d'échec.
.SH OPTIONS
Les arguments \fItaille\fP et \fIposition\fP peuvent être suivis des suffixes
multiplicatifs KiB=1024, MiB=1024*1024,\ etc., pour GiB, TiB, PiB, EiB, ZiB
et YiB (la partie «\ iB\ » est facultative, par exemple «\ K\ » est identique à
«\ KiB\ ») ou des suffixes KB=1000, MB=1000*1000,\ etc., pour GB, TB, PB, EB,
ZB et YB.
.PP
Les options \fB\-\-collapse\-range\fP, \fB\-\-dig\-holes\fP, \fB\-\-punch\-hole\fP et
\fB\-\-zero\-range\fP s'excluent mutuellement.
.TP 
\fB\-c\fP, \fB\-\-collapse\-range\fP
Supprimer un intervalle d’octets d’un fichier, sans laisser de
trou. L’intervalle d’octets à supprimer commence à \fIposition\fP et continue
pendant \fItaille\fP\ octets. À la fin de l’opération, le contenu du fichier
commençant à \fIposition\fP+\fItaille\fP sera ajouté à la \fIposition\fP et le
fichier sera \fItaille\fP plus petit. L’option \fB\-\-keep\-size\fP ne peut pas être
utilisée pour une opération de suppression d’intervalle.
.sp
Disponible depuis Linux\ 3.15 pour ext4 (seulement pour les fichiers avec
extension de domaine ou «\ extent\ ») et XFS.
.TP 
\fB\-d\fP, \fB\-\-dig\-holes\fP
Détecter et creuser des trous. Cela rassemble les fichiers creux, sans
utiliser d’espace disque supplémentaire. La taille minimale du trou dépend
de la taille de bloc d’entrée et sortie du système de fichiers (4096\ octets
en général). De plus, en utilisant cette option, \fB\-\-keep\-size\fP est
implicite. Si aucun intervalle n’est indiqué par \fB\-\-offset\fP et \fB\-\-length\fP,
le fichier entier est analysé pour les trous.
.sp
Cette option peut être vue comme faire un «\ \fBcp \-\-sparse\fP\ » puis renommer
le fichier de destination comme le fichier original, sans avoir besoin
d’espace disque supplémentaire.
.sp
Consultez \fB\-\-punch\-hole\fP pour une liste des systèmes de fichiers pris en
charge.
.TP 
\fB\-l\fP, \fB\-\-length\fP \fItaille\fP
Indiquer la \fItaille\fP de l’intervalle, en octet.
.TP 
\fB\-n\fP, \fB\-\-keep\-size\fP
Ne pas modifier la \fItaille\fP apparente du \fIfichier\fP. Des blocs pourraient
être alloués après la fin du \fIfichier\fP, ils peuvent être enlevés avec
\fBtruncate\fP.
.TP 
\fB\-o\fP, \fB\-\-offset\fP \fIposition\fP
Indiquer la position de début de l’intervalle, en octet.
.TP 
\fB\-p\fP, \fB\-\-punch\-hole\fP
Désallouer l'espace (c'est\-à\-dire créer un trou) dans l'intervalle d'octets
commençant à \fIposition\fP et continuant pendant \fItaille\fP\ octets. Dans
l'espace indiqué, les blocs partiels de systèmes de fichiers sont mis à zéro
et les blocs complets de systèmes de fichiers sont retirés du fichier. Après
un appel réussi, les lectures suivantes dans cet intervalle renverront des
zéros. Cette option peut ne pas être indiquée en même temps que l’option
\fB\-\-zero\-range\fP. De plus, lors de l’utilisation de cette option,
\fB\-\-keep\-size\fP est implicite.
.sp
Pris en charge pour XFS (depuis Linux\ 2.6.38), ext4 (depuis Linux\ 3.0),
Btrfs (depuis Linux\ 3.7) et tmpfs (depuis Linux\ 3.5).
.TP 
\fB\-v\fP, \fB\-\-verbose\fP
Activer le mode verbeux.
.TP 
\fB\-z\fP, \fB\-\-zero\-range\fP
Initialiser l'intervalle d'octets commençant à \fIposition\fP et continuant
pendant \fItaille\fP\ octets. Dans l'espace indiqué, les blocs sont préalloués
pour les zones qui couvrent les trous du fichier. Après un appel réussi, les
lectures suivantes dans cet intervalle renverront des zéros.
.sp
L’initialisation est réalisée dans le système de fichiers de préférence en
convertissant l’intervalle en «\ extents\ » non écrits. Cette approche
signifie que l’intervalle indiqué ne sera pas physiquement initialisé sur le
périphérique (à part les blocs partiels aux extrémités de l’intervalle) et
qu’une entrée ou sortie n’est (sinon) nécessaire que pour mettre à jour les
métadonnées.
.sp
L’option \fB\-\-keep\-size\fP peut être indiquée pour empêcher la modification de
taille du fichier.
.sp
Disponible depuis Linux\ 3.14 pour ext4 (seulement pour les fichiers avec
extension de domaine ou «\ extent\ ») et XFS.
.TP 
\fB\-V\fP,\fB \-\-version\fP
Afficher les informations sur la version et quitter.
.TP 
\fB\-h\fP,\fB \-\-help\fP
Afficher un texte d'aide puis quitter.
.SH AUTEURS
.UR sandeen@redhat.com
Eric Sandeen
.UE
.br
.UR kzak@redhat.com
Karel Zak
.UE
.SH "VOIR AUSSI"
\fBfallocate\fP(2), \fBposix_fallocate\fP(3), \fBtruncate\fP(1)
.SH DISPONIBILITÉ
La commande \fBfallocate\fP fait partie du paquet util\-linux, elle est
disponible sur
.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util\-linux/
l’archive du
noyau Linux
.UE .