'\" t
.\"     Title: fstrim
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-01-05
.\"    Manual: Administration Système
.\"    Source: util-linux 2.39.3
.\"  Language: English
.\"
.TH "FSTRIM" "8" "2024-01-05" "util\-linux 2.39.3" "Administration Système"
.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"
fstrim \- Abandonner les blocs non utilisés d\*(Aqun système de fichiers monté
.SH "SYNOPSIS"
.sp
\fBfstrim\fP [\fB\-Aav\fP] [\fB\-o\fP \fIoffset\fP] [\fB\-l\fP \fIlength\fP] [\fB\-m\fP \fIminimum\-size\fP] [\fImountpoint\fP]
.SH "DESCRIPTION"
.sp
\fBfstrim\fP est utilisé sur un système de fichiers monté pour abandonner (ou « rogner ») les blocs qui ne sont pas utilisés par le système de fichiers. C\(cqest pratique pour les SSD (« solid\-state drive ») et l\(cqallocation fine et dynamique (« thinly\-provisioned storage »).
.sp
Par défaut, \fBfstrim\fP abandonnera tous les blocs non utilisés du système de fichiers. Les options permettent de modifier ce comportement en fonction d\(cqintervalle ou de taille, conformément aux explications suivantes.
.sp
The \fImountpoint\fP argument is the pathname of the directory where the filesystem is mounted and is required when \fB\fI\-A\fP\fP, \fB\fI\-a\fP\fP, \fB\fI\-\-fstab\fP\fP, or \fB\fI\-\-all\fP\fP are unspecified.
.sp
Exécuter \fBfstrim\fP fréquemment, ou même utiliser \fBmount \-o discard\fP, pourrait affecter négativement la durée de vie des périphériques SSD de mauvaise qualité. Pour la plupart des systèmes de bureau ou de serveur, la fréquence d’abandon suffisante est une fois par semaine. Remarquez que tous les périphériques ne permettent pas de mettre en attente les abandons, donc chaque commande d’abandon pénalise les performances de tout ce qui pourrait être en train d’essayer d’utiliser le disque en même temps.
.SH "OPTIONS"
.sp
Les arguments \fIposition\fP, \fItaille\fP et \fItaille_mini\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
\fB\-A, \-\-fstab\fP
.RS 4
Trim all mounted filesystems mentioned in \fI/etc/fstab\fP on devices that support the discard operation. The root filesystem is determined from kernel command line if missing in the file. The other supplied options, like \fB\-\-offset\fP, \fB\-\-length\fP and \fB\-\-minimum\fP, are applied to all these devices. Errors from filesystems that do not support the discard operation, read\-only devices, autofs and read\-only filesystems are silently ignored. Filesystems with "X\-fstrim.notrim" mount option are skipped.
.RE
.sp
\fB\-a, \-\-all\fP
.RS 4
Rogner tous les systèmes de fichiers montés sur les périphériques qui permettent l’opération d’abandon. Les autres options fournies, comme \fB\-\-offset\fP, \fB\-\-length\fP et \fB\-\-minimum\fP sont appliquées à tous ces périphériques. Les erreurs des systèmes de fichiers qui ne permettent pas l’opération d’abandon, les périphériques en lecture seule et les systèmes de fichiers en lecture seule sont ignorées silencieusement.
.RE
.sp
\fB\-n, \-\-dry\-run\fP
.RS 4
Cette option permet de tout faire, sauf d’appeler réellement l’ioctl \fBFITRIM\fP.
.RE
.sp
\fB\-o, \-\-offset\fP \fIposition\fP
.RS 4
La position en octet dans le système de fichiers à partir de laquelle commencer à chercher les blocs libres à abandonner. La valeur par défaut est zéro, désignant le début du système de fichiers.
.RE
.sp
\fB\-l, \-\-length\fP \fItaille\fP
.RS 4
Le nombre d\(cqoctets (après le point de départ) où chercher des blocs libres à abandonner. Si la valeur indiquée va au\-delà de la fin du système de fichiers, \fBfstrim\fP s\(cqarrêtera à la frontière de taille du système de fichiers. La valeur par défaut prolonge la recherche jusqu\(cqà la fin du système de fichiers.
.RE
.sp
\fB\-I, \-\-listed\-in\fP \fIliste\fP
.RS 4
Indiquer une liste de fichiers séparés par des deux\-points dans le format mountinfo du noyau ou de fstab. Tous les fichiers manquants ou vides sont ignorés silencieusement. L’évaluation de la \fIliste\fP s’arrête après le premier fichier non vide. Par exemple,
.sp
\fB\-\-listed\-in /etc/fstab:/proc/self/mountinfo\fP.
.sp
Filesystems with "X\-fstrim.notrim" mount option in fstab are skipped.
.RE
.sp
\fB\-m, \-\-minimum\fP \fItaille\-mini\fP
.RS 4
Minimum contiguous free range to discard, in bytes. (This value is internally rounded up to a multiple of the filesystem block size.) Free ranges smaller than this will be ignored and \fBfstrim\fP will adjust the minimum if it\(cqs smaller than the device\(cqs minimum, and report that (fstrim_range.minlen) back to userspace. By increasing this value, the \fBfstrim\fP operation will complete more quickly for filesystems with badly fragmented freespace, although not all blocks will be discarded. The default value is zero, discarding every free block.
.RE
.sp
\fB\-t\fP, \fB\-\-types\fP \fIliste\fP
.RS 4
Specifies allowed or forbidden filesystem types when used with \fB\-\-all\fP or \fB\-\-fstab\fP. The \fIlist\fP is a comma\-separated list of the filesystem names. The \fIlist\fP follows how \fBmount \-t\fP evaluates type patterns. Only specified filesystem types are allowed. All specified types are forbidden if the list is prefixed by "no" or each filesystem prefixed by "no" is forbidden. If the option is not used, then all filesystems (except "autofs") are allowed.
.RE
.sp
\fB\-v, \-\-verbose\fP
.RS 4
Exécution détaillée. Avec cette option, \fBfstrim\fP affichera le nombre d\(cqoctets transmis du système de fichiers par la pile de bloc vers le périphérique pour abandon éventuel. Ce nombre est un montant maximal d\(cqabandon d\(cqun point de vue du périphérique de stockage, parce que l\(cqioctl \fIFITRIM\fP appelé plusieurs fois continuera à répéter l\(cqenvoi des mêmes secteurs pour abandon.
.sp
\fBfstrim\fP signalera à chaque fois les mêmes octets à abandonner, mais seuls les secteurs sur lesquels une écriture a eu lieu entre les abandons seront vraiment abandonnés par le périphérique de stockage. De plus, la couche bloc du noyau se réserve le droit d\(cqajuster les intervalles d\(cqabandon pour s\(cqajuster à la géométrie des bandes RAID, aux périphériques ne pouvant pas être rognés dans une configuration LVM, etc. Ces réductions ne seront pas reflétées par fstrim_range.len (l\(cqoption \fB\-\-length\fP).
.RE
.sp
\fB\-\-quiet\-unsupported\fP
.RS 4
Suppress error messages if trim operation (ioctl) is unsupported. This option is meant to be used in \fBsystemd\fP service file or in \fBcron\fP(8) scripts to hide warnings that are result of known problems, such as NTFS driver reporting \fIBad file descriptor\fP when device is mounted read\-only, or lack of file system support for ioctl \fIFITRIM\fP call. This option also cleans exit status when unsupported filesystem specified on \fBfstrim\fP command line.
.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 "CODE DE RETOUR"
.sp
0
.RS 4
Succès.
.RE
.sp
1
.RS 4
Échec.
.RE
.sp
32
.RS 4
Tout a échoué.
.RE
.sp
64
.RS 4
Certains abandons sur le système de fichiers ont réussi, d’autres ont échoués.
.RE
.sp
La commande \fBfstrim \-\-all\fP renvoie 0 (tous ont réussi), 32 (tous ont échoué) ou 64 (certains ont réussi, d’autres ont échoué).
.SH "AUTEURS"
.sp
.MTO "lczerner\(atredhat.com" "Lukas Czerner" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "VOIR AUSSI"
.sp
\fBblkdiscard\fP(8),
\fBmount\fP(8)
.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 \fBfstrim\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" "."