Displays a list of a directory's files and subdirectories. If used without parameters, this command displays the disk's volume label and serial number, followed by a list of directories and files on the disk (including their names and the date and time each was last modified). For files, this command displays the name extension and the size in bytes. This command also displays the total number of files and directories listed, their cumulative size, and the free space (in bytes) remaining on the disk.

Thedir command can also run from the Windows Recovery Console, using different parameters. For more information, seeWindows Recovery Environment (WinRE).

Syntax

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

Parameters

Remarks

• To use multiplefilename parameters, separate each file name with a space, comma, or semicolon.

• You can use wildcard characters (* or?), to represent one or more characters of a file name and to display a subset of files or subdirectories.

• You can use the wildcard character,*, to substitute for any string of characters, for example:

  • dir *.txt lists all files in the current directory with extensions that begin with .txt, such as .txt, .txt1, .txt_old.

  • dir read *.txt lists all files in the current directory that begin with read and with extensions that begin with .txt, such as .txt, .txt1, or .txt_old.

  • dir read *.* lists all files in the current directory that begin with read with any extension.

  The asterisk wildcard always uses short file name mapping, so you might get unexpected results. For example, the following directory contains two files (t.txt2 and t97.txt):

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

  You might expect that typingdir t97\* would return the file t97.txt. However, typingdir t97\* returns both files, because the asterisk wildcard matches the file t.txt2 to t97.txt by using its short name mapT97B4~1.TXT. Similarly, typingdel t97\* would delete both files.

• You can use the question mark (?) as a substitute for a single character in a name. For example, typingdir read???.txt lists any files in the current directory with the .txt extension that begin with read and are followed by up to three characters. This includes Read.txt, Read1.txt, Read12.txt, Read123.txt, and Readme1.txt, but not Readme12.txt.

• If you use/a with more than one value inattributes, this command displays the names of only those files with all the specified attributes. For example, if you use/a withr and-h as attributes (by using either/a:r-h or/ar-h), this command will only display the names of the read-only files that aren't hidden.

• If you specify more than onesortorder value, this command sorts the file names by the first criterion, then by the second criterion, and so on. For example, if you use/o with thee and-s parameters forsortorder (by using either/o:e-s or/oe-s), this command sorts the names of directories and files by extension, with the largest first, and then displays the final result. The alphabetic sorting by extension causes file names with no extensions to appear first, then directory names, and then file names with extensions.

• If you use the redirection symbol (>) to send this command's output to a file, or if you use a pipe (|) to send this command's output to another command, you must use/a:-d and/b to only list the file names. You can usefilename with/b and/s to specify that this command is to search the current directory and its subdirectories for all file names that matchfilename. This command lists only the drive letter, directory name, file name, and file name extension (one path per line), for each file name it finds. Before you use a pipe to send this command's output to another command, you should set theTEMP environment variable in your Autoexec.nt file.

Examples

To display all directories one after the other, in alphabetical order, in wide format, and pausing after each screen, make sure that the root directory is the current directory, and then type:

dir /s/w/o/p

The output lists the root directory, the subdirectories, and the files in the root directory, including extensions. This command also lists the subdirectory names and the file names in each subdirectory in the tree.

To alter the preceding example so thatdir displays the file names and extensions, but omits the directory names, type:

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

To print a directory listing, type:

dir > prn

When you specifyprn, the directory list is sent to the printer that is attached to the LPT1 port. If your printer is attached to a different port, you must replaceprn with the name of the correct port.

You can also redirect output of thedir command to a file by replacingprn with a file name. You can also type a path. For example, to directdir output to the file dir.doc in the Records directory, type:

dir > \records\dir.doc

If dir.doc does not exist,dir creates it, unless theRecords directory does not exist. In that case, the following message appears:

File creation error

To display a list of all the file names with the .txt extension in all directories on drive C, type:

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

Thedir command displays, in wide format, an alphabetized list of the matching file names in each directory, and it pauses each time the screen fills until you press any key to continue.

Related links

• Command-Line Syntax Key