LS(1L) Manuel de l'utilisateur Linux LS(1L)
NOM
ls, dir, vdir - Afficher le contenu d'un répertoire.
SYNOPSIS
ls [options] [fichier...]
Options POSIX : [-1acdilqrtuCFR]
Options GNU (forme courte) : [-1abcdfgiklmnopqrstuxABCD
FGLNQRSUX] [-w cols] [-T cols] [-I motif] [--full-time]
[--format={long,verbose,commas,across,vertical,single-col
umn}] [--sort={none,time,size,extension}]
[--time={atime,access,use,ctime,status}]
[--color[={none,auto,always}]] [--help] [--version] [--]
DESCRIPTION
La commande ls affiche tout d'abord l'ensemble de ses
arguments fichiers autres que des répertoires. Puis ls
affiche l'ensemble des fichiers contenus dans chaque
répertoire indiqué. dir et vdir sont des versions de ls
affichant par défaut leurs résultats avec d'autres for
mats.
Si aucun argument (autre qu'une option) n'est fourni, le
contenu du répertoire en cours (`.') est affiché. Le con
tenu des répertoires est trié par ordre alphabétique.
Avec l'option -d, les répertoires sont considérés comme
des fichiers ordinaires, on affiche leurs noms mais pas
leurs contenus.
Un fichier dont le nom commence par un point (`.') n'est
affiché que si l'option -a est fournie.
Avec ls, les fichiers sont présentés par défaut en colonne
et triés verticalement si la sortie standard est un termi
nal, sinon ils sont affichés avec un seul fichier par
ligne.
Avec dir, les fichiers sont par défaut listés en colonne
et triés verticalement.
Avec vdir, les fichiers sont par défaut présentés suivant
un format long.
OPTIONS POSIX
-1 Présenter un fichier par ligne.
-a Afficher tous les fichiers des répertoires, y com
pris les fichiers commençant par un `.'.
-c Trier le contenu des répertoires en fonction des
dates de changement des statuts de fichiers, plutôt
qu'en fonction de la date de modification. S'il
FSF 19 Decembre 1996 1
LS(1L) Manuel de l'utilisateur Linux LS(1L)
s'agit d'un format long, afficher la date de
changement de statut plutôt que la date de modifi
cation du fichier.
-d Afficher les répertoires avec la même présentation
que les fichiers, sans lister leur contenu. -i
Afficher le numéro d'index (i-noeud) de chaque
fichier à gauche de son nom.
-l En plus du nom, afficher le type du fichier, les
permissions d'accès, le nombre de liens physiques,
le nom du propriétaire et du groupe, la taille en
octets, et l'horodatage (de la dernière modifica
tion, sauf si une autre date est réclamée par les
options -c ou -u). Pour les fichiers vieux de plus
de 6 mois, ou en avance sur la date de plus d'une
heure, l'horodatage contient l'année à la place de
l'heure. -q Afficher des points d'interrogation à
la place des caractères non-imprimables dans les
noms de fichiers.
-r Inverser le tri du contenu des répertoires.
-t Trier le contenu des répertoires en fonction de la
date et non pas en ordre alphabétique. Les fichiers
les plus récents sont présentés en premier.
-u Trier le contenu des répertoires en fonction de la
date de dernier accès au fichier plutôt que selon
la date de modification. Si le format d'affichage
est large, c'est la date de dernier accès qui est
affichée.
-C Présenter les fichiers en colonnes, triés verti
calement.
-F Ajouter un caractère à chaque nom de fichier pour
indiquer son type. les fichiers réguliers exécuta
bles sont suivis d'un `*'. Les répertoires sont
suivis de `/', les liens symboliques d'un `@', les
FIFOs d'un `|'. Les fichiers réguliers non-
exécutables ne sont suivis d'aucun caractère.
-R Afficher récursivement le contenu des sous-réper
toires.
OPTIONS GNU
-1, --format=single-column
Présenter un fichier par ligne.
-a, --all
Afficher tous les fichiers des répertoires, y com
pris les fichiers commençant par un `.'.
FSF 19 Decembre 1996 2
LS(1L) Manuel de l'utilisateur Linux LS(1L)
-b, --escape
Présenter les caractères non-affichables des noms
de fichiers en utilisant des séquences
alphabétiques ou octales commençant par un back
slash `\' comme en C.
-c, --time=ctime, --time=status
Trier le contenu des répertoires en fonction des
dates de changement des statuts de fichiers, plutôt
qu'en fonction de la date de modification. S'il
s'agit d'un format long, afficher la date de
changement de statut plutôt que la date de modifi
cation du fichier.
-d, --directory
Afficher les répertoires avec la même présentation
que les fichiers, sans lister leur contenu.
-f Ne pas trier le contenu des répertoires, l'afficher
dans l'ordre où il se présente sur le disque.
L'effet est équivalent aux options -a et -U sans
les options -l, -s, ni -t.
--full-time
Afficher les dates et heures complètes, sans les
abréger.
-g Option sans effet, conservée pour assurer la com
patibilité avec Unix.
-i, --inode
Afficher le numéro d'index (i-noeud) de chaque
fichier à gauche de son nom.
-k, --kilobytes
Si la taille des fichiers est affichée, la mesurer
en kilo-octets. Ceci a priorité sur la variable
d'environnement POSIXLY_CORRECT.
-l, --format=long, --format=verbose
En plus du nom, afficher le type du fichier, les
permissions d'accès, le nombre de liens physiques,
le nom du propriétaire et du groupe, la taille en
octets, et l'horodatage (de la dernière modifica
tion, sauf si une autre date est réclamée). Pour
les fichiers vieux de plus de 6 mois, ou en avance
sur la date de plus d'une heure, l'horodatage con
tient l'année à la place de l'heure.
Pour chaque répertoire indiqué, les fichiers sont
précédés d'une ligne `total nb_blocs', ou nb_blocs
est l'espace disque utilisé par l'ensemble des
fichiers du répertoire. Par défaut on utilise des
blocs de 1024 octets. Si la variable
FSF 19 Decembre 1996 3
LS(1L) Manuel de l'utilisateur Linux LS(1L)
d'environnement POSIXLY_CORRECT est configurée, on
utilise des blocs de 512 octets (sauf si l'option
-k est fournie). Le calcul de nb_blocs se fait en
comptant séparement chaque lien physique. On peut
trouver cela dommage.
Les autorisations d'accès listées sont similaires
aux spécifications de modes, mais ls regroupe
plusieurs bits dans le troisième caractère de
chaque jeu de permissions.
s si le bit setuid ou setgid et le bit
d'exécution correspondant sont tous deux
valides.
S si le bit setuid ou setgid est actif mais le
bit d'exécution correspondant n'est pas con
figuré.
t Si les bits `Sticky' et `Exécution pas les
autres' sont actifs.
T Si le bit `Sticky' est actif mais pas le bit
`Exécution par les autres'.
x Si le bit d'éxécution est actif mais aucun
de ceux cités ci-dessus.
- Sinon.
-m, --format=commas
Afficher sur chaque ligne autant de fichiers que
possible, séparés par des virgules.
-n, --numeric-uid-gid
Afficher les UID et GID numériques plutôt que les
noms.
-o Produire un listing de répertoire sous forme longue
mais sans les informations de groupe. C'est équiva
lent à --format=long --no-group. Cette option sert
à assurer la compatibilité avec d'autres versions
de ls.
-p Ajouter un caractère à chaque nom de fichier pour
indiquer son type.
-q, --hide-control-chars
Afficher des points d'interrogation à la place des
caractères non-imprimables dans les noms de
fichiers.
-r, --reverse
Inverser le tri du contenu des répertoires.
FSF 19 Decembre 1996 4
LS(1L) Manuel de l'utilisateur Linux LS(1L)
-s, --size
Afficher la taille de chaque fichier, mesurée en
bloc de 1 Ko, à gauche du nom. Si la variable
d'environnement POSIXLY_CORRECT est configurée, la
taille est mesurée en blocs de 512 octets.
-t, --sort=time
Trier le contenu des répertoires en fonction de la
date et non pas en ordre alphabétique. Les fichiers
les plus récents sont présentés en premier.
-u, --time=atime, --time=access, --time=use
Trier le contenu des répertoires en fonction de la
date de dernier accès au fichier plutôt que selon
la date de modification. Si le format d'affichage
est large, c'est la date de dernier accès qui est
affichée.
-w, --width cols
Supposer que l'écran dispose de cols colonnes en
largeur. La valeur par défaut est réclamée si pos
sible au gestionnaire de terminal. Sinon la vari
able d'environnement COLUMNS est utilisée si elle
est positionnée. Sinon, la valeur par défaut est
80.
-x, --format=across, --format=horizontal
Présenter les fichiers en colonnes, triés horizon
talement.
-A, --almost-all
Afficher tous les fichiers du répertoire sauf `.'
et `..'.
-B, --ignore-backups
Ne pas afficher les fichiers se terminant par `~',
à moins qu'ils ne soient mentionnés sur la ligne de
commande.
-C, --format=vertical
Présenter les fichiers en colonnes, triés verti
calement.
-D, --dired
Avec le format long -l, imprimer une ligne
supplémentaire après les données principales:
//DIRED// DEBUT_1 FIN_1 DEBUT_2 FIN_2 ...
Les valeurs DEBUT_n et FIN_n sont des entiers non-
signés qui enregistrent la position en octets de
chaque noms de fichier dans la sortie. Ceci permet
à Emacs de trouver facilement les noms de fichiers,
même ceux qui contiennent des caractères inhab
ituels comme espace ou retour-chariot. Si les
répertoires sont listés de manière récursive -R,
FSF 19 Decembre 1996 5
LS(1L) Manuel de l'utilisateur Linux LS(1L)
une ligne similaire est affichée après chaque sous-
répertoires :
//SUBDIRED// DEBUT_1 FIN_1 ...
-F, --classify
Ajouter un caractère à chaque nom de fichier pour
indiquer son type. les fichiers réguliers exécuta
bles sont suivis d'un `*'. Les répertoires sont
suivis de `/', les liens symboliques d'un `@', les
FIFOs d'un `|'. Les fichiers réguliers non-
exécutables ne sont suivis d'aucun caractère.
-G, --no-group
Ne pas afficher les informations de groupe dans le
format large.
-I, --ignore motif
Ne pas afficher les fichiers dont le nom correspond
au motif (suivant l'interprétation du shell), à
moins qu'ils ne soient explicitement mentionnés sur
la ligne de commande. Comme avec le shell, les
noms de fichiers commençant par un point `.' ne
sont pas supposés correspondre avec un motif com
mençant par un caractère générique.
-L, --dereference
Afficher les informations concernant les fichiers
pointés par les liens symboliques et non pas celles
concernant les liens eux-mêmes.
-N, --literal
Afficher les noms de fichiers sans modification.
-Q, --quote-name
Encadrer les noms de fichiers avec des guillemets,
et citer les caractères non-imprimables par des
séquences semblables à celles utilisées en C.
-R, --recursive
Afficher récursivement le contenu des sous-réper
toires.
-S, --sort=size
Trier les répertoires en fonction de la taille de
fichier et non pas en ordre alphabétique. Les
fichiers les plus gros sont affichés en premier.
-T, --tabsize cols
Supposer que les tabulations sont espacées de cols
colonnes. La valeur par défaut est 8.
-U, --sort=none
Ne pas trier le contenu des répertoires. Les
présenter dans l'ordre des fichiers sur le disque.
FSF 19 Decembre 1996 6
LS(1L) Manuel de l'utilisateur Linux LS(1L)
Cette option n'est pas groupée avec -f car le ls
d'Unix possède une option -f incluant également -a
et supprimant -l, -s, et -t. Il semble inutile et
horrible de regrouper toutes ces fonctionnalités
sans lien entre elles en une seule option.
-X, --sort=extension
Trier le contenu des répertoires en fonction de
l'extension du nom de fichier (les caractères après
le dernier `.'). Les fichiers sans extension sont
affichés en premier.
--color[=manière]
Spécifie comment utiliser les couleurs pour dis
tinguer les types de fichiers. Les couleurs sont
définie en utilisant la variable d'environnement
LS_COLORS. Pour avoir des précisions sur la con
figuration de cette variable, voir dircolors(1).
La manière, si elle est indiquée, peut prendre
l'une des valeurs suivantes :
none Ne pas utiliser de couleurs. C'est le com
portement par défaut.
auto N'utiliser de couleurs que si la sortie
standard est un terminal.
always Toujours utiliser des couleurs. Indiquer
seulement --color sans indiquer de manière
est équivalent à --color=always.
--full-time
Afficher les temps de manière complète, sans
utiliser les heuristiques habituelles d'abrévia
tion. Le format est celui par défaut de date(1).
On ne peut pas le modifier, mais on peut au besoin
l'extraire avec cut(1) et de passer le résultat à
`date -d'.
Ceci est surtout utile car l'affichage contient les
secondes (les systèmes de fichiers Unix utilisent
un horodatage à la seconde la plus proche, aussi
vous disposez ici de toutes les informations exis
tantes). Par exemple cela peut servir à corriger un
Makefile qui ne régénère pas correctement les
fichiers.
OPTIONS STANDARDS GNU
--help Afficher un message d'aide sur la sortie standard,
et terminer normalement.
--version
Afficher un numéro de version sur la sortie
FSF 19 Decembre 1996 7
LS(1L) Manuel de l'utilisateur Linux LS(1L)
standard, et terminer normalement.
-- Terminer la liste des options.
ENVIRONNEMENT
La variable d'environnement POSIXLY_CORRECT détermine le
choix des unités. Si elle n'est pas configurée, alors la
variable TABSIZE détermine le nombre de caractères par
saut de tabulation. La variable COLUMNS (lorsqu'elle con
tient un entier décimal) déterminer le nombre de colonnes
pour la largeur de sortie (option -C). Les variables
LANG, LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES et LC_TIME
ont leurs significations habituelles. La variable TZ
indique le fuseau horaire pour les chaînes de caractères
représentant des horodatages. La variable LS_COLORS est
utilisée pour préciser les couleurs utilisées.
BUGS
Sur les systèmes BSD, l'option -s affiche des tailles cor
respondant à la moitié de la taille réelle pour les
fichiers situés sur un système HP-UX monté par NFS. Sur
les systèmes HP-UX, les tailles sont doublées pour les
fichiers monté par NFS depuis un système BSD. Ceci est dû
à un défaut d'HP-UX, qui affecte également la version HP-
UX de la commande ls.
CONFORMITÉ
POSIX 1003.2
VOIR AUSSI
dircolors(1)
NOTES
Cette page documente la version de ls du paquetage fileu
tils-3.16. D'autres versions peuvent diverger légèrement.
TRADUCTION
Christophe Blaess, 1997.
FSF 19 Decembre 1996 8