dir

Affiche la liste des fichiers et sous-répertoires d’un répertoire. Si elle est utilisée sans paramètres, cette commande affiche l’étiquette de volume et le numéro de série du disque, suivis d’une liste de répertoires et de fichiers sur le disque (y compris leurs noms, ainsi que la date et l’heure de la dernière modification). Pour les fichiers, cette commande affiche l’extension de nom et la taille en octets. Cette commande affiche également le nombre total de fichiers et de répertoires listés, leur taille cumulée et l’espace libre (en octets) restant sur le disque.

La commande dir peut également s’exécuter à partir de la Console de récupération Windows, en utilisant différents paramètres. Pour plus d’informations, consultez Environnement de récupération Windows (WinRE).

Syntaxe

dir [<drive>:][<path>][<filename>] [...] [/p] [/q] [/w] [/d] [/a[[:]<attributes>]][/o[[:]<sortorder>]] [/t[[:]<timefield>]] [/s] [/b] [/l] [/n] [/x] [/c] [/4] [/r]

Paramètres

Paramètre Description
[<drive>:][<path>] Spécifie le lecteur et le répertoire dont vous voulez voir la liste.
[<filename>] Spécifie un fichier ou un groupe de fichiers en particulier dont vous voulez voir la liste.
/p Affiche un écran à la fois de la liste. Pour voir l’écran suivant, appuyez sur n’importe quelle touche.
/q Affiche les informations de propriété du fichier.
/w Affiche la liste au format large, avec cinq noms de fichier ou de répertoire sur chaque ligne.
/d Affiche la liste dans le même format que /w, mais les fichiers sont triés par colonne.
/a[[:]<attributes>] Affiche uniquement les noms de ces répertoires et fichiers avec vos attributs spécifiés. Si vous n’utilisez pas ce paramètre, la commande affiche les noms de tous les fichiers à l’exception des fichiers masqués et système. Si vous utilisez ce paramètre sans spécifier d’attributs, la commande affiche les noms de tous les fichiers, y compris les fichiers masqués et système. La liste des valeurs d’attribut possibles est la suivante :
  • d - Répertoires
  • h - Fichiers masqués
  • s - Fichiers système
  • l - Points d’analyse
  • r - Fichiers en lecture seule
  • a - Fichiers prêts pour l’archivage
  • i - Fichiers indexés sans contenu
Vous pouvez utiliser n’importe quelle combinaison de ces valeurs, mais ne séparez pas vos valeurs avec des espaces. Si vous le souhaitez, vous pouvez utiliser le séparateur deux-points (:), ou vous pouvez utiliser un trait d’union (-) comme préfixe pour signifier « not ». Par exemple, l’utilisation de l’attribut -s n’affiche pas les fichiers système.
/o[[:]<sortorder>] Trie la sortie en fonction de sortorder, qui peut être n’importe quelle combinaison des valeurs suivantes :
  • n - Alphabétiquement par nom
  • e - Alphabétiquement par extension
  • g - Répertoires de groupe en premier
  • s - Par taille, en commençant par la plus petite
  • d - Par date/heure, la plus ancienne en premier
  • Utilisez le préfixe - pour inverser l’ordre de tri
Plusieurs valeurs sont traitées dans l’ordre dans lequel vous les listez. Ne séparez pas plusieurs valeurs par des espaces, mais utilisez éventuellement un signe deux-points (:).

Si sortorder n’est pas spécifié, dir /o liste les répertoires par ordre alphabétique, suivis des fichiers, qui sont également triés par ordre alphabétique.

/t[[:]<timefield>] Spécifie le champ d’heure à afficher ou à utiliser pour le tri. Les valeurs de timefield disponibles sont les suivantes :
  • c - Création
  • a - Dernière consultation
  • w - Dernière écriture
/s Liste chaque occurrence du nom de fichier spécifié dans le répertoire spécifié et tous les sous-répertoires.
/b Affiche une liste nue de répertoires et de fichiers, sans informations supplémentaires. Le paramètre /b remplace /w.
/l Affiche les noms de répertoire et les noms de fichier non triés, en minuscules.
/n Affiche un format de liste longue avec les noms de fichier à l’extrême droite de l’écran.
/x Affiche les noms courts générés pour les noms de fichier autres que 8dot3. L’affichage est identique à celui de /n, mais le nom court est inséré avant le nom long.
/C Affiche le séparateur de milliers dans les tailles de fichier. Il s'agit du comportement par défaut. Utilisez /-c pour masquer les séparateurs.
/4 Affiche les années avec quatre chiffres.
/r Affiche les autres flux de données du fichier.
/? Affiche l'aide à l'invite de commandes.

Notes

  • Pour utiliser plusieurs paramètres filename, séparez chaque nom de fichier par un espace, une virgule ou un point-virgule.

  • Vous pouvez utiliser des caractères génériques (* ou ?) pour représenter un ou plusieurs caractères d’un nom de fichier, et pour afficher un sous-ensemble de fichiers ou de sous-répertoires.

  • Vous pouvez utiliser le caractère générique, *, pour remplacer n’importe quelle chaîne de caractères, par exemple :

    • dir *.txt liste tous les fichiers du répertoire actuel avec des extensions qui commencent par .txt, par exemple, .txt, .txt1, .txt_old.

    • dir read *.txt liste tous les fichiers du répertoire actuel qui commencent par read et dont les extensions commencent par .txt, par exemple, .txt, .txt1, .txt_old.

    • dir read *.* liste tous les fichiers du répertoire actuel qui commencent par read avec n’importe quelle extension.

    Le caractère générique astérisque utilise toujours le mappage des noms de fichier courts, ce qui peut générer des résultats inattendus. Par exemple, le répertoire suivant contient deux fichiers (t.txt2 et t97.txt) :

    C:\test>dir /x
    Volume in drive C has no label.
    Volume Serial Number is B86A-EF32
    
    Directory of C:\test
    
    11/30/2004  01:40 PM <DIR>  .
    11/30/2004  01:40 PM <DIR> ..
    11/30/2004  11:05 AM 0 T97B4~1.TXT t.txt2
    11/30/2004  01:16 PM 0 t97.txt
    

    Vous pouvez penser qu’en tapant dir t97\* vous obtenez le fichier t97.txt. Toutefois, dir t97\* renvoie les deux fichiers, car le caractère générique astérisque correspond aux fichiers t.txt2 à t97.txt en raison de l’utilisation de son mappage de nom court T97B4~1.TXT. De même, del t97\* supprime les deux fichiers.

  • Vous pouvez utiliser le point d’interrogation (?) comme remplacement d’un caractère dans un nom. Par exemple, dir read???.txt liste tous les fichiers du répertoire actuel avec l’extension .txt qui commencent par read et sont suivis d’un maximum de trois caractères. Cela comprend Read.txt, Read1.txt, Read12.txt, Read123.txt et Readme1.txt, mais pas Readme12.txt.

  • Si vous utilisez /a avec plusieurs valeurs dans attributes, cette commande affiche uniquement les noms des fichiers qui ont tous les attributs spécifiés. Par exemple, si vous utilisez /a avec r et -h comme attributs (en utilisant /a:r-h ou /ar-h), cette commande affiche uniquement les noms des fichiers en lecture seule qui ne sont pas masqués.

  • Si vous spécifiez plusieurs valeurs de sortorder, cette commande trie les noms de fichiers en fonction du premier critère, puis du deuxième critère, etc. Par exemple, si vous utilisez /o avec les paramètres e et -s pour sortorder (en utilisant /o:e-s ou /oe-s), cette commande trie les noms des répertoires et des fichiers par extension, le plus grand en premier, puis affiche le résultat final. Le tri alphabétique par extension entraîne l’affichage des noms de fichier sans extension, puis des noms de répertoire, puis des noms de fichier avec extension.

  • Si vous utilisez le symbole de redirection (>) pour envoyer la sortie de cette commande à un fichier, ou si vous utilisez une barre verticale (|) pour envoyer la sortie de cette commande à une autre commande, vous devez utiliser /a:-d et /b pour lister uniquement les noms de fichier. Vous pouvez utiliser filename avec /b et /s pour spécifier que cette commande recherche dans le répertoire actuel et dans ses sous-répertoires tous les noms de fichier correspondant à filename. Cette commande liste uniquement la lettre de lecteur, le nom du répertoire, le nom de fichier et l’extension de nom de fichier (un chemin par ligne), pour chaque nom de fichier qu’elle trouve. Avant d’utiliser une barre verticale pour envoyer la sortie de cette commande à une autre commande, vous devez définir la variable d’environnement TEMP dans votre fichier Autoexec.nt.

Exemples

Pour afficher tous les répertoires l’un après l’autre, dans l’ordre alphabétique, au format large et avec une pause après chaque écran, vérifiez que le répertoire racine est le répertoire actuel, puis tapez :

dir /s/w/o/p

La sortie liste le répertoire racine, les sous-répertoires et les fichiers du répertoire racine, y compris les extensions. Cette commande liste également les noms des sous-répertoires et des fichiers de chaque sous-répertoire de l’arborescence.

Pour modifier l’exemple précédent pour que dir affiche les noms de fichier et les extensions, mais omette les noms de répertoire, tapez :

dir /s/w/o/p/a:-d

Pour imprimer une liste de répertoires, tapez :

dir > prn

Quand vous spécifiez prn, la liste de répertoires est envoyée à l’imprimante attachée au port LPT1. Si votre imprimante est attachée à un autre port, vous devez remplacer prn par le nom du port approprié.

Vous pouvez également rediriger la sortie de la commande dir vers un fichier en remplaçant prn par un nom de fichier. Vous pouvez également taper un chemin. Par exemple, pour diriger la sortie de dir vers le fichier dir.doc dans le répertoire Records, tapez :

dir > \records\dir.doc

Si dir.doc n’existe pas, dir le crée, sauf si le répertoire Records n’existe pas. Dans ce cas, le message suivant s’affiche :

File creation error

Pour afficher la liste de tous les noms de fichier avec l’extension .txt dans tous les répertoires du lecteur C, tapez :

dir c:\*.txt /w/o/s/p

La commande dir affiche, au format large, une liste alphabétique des noms de fichier correspondants dans chaque répertoire, et marque une pause chaque fois que l’écran se remplit jusqu’à ce que vous appuyiez sur une touche pour continuer.