ls - afficher le contenu d'un répertoire
SYNTAXE
ls [OPTION]... [FICHIER]...
DESCRIPTION
Afficher des informations sur les FICHIERS (le répertoire courant par défaut). Trier les entrées par ordre alphabétique si aucune des options -cftuvSUX ou --sort n'est spécifiée.
Les arguments obligatoires pour les options longues sont obligatoires pour les options courtes.
OPTIONS
-a, --all
ne pas ignorer les entrées commençant par .
-A, --almost-all
ne pas afficher les entrées implicites . et ..
--author
avec -l, afficher l'auteur de chaque fichier
-b, --escape
afficher les séquences d'échappement de type C pour les caractères non graphiques
--block-size=TAILLE
avec -l, mettre à l'échelle les tailles en fonction de la valeur TAILLE lors de leur affichage ; par exemple, '--block-size=M' ; voir le format TAILLE ci-dessous
-B, --ignore-backups
ne pas afficher les entrées implicites se terminant par ~
-c avec -lt : trier par et afficher le temps de modification (ctime) du fichier ; avec -l : afficher le ctime et trier par nom ; sinon : trier par ctime, du plus récent au plus ancien
-C afficher les entrées par colonnes
--color[=QUAND]
colorer la sortie QUAND ; plus d'informations ci-dessous
-d, --directory
afficher les répertoires eux-mêmes, et non leur contenu
-D, --dired
générer une sortie conçue pour le mode dired d'Emacs
-f équivalent à -a -U
-F, --classify[=QUAND]
ajouter un indicateur (un des caractères */=>@|) aux entrées QUAND
--file-type
de même, sauf qu'il ne faut pas ajouter l'astérisque (*)
--format=MOT
across, horizontal (-x), commas (-m), long (-l), single-column (-1), verbose (-l), vertical (-C)
--full-time
comme -l --time-style=full-iso
-g comme -l, mais ne pas afficher le propriétaire
--group-directories-first
regrouper les répertoires avant les fichiers
-G, --no-group
dans une liste longue, ne pas afficher les noms de groupe
-h, --human-readable
avec -l et -s, afficher les tailles comme 1K 234M 2G, etc.
--si de même, mais utiliser les puissances de 1000 au lieu de 1024
-H, --dereference-command-line
suivre les liens symboliques listés dans la ligne de commande
--dereference-command-line-symlink-to-dir
suivre chaque lien symbolique de la ligne de commande qui pointe vers un répertoire
--hide=MOTIF
ne pas afficher les entrées implicites correspondant au motif de shell MOTIF (remplacé par -a ou -A)
--hyperlink[=QUAND]
créer des liens hypertextes pour les noms de fichiers QUAND
--indicator-style=MOT
ajouter un indicateur avec le style MOT aux noms des entrées : aucun (par défaut), barre oblique (-p), type de fichier (--file-type), classification (-F)
-i, --inode
afficher le numéro d'index de chaque fichier
-I, --ignore=MOTIF
ne pas afficher les entrées implicites correspondant au motif de shell MOTIF
-k, --kibibytes
par défaut, utiliser des blocs de 1 024 octets pour l'utilisation du système de fichiers ; utilisé uniquement avec -s et pour les totaux par répertoire
-l utiliser un format de liste long
-L, --dereference
lors de l'affichage des informations sur un fichier pour un lien symbolique, afficher les informations sur le fichier auquel le lien fait référence plutôt que sur le lien lui-même
-m remplit la largeur avec une liste d'éléments séparés par des virgules
-n, --numeric-uid-gid
comme -l, mais affiche les ID utilisateur et de groupe sous forme numérique
-N, --literal
affiche les noms des entrées sans guillemets
-o comme -l, mais n'affiche pas les informations du groupe
-p, --indicator-style=slash
ajoute un indicateur / aux répertoires
-q, --hide-control-chars
affiche ? au lieu des caractères non graphiques
--show-control-chars
affiche les caractères non graphiques tels quels (par défaut, sauf si le programme est « ls » et que la sortie se fait vers un terminal)
-Q, --quote-name
encadre les noms des entrées avec des guillemets doubles
--quoting-style=WORD
utilise le style de guillemet WORD pour les noms d'entrée : literal, locale, shell, shell-always, shell-escape, shell-escape-always, c, escape (remplace la variable d'environnement QUOTING_STYLE)
-r, --reverse
inverse l'ordre lors du tri
-R, --recursive
liste les sous-répertoires de manière récursive
-s, --size
affiche la taille allouée de chaque fichier, en blocs
-S trie par taille de fichier, du plus grand au plus petit
--sort=WORD
modifie le tri par défaut de « name » en WORD : none (-U), size (-S), time (-t), version (-v), extension (-X), name, width
--time=WORD
sélectionne l'horodatage utilisé pour l'affichage ou le tri ; heure d'accès (-u) : atime, access, use ;
heure de modification des métadonnées (-c) : ctime, status ; heure de modification (par défaut) : mtime, modification ;
heure de création : birth, creation ;
avec -l, WORD détermine quelle heure afficher ; avec --sort=time, trie par WORD (du plus récent au plus ancien)
--time-style=TIME_STYLE
format de date/heure avec -l ; voir TIME_STYLE ci-dessous
-t trie par heure, du plus récent au plus ancien ; voir --time
-T, --tabsize=COLS
suppose que les tabulations sont espacées de COLS au lieu de 8
-u avec -lt : trie et affiche l'heure d'accès ; avec -l : affiche l'heure d'accès et trie par nom ; sinon : trie par heure d'accès, du plus récent au plus ancien
-U n'effectue pas de tri des entrées de répertoire
-v tri naturel des nombres (version) dans le texte
-w, --width=COLS
définit la largeur de la sortie à COLS. 0 signifie pas de limite
-x liste les entrées par lignes au lieu de par colonnes
-X trie par ordre alphabétique en fonction de l'extension de l'entrée
-Z, --context
affiche tout contexte de sécurité de chaque fichier
--zero termine chaque ligne de sortie avec NUL au lieu d'une nouvelle ligne
-1 affiche un fichier par ligne
--help affiche cette aide et quitte
--version
affiche les informations de version et quitte
ARGUMENTS
L'argument SIZE est un entier et une unité optionnelle (par exemple : 10K correspond à 10 * 1024). Les unités sont K, M, G, T, P, E, Z, Y, R, Q (puissances de 1024) ou KB, MB, ... (puissances de 1000). Les préfixes binaires peuvent également être utilisés : KiB = K, MiB = M, et ainsi de suite.
L'argument TIME_STYLE peut être full-iso, long-iso, iso, locale ou +FORMAT. FORMAT est interprété comme dans date(1). Si FORMAT est FORMAT1<newline>FORMAT2, alors FORMAT1 s'applique aux fichiers non récents et FORMAT2 aux fichiers récents. TIME_STYLE précédé de « posix- » n'est pris en compte que lorsque l'environnement n'est pas POSIX. De plus, la variable d'environnement TIME_STYLE définit le style par défaut à utiliser.
L'argument WHEN a par défaut la valeur « always » et peut également être « auto » ou « never ».
L'utilisation de la couleur pour distinguer les types de fichiers est désactivée par défaut et avec --color=never. Avec --color=auto, ls émet des codes de couleur uniquement lorsque la sortie standard est connectée à un terminal. La variable d'environnement LS_COLORS peut modifier les paramètres. Utilisez la commande dircolors(1) pour la définir.
Statut de sortie : 0 si tout va bien,
1 en cas de problèmes mineurs (par exemple, impossibilité d’accéder à un sous-répertoire),
2 en cas de problèmes graves (par exemple, impossibilité d’accéder à un argument de ligne de commande).
AUTEUR
Écrit par Richard M. Stallman et David MacKenzie.
SIGNALEMENT DES BUGS
Aide en ligne de GNU coreutils : [https://www.gnu.org/software/coreutils/] Signalez les bogues de traduction à [https://translationproject.org/team/]
VOIR AUSSI
dircolors(1)
Documentation complète [https://www.gnu.org/software/coreutils/ls] ou disponible localement via : info « (coreutils) ls invocation »
Emballé par Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Licence GPLv3 : GNU GPL version 3 ou ultérieure [https://gnu.org/licenses/gpl.html]. Ceci est un logiciel libre : vous êtes libre de le modifier et de le redistribuer. Il n’y a AUCUNE GARANTIE, dans la mesure permise par la loi.