|
,
| Use comma instead of space as thousands separator
Displays 1,234,567 instead of 1 234 567.
|
|
b
| "Bogus mode" Report file sizes added together
instead of cluster allocation.
This only works in the 'Usage by Directory' list.
Note that the
qualifiers disregard the status of
this switch, and always use the actual cluster allocation.
|
|
c
| Report diskusage in clusters instead of bytes.
Reported sizes in all 'Usage By' lists will show the number of allocated
clusters instead of allocated bytes.
|
|
d
| Display only directories, extentions or users that
qualify - Console version only
All qualifiers specified with /Q must be met by the directory/user for it to be
listed. See /Q
switch .
|
|
e
| Ignore scanning errors
Doesn't display (or stop at) any errors encountered during a scan.
|
|
f[:size]
| Fake clustersize.
Normally Zdu determines the clustersize of the scanned disk automatically. This
can be overridden with this flag. This could be useful if comparing a directory
on two different computers. The specified cluster size [N] will be truncated to
the nearest lower power of 2. Entering a 'k' after the number will treat it as
kilobytes instead of bytes, e.g. /f:32k to
fake the size to 32 kilobytes.
|
|
h
| Display usage in human readable format.
The usage numbers (both bytes and cluster formats) will be displayed in more
easily to read numbers using suffix, like k, M and G (as in kilo-, Mega-
Gigabytes) depending on the size of the number. Similar to the -h switch on
some versions of "du".
|
|
i
| Display disk info header only.
Basically a shortcut for the format specifier /F:0i,
which causes all directory scanning to be skipped and only display the disk
info header (free, total, filesystem etc.)
|
|
k
| Report diskusage in kilo- bytes or clusters.
similar to the -k switch on some versions of "du".
|
|
m
| Mark dirs/ext/users that qualify - Console
version only
This option will add a new column to all output lists, named 'Q' (qualified).
Qualified directories/extension/users will be marked with a * in this new
column See /Q
switch .
|
|
r[:levels]
| Display the disk usage recursively.
Optionally a level limit can be set to restrict the number of directory levels
that are output. For example, /r:2 will
display a maximum of 2 levels of directories beneath the path scanned. This
switch disables the /S switch.
|
|
s
| Silent mode.
Will only output the bottom line, i.e. the total usage of the scanned path.
|
|
S
| Similar to the
/s switch
But includes the configured fields and the disk info
header. If this switch is given Zdu will only return the total usage of the
specified path plus the available info about the disk.
|
|
t
| Non-standard sTreams.
Only supported on NTFS disks. This will search every single file for
non-standard streams and add the sizes of those to the file size. It will also
add the streams column to the output, which will display the number of non-
standard streams collected in the directory.
|
|
u:user
| Report usage of file/dirs owned by a user
(=[domain\]user)
Under Windows NT on NTFS disks Zdu can filter the usage calculation to only
count the files which are owned by the specified user. If a domain is included
in the user specification it must also match the file owner. Entering something
like /u:.\haywire would count only files
owned by the local user "haywire".
|
|
ud:user
| Similar to the u:user switch
But also filters directories as well as files.
|
|
x:pattern
| Exclude files that matches pattern
This follows the same pattern rules as the
filter .
|
|
F:format
| Modifies the 'Usage by Directory' output from Zdu
format can be one or more of the following:
|
| 0
| clear all
|
|
| *
| set all
|
|
| -
| disable the feature that follows this character
(instead of add)
|
|
| b
| (add) bottom line (total usage)
|
|
| d
| (add) Directories column
|
|
| e
| (add) Efficiency column
|
|
| f
| (add) Files column
|
|
| h
| (add) column Headers
|
|
| i
| (add) disk Info header
|
|
| p
| (add) Path column (relative paths)
|
|
| P
| (add) Path column (absolute paths)
|
|
| t
| (add) sTreams column
|
|
| u
| (add) Usage column |
By specifying any of the column fields or feature, it
will be added unless the '-' preceeds it, e.g. enter /F:t
and Zdu will add the streams column (labeled 'S') to the output, or entering
/F:-d will remove the 'Dirs' column from the output. By default Zdu
outputs Dirs, Files, Usage, Efficiency and Path columns. If all features are
cleared (with '0' or - for all), the default output format will be used. If
both 'p' and 'P' are specified the latter will be the one used. The order of
the columns can not be specified.
|
|
I:arguments
| Extra disk info header formatting - Console
version only
|
| m
| Multiple lines mode. Spreads disk info header on
more lines and includes more fields.
|
|
| M
| similar to 'm', but displays the drive letter on
every line instead of a separate line. |
|
|
Mopt:pattern
|
Matching options with regular expressions
opt
can be one of the following:
|
| xf
| exclude files matching pattern
|
|
| xd
| exclude directories matching pattern
|
|
| if
| include files matching pattern
|
|
| id
| include directories matching pattern |
pattern is a Perl-compatible regular
expression (powered by
PCRE).
All four patterns can be set at the same time on the
command line.
Excluding patterns are processed first, so anything
that matches either xf or xd will not be
included in the usage data, even if if or id matches. Note
that when patterns are not set, the exclude patterns (xf
and xd) are treated as false matches, and include
patterns (if and id) are treated as
true. When a directory is excluded (either by matching the xf
pattern, or by not matching the if pattern) all the files and
directories it contain are of course also excluded.
Note: if pattern contains any characters
interpreted by the command shell (e.g. the vertical bar), the whole command
line argument will need to be quoted: "/Mif:patt|ern"
|
|
Olist:column
| Specify sorting order for all Zdu's output lists
list can be one of the following:
|
| d
| Set sorting for 'Usage by Directory' list.
|
|
| x
| Set sorting for 'Usage by Extension' list.
|
|
| o
| Set sorting for 'Usage by Owner' list. |
And subsequently the column values for each
list:
|
| For 'Usage by Directory' list:
|
|
| d
| Directories
|
|
| e
| Efficiency
|
|
| f
| Files
|
|
| p
| Path
|
|
| t
| Streams
|
|
| u
| Usage
|
|
| For 'Usage by Extension' list:
|
|
| c
| Count
|
|
| u
| Usage
|
|
| x
| eXtension
|
|
| For 'Usage by Owner' list:
|
|
| d
| Directories
|
|
| f
| Files
|
|
| o
| Owner
|
|
| u
| Usage |
|
|
Qname(+/-)value
| Set qualifier for dirs/exts/users. - Console
version only
This option sets qualifiers that is used by other options, e.g.
/m,
/d
and /R
. Qualifers without those switches are useless. Several qualifiers can be
entered on the command-line.
Available qualifiers are:
|
| usage
| usage of directory/extension/user
|
|
| filesusage
| usage of a directory's files (not sub-directories)
(only directories)
|
|
| freespace
| free space on current drive
|
|
| filecount
| file count (only directories)
|
|
| dircount
| directory count (only directories)
|
|
| efficiency
| efficiency percentage (only directories)
|
|
| streamcount
| file stream count (atleast 1) (only
directories)
|
|
| streamusage
| usage of non-std streams (only directories) |
|
| + or -
| signifies whether the value represented by the
qualifier (e.g. free space) should be larger(+) or smaller(-) than the
<value> number. |
|
| <value>
| Integer number, specifying a size or a count.
suffixes like, kilo, Mega, Giga, Tera and Peta
can be used. Bytes/cluster unit depends on
/c switch . Do note that the usage
values are on a cluster basis, not on byte basis, which might make it seem to
give a false positive sometimes. |
Examples:
/Qusage+300
qualifier set when the directory size is more than
300 bytes(or clusters).
/Qfreespace-4G
qualifier set when the free space on the current
drive is less than 4 Giga bytes(or clusters).
|
|
R:mode
| Set return code of process depending on: - Console
version only
|
| q
| when ANY qualifier is met exit code=1, else 0
[default] |
Note 1: When scanning multiple drives, the return
code is 'accumulated' for all scans, meaning that if one scan qualifies the end
result will be as such (return code = 1).
Note 2: The qualifiers only takes the total size and total counts
resulting from the scan into account.
|
|
U:format
| Selects one or more output lists
|
| d
| Usage by Dir (default).
|
|
| x
| Usage by file Extension.
|
|
| o
| Usage by Owner (NTFS only). |
Example:
/U:dx
This will enable both the 'Usage by Directory' and
the 'Usage by extension' lists.
|
|
X:opt
|
Set extended options: -
Console version only
|
| db
| Database output mode (dbmode).
|
|
| dbsep
| in dbmode - set field separator character. - implies
/X:db
|
|
| dbfixed
| in dbmode - set fixed field width (in characters). -
imples /X:db |
Example:
/X:dbsep=;
This will enable dbmode and set the field separator
character to a semicolon. Database output mode implies /I:M
as well.
|
