DirSize: Online Help
    Command Line Options
 

Submit feedback on this topic 

Home

Up

 

When properly configured, DirSize can be tailored to run overnight and collect statistics about all your file servers, and about who is using the most space.

Typing

dirsize -?

on its own will display usage information.

Usage:

dirsize [options] [folder]

Where [options] is zero or more of:

[folder] Default: Current path

The folder to process. This may be a UNC path (\\computer_name\share_name\path). Folder names with special characters such as spaces must be entered with double quotes e.g.

c:\> dirsize "Program Files"
-? Display command line help
-# Default: All levels (255)

Limits the number of levels of folders displayed to the given value. Eg -1 will only show the first folder level. The statistics will include all levels, but they will not be displayed. This is very useful if you just need to find out how much total space is in use by an application without caring how it is divided into sub-folders. A value of 0 is equivalent to a value of 255 (i.e. all levels).

-asper Show the wasted space per folder as a percentage of the folder's used space (default).
-asval Show the actual wasted space per folder rather than as a percentage of the folder's used space.
-c<+|-> Control which characters to use for drawing lines.

+ Uses DOS's graphical line drawing characters even if it detects that its output is being redirected.

- Uses portable text line drawing characters even if it detects that its output is not being redirected. This is useful if the result is going to be used on another computer, for example, on a Unix machine or a Macintosh.

Note: When DirSize detects that its output is being redirected, it automatically turns off pagination, and selects portable characters to draw lines, such as +, - and |. It does this because the output may be sent to a device or another computer that does not understand DOS's line drawing characters (which are non-portable). When DirSize's output goes to the screen, it uses the DOS line drawing characters. You can override the default behaviour in either case using the -c option

-cl=# Show how much disk space would be wasted if the cluster size was set to # bytes per cluster. # is restricted by DOS to powers of two, but for convenience DirSize allows it to be set to any value. This is useful for previewing the result of a change in cluster size on a set of files. In general, the smaller the cluster size, the smaller the wasted space. As for -size=# above, a K, M or G suffix can be used.
-comma Print the result in a comma-delimited output format suitable for importing into a spreadsheet, database or word processor.
-config Runs DirSize's command line configuration program, config.exe
-crystal Displays web browser at Crystal Software's home page
-dir In this mode, DirSize does not round up the space used by each folder (the local size, not including any subfolders). DirSize also ignores the space used in each folder by DOS for housekeeping.
-dirsize Displays web browser on DirSize's Home Page
-longest Show a report of the paths exceeding 255 characters, or those with invalid characters in their names.
-mail Send mail to the author
-manual Displays this manual
-nofiles Disable display of file count column.
-nooffline Ignore offline files in the statistics
-nostats Disable the drive statistics shown at the end of the report.
-nosubs Do not show sub folder counts in square brackets
-nototals Do not show folder totals on the left hand side
-noheader Disables display of the header in the CSV and Tab reports
-nowaste Do not show wasted space for each folder. The wasted space is still included in the totals - it is just not shown as a display column.
-order Displays DirSize order form
-p Do not paginate the output. Pagination pauses after each screenful of output. [Enter] shows the next line, [Esc] exits, [End] scrolls continuously to the end of the output, and any other key shows the next screen full of output. Pagination is automatically disabled when the output is redirected.
-purchase Displays web browser to purchase DirSize
-size=# Only show folders that use # space or larger. A K, M or G suffix can be used to express the value in KBytes (1024 bytes), MBytes (1024 KBytes) or GBytes (1024 Mbytes). This is very useful for finding network space hogs, or for eliminating small folders that are of no consequence from the display.
-sort=[name|local|total|waste|files|none] Default: name

Specifies the sort order:

  • Name - sort by folder name in alphabetical order.
  • Local - sort by local size, largest first.
  • Total - sort by total size, largest first.
  • Waste - sort by wasted space, largest first (not as percentage of overall space).
  • Files - sort by number of files, largest first.
  • None - do not sort.

This may be useful if you are comparing DirSize's output to an unsorted listing from the DOS DIR command - each folder is displayed in the same order it was retrieved from disk.

-tab Same as -comma above but outputs in tab-delimited format.
-w Displays help/welcome screen

Error Messages

Maximum path length of 255 exceeded for folder XXXX. Path skipped.

Subfolders whose name exceeds the Windows maximum path length will not be processed. Any statistics regarding them will be ignored. You can handle these by mapping a drive letter to the point deep in the folder path.

Path was not found (invalid character or maximum path length exceeded?): XXXX

For some reason the path was not found. It will be excluded from the statistics.

 

 

 Contact Us   Support   Community   Tutorials and User Guides (online)
 Copyright © 1999-2006 DataMystic. All rights reserved.