NOM

       fstrim - Abandonner les blocs non utilisés d'un système de fichiers monté

SYNOPSIS

       fstrim [-Aav] [-o offset] [-l length] [-m minimum-size] [mountpoint]

DESCRIPTION

       fstrim 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’est pratique pour les SSD (« solid-state drive ») et
       l’allocation fine et dynamique (« thinly-provisioned storage »).

       Par défaut, fstrim abandonnera tous les blocs non utilisés du système de fichiers. Les options permettent
       de modifier ce comportement en fonction d’intervalle ou de taille, conformément aux explications
       suivantes.

       The mountpoint argument is the pathname of the directory where the filesystem is mounted and is required
       when -A, -a, --fstab, or --all are unspecified.

       Exécuter fstrim fréquemment, ou même utiliser mount -o discard, 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.

OPTIONS

       Les arguments position, taille et taille_mini 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.

       -A, --fstab
           Trim all mounted filesystems mentioned in /etc/fstab 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 --offset, --length and --minimum, 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.

       -a, --all
           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 --offset, --length et --minimum 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.

       -n, --dry-run
           Cette option permet de tout faire, sauf d’appeler réellement l’ioctl FITRIM.

       -o, --offset position
           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.

       -l, --length taille
           Le nombre d’octets (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, fstrim s’arrêtera à la frontière de taille du
           système de fichiers. La valeur par défaut prolonge la recherche jusqu’à la fin du système de
           fichiers.

       -I, --listed-in liste
           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 liste
           s’arrête après le premier fichier non vide. Par exemple,

           --listed-in /etc/fstab:/proc/self/mountinfo.

           Filesystems with "X-fstrim.notrim" mount option in fstab are skipped.

       -m, --minimum taille-mini
           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 fstrim will
           adjust the minimum if it’s smaller than the device’s minimum, and report that (fstrim_range.minlen)
           back to userspace. By increasing this value, the fstrim 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.

       -t, --types liste
           Specifies allowed or forbidden filesystem types when used with --all or --fstab. The list is a
           comma-separated list of the filesystem names. The list follows how mount -t 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.

       -v, --verbose
           Exécution détaillée. Avec cette option, fstrim affichera le nombre d’octets 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’abandon d’un point de vue du périphérique de stockage, parce que l’ioctl FITRIM appelé
           plusieurs fois continuera à répéter l’envoi des mêmes secteurs pour abandon.

           fstrim 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’ajuster les intervalles d’abandon pour
           s’ajuster à 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’option
           --length).

       --quiet-unsupported
           Suppress error messages if trim operation (ioctl) is unsupported. This option is meant to be used in
           systemd service file or in cron(8) scripts to hide warnings that are result of known problems, such
           as NTFS driver reporting Bad file descriptor when device is mounted read-only, or lack of file system
           support for ioctl FITRIM call. This option also cleans exit status when unsupported filesystem
           specified on fstrim command line.

       -h, --help
           Afficher l’aide-mémoire puis quitter.

       -V, --version
           Afficher le numéro de version et quitter.

CODE DE RETOUR

       0
           Succès.

       1
           Échec.

       32
           Tout a échoué.

       64
           Certains abandons sur le système de fichiers ont réussi, d’autres ont échoués.

       La commande fstrim --all renvoie 0 (tous ont réussi), 32 (tous ont échoué) ou 64 (certains ont réussi,
       d’autres ont échoué).

AUTEURS

       Lukas Czerner <lczerner@redhat.com>, Karel Zak <kzak@redhat.com>

VOIR AUSSI

       blkdiscard(8), mount(8)

SIGNALER DES BOGUES

       Pour signaler un bogue, utilisez le gestionnaire de bogues sur
       https://github.com/util-linux/util-linux/issues.

DISPONIBILITÉ

       La commande fstrim fait partie du paquet util-linux, elle est disponible sur l’archive du noyau Linux
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.39.3                                  2025-06-05                                          FSTRIM(8)