Dir

Displays a list of a directory's files and subdirectories. Used without parameters, dir 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, dir displays the name extension and the size in bytes. Dir also displays the total number of files and directories listed, their cumulative size, and the free space (in bytes) remaining on the disk.

Syntax

dir [Drive:][Path][FileName] [...] [/p] [/q] [/w] [/d] [/a[[:]attributes]][/o[[:]SortOrder]] [/t[[:]TimeField]] [/s] [/b] [/l] [/n] [/x] [/c] [/4]

Parameters

[Drive:][Path] : Specifies the drive and directory for which you want to see a listing.

[FileName] : Specifies a particular file or group of files for which you want to see a listing.

/p : Displays one screen of the listing at a time. To see the next screen, press any key on the keyboard.

/q : Displays file ownership information.

/w : Displays the listing in wide format, with as many as five file names or directory names on each line.

/d : Same as /w but files are sorted by column.

/a [[:] attributes] : Displays only the names of those directories and files with the attributes you specify. If you omit /a, dir displays the names of all files except hidden and system files. If you use /a without specifying attributes, dir displays the names of all files, including hidden and system files. The following list describes each of the values you can use for attributes. The colon (:) is optional. Use any combination of these values, and do not separate the values with spaces.

ValueDescription

h

Hidden files

s

System files

d

Directories

a

Files ready for archiving

r

Read-only files

-h

Files that are not hidden

-s

Files other than system files

-d

Files only (not directories)

-a

Files that have not changed since the last backup

-r

Files that are not read-only

/o [[:]SortOrder] : Controls the order in which dir sorts and displays directory names and file names. If you omit /o, dir displays the names in the order in which they occur in the directory. If you use /o without specifying SortOrder, dir displays the names of the directories, sorted in alphabetic order, and then displays the names of files, sorted in alphabetic order. The colon (:) is optional. The following list describes each of the values you can use for SortOrder. Use any combination of the values, and do not separate these values with white spaces.

ValueDescription

n

In alphabetic order by name

e

In alphabetic order by extension

d

By date and time, earliest first

s

By size, smallest first

g

With directories grouped before files

-n

In reverse alphabetic order by name (Z through A)

-e

In reverse alphabetic order by extension (.ZZZ through .AAA)

-d

By date and time, latest first

-s

By size, largest first

-g

With directories grouped after files

/t [[:]TimeField] : Specifies which time field to display or use for sorting. The following list describes each of the values you can use for TimeField.

ValueDescription

c

Creation

a

Last access

w

Last written

/s : Lists every occurrence, in the specified directory and all subdirectories, of the specified file name.

/b : Lists each directory name or file name, one per line, including the file name extension. /b does not display heading information or a summary. /b overrides /w.

/l : Displays unsorted directory names and file names in lowercase. /l does not convert extended characters to lowercase.

/n : Displays a long list format with file names on the far right of the screen.

/x : Displays the short names generated for files on NTFS and FAT volumes. The display is the same as the display for /n, but short names are displayed after the long name.

/c : Displays the thousand separator in file sizes.

/4 : Displays four-digit year format.

/? : Displays help at the command prompt.

Remarks

Using multiple filenames 

You can use multiple filenames. Separate file names with spaces, commas, or semicolons. You can use wildcard characters (that is, ? and *) in FileName to display a group of files.

Using wildcards

You can use wildcards (that is, ? and *) to display a list of a subset of files and subdirectories.

Specifying file display attributes

If you use /a with more than one value in attributes, dir displays the names of only those files with all the specified attributes. For example, if you use /a with r and -h for attributes by using either /a:r-h or /ar-h, dir displays only the names of read-only files that are not hidden.

Specifying file name sorting

If you specify more than one SortOrder value, dir sorts the file names by the first criterion first, then by the second criterion, and so on. For example, if you use /o with the e and -s values for SortOrder by using either /o:e-s or /oe-s, dir 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.

Using redirection symbols and pipes

When you use a redirection symbol (>) to send dir output to a file or a pipe (|) to send dir output to another command, use /a:-d and /b to list the file names only. You can use FileName with /b and /s to specify that dir is to search the current directory and its subdirectories for all file names that match FileName. Dir 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 for redirection, you should set the TEMP environment variable in your Autoexec.nt file.

Presetting dir parameters

You can preset dir parameters by including set with the DIRCMD environment variable in your Autoexec.nt file. You can use any valid combination of dir parameters with set dircmd, including the location and name of a file.

For example, to use the DIRCMD environment variable to set the wide display format (that is, /w) as the default format, type the following command in your Autoexec.nt file:

set dircmd=/w

For a single use of the dir command, you can override a parameter by using the DIRCMD environment variable. To do so, type the parameter that you want to override at the dir command prompt, preceding the parameter with a minus sign. For example:

dir /-w

To change the DIRCMD default settings, type:

set=NewParameter

The new default settings are effective for all subsequent dir commands until you use set dircmd again or until you restart your computer.

To clear all default settings, type:

set dircmd=

To view the current settings of the DIRCMD environment variable, type:

set

Set displays a list of environment variables and their settings. For more information about setting environment variables, see Related Topics.

The dir command, with different parameters, is available from the Recovery Console.

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

Dir lists the name of the root directory, the names of the subdirectories of the root directory, and the names of the files in the root directory, including extensions. Then, dir lists the subdirectory names and file names in each subdirectory in the tree.

To alter the preceding example so that dir 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 specify prn, the directory list is sent to the printer attached to the LPT1 port. If your printer is attached to a different port, you must replace prn with the name of the correct port.

You can also redirect output of the dir command to a file by replacing prn with a file name. You can also type a path. For example, to direct dir 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 the Records 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

Dir displays, in wide format, an alphabetized list of the matching file names in each directory and pauses each time the screen fills up, until you press a key to continue.

Formatting legend

FormatMeaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

Command-line reference A-Z

Attrib

Tree

Set

Using command redirection operators

Using wildcard characters



© 2015 Microsoft Corporation. All rights reserved. Contact Us |Terms of Use |Trademarks |Privacy & Cookies