'\" t
.\"     Title: fallocate
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Commandes de l'utilisateur
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "FALLOCATE" "1" "2024-04-27" "util\-linux 2.40" "Commandes de l\*(Aqutilisateur"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NOM"
fallocate \- Réserver ou rendre de l\*(Aqespace pour un fichier
.SH "SYNOPSIS"
.sp
\fBfallocate\fP [\fB\-c\fP|\fB\-p\fP|\fB\-z\fP] [\fB\-o\fP \fIoffset\fP] \fB\-l\fP \fIlength\fP [\fB\-n\fP] \fIfilename\fP
.sp
\fBfallocate\fP \fB\-d\fP [\fB\-o\fP \fIoffset\fP] [\fB\-l\fP \fIlength\fP] \fIfilename\fP
.sp
\fBfallocate\fP \fB\-x\fP [\fB\-o\fP \fIoffset\fP] \fB\-l\fP \fIlength filename\fP
.SH "DESCRIPTION"
.sp
\fBfallocate\fP is used to manipulate the allocated disk space for a file, either to deallocate or preallocate it. For filesystems which support the \fBfallocate\fP(2) system call, preallocation is done quickly by allocating blocks and marking them as uninitialized, requiring no IO to the data blocks. This is much faster than creating a file by filling it with zeroes.
.sp
L\(cqétat de sortie renvoyé par \fBfallocate\fP est 0 en cas de réussite et 1 en cas d\(cqéchec.
.SH "OPTIONS"
.sp
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.
.sp
Les options \fB\-\-collapse\-range\fP, \fB\-\-dig\-holes\fP, \fB\-\-punch\-hole\fP et \fB\-\-zero\-range\fP s\(cqexcluent mutuellement.
.sp
\fB\-c\fP, \fB\-\-collapse\-range\fP
.RS 4
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 plus petit de \fItaille\fP octets. 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.
.sp
A filesystem may place limitations on the granularity of the operation, in order to ensure efficient implementation. Typically, \fIoffset\fP and \fIlength\fP must be a multiple of the filesystem logical block size, which varies according to the filesystem type and configuration. If a filesystem has such a requirement, the operation will fail with the error \fBEINVAL\fP if this requirement is violated.
.RE
.sp
\fB\-d\fP, \fB\-\-dig\-holes\fP
.RS 4
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.
.RE
.sp
\fB\-i\fP, \fB\-\-insert\-range\fP
.RS 4
Insérer un trou de taille \fItaille\fP octets à partir de la \fIposition\fP, déplaçant les données existantes.
.RE
.sp
\fB\-l\fP, \fB\-\-length\fP \fItaille\fP
.RS 4
Indiquer la \fItaille\fP de l’intervalle, en octets.
.RE
.sp
\fB\-n\fP, \fB\-\-keep\-size\fP
.RS 4
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 \fItruncate\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIposition\fP
.RS 4
Indiquer la position de début de l’intervalle, en octets.
.RE
.sp
\fB\-p\fP, \fB\-\-punch\-hole\fP
.RS 4
Désallouer l\(cqespace (c\(cqest\-à\-dire créer un trou) dans l\(cqintervalle d\(cqoctets commençant à \fIposition\fP et continuant pendant \fItaille\fP octets. Dans l\(cqespace indiqué, les blocs partiels de systèmes de fichiers sont mis à zéro et les blocs complets du système 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), tmpfs (depuis Linux 3.5) et gfs2 (depuis Linux 4.16).
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Activer le mode verbeux.
.RE
.sp
\fB\-x\fP, \fB\-\-posix\fP
.RS 4
Activer le mode d\(cqopération POSIX. Dans ce mode, l\(cqopération d\(cqallocation se termine toujours mais peut prendre plus de temps si l\(cqallocation rapide n\(cqest pas prise en charge par le système de fichiers sous\-jacent.
.RE
.sp
\fB\-z\fP, \fB\-\-zero\-range\fP
.RS 4
Initialiser l\(cqintervalle d\(cqoctets commençant à \fIposition\fP et continuant pendant \fItaille\fP octets. Dans l\(cqespace 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.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afficher l’aide\-mémoire puis quitter.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afficher le numéro de version et quitter.
.RE
.SH "AUTEURS"
.sp
.MTO "sandeen\(atredhat.com" "Eric Sandeen" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "VOIR AUSSI"
.sp
\fBtruncate\fP(1),
\fBfallocate\fP(2),
\fBposix_fallocate\fP(3)
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le gestionnaire de bogues sur \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "DISPONIBILITÉ"
.sp
La commande \fBfallocate\fP fait partie du paquet util\-linux, elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."