manual/GNU_coreutils/original/man1/du.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH DU "1" "March 2020" "GNU coreutils 8.32" "User Commands"
   3 .SH NAME
   4 du \- estimate file space usage
   5 .SH SYNOPSIS
   6 .B du
   7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
   8 .br
   9 .B du
  10 [\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\fR
  11 .SH DESCRIPTION
  12 .\" Add any additional description here
  13 .PP
  14 Summarize disk usage of the set of FILEs, recursively for directories.
  15 .PP
  16 Mandatory arguments to long options are mandatory for short options too.
  17 .TP
  18 \fB\-0\fR, \fB\-\-null\fR
  19 end each output line with NUL, not newline
  20 .TP
  21 \fB\-a\fR, \fB\-\-all\fR
  22 write counts for all files, not just directories
  23 .TP
  24 \fB\-\-apparent\-size\fR
  25 print apparent sizes, rather than disk usage; although
  26 the apparent size is usually smaller, it may be
  27 larger due to holes in ('sparse') files, internal
  28 fragmentation, indirect blocks, and the like
  29 .TP
  30 \fB\-B\fR, \fB\-\-block\-size\fR=\fI\,SIZE\/\fR
  31 scale sizes by SIZE before printing them; e.g.,
  32 \&'\-BM' prints sizes in units of 1,048,576 bytes;
  33 see SIZE format below
  34 .TP
  35 \fB\-b\fR, \fB\-\-bytes\fR
  36 equivalent to '\-\-apparent\-size \fB\-\-block\-size\fR=\fI\,1\/\fR'
  37 .TP
  38 \fB\-c\fR, \fB\-\-total\fR
  39 produce a grand total
  40 .TP
  41 \fB\-D\fR, \fB\-\-dereference\-args\fR
  42 dereference only symlinks that are listed on the
  43 command line
  44 .TP
  45 \fB\-d\fR, \fB\-\-max\-depth\fR=\fI\,N\/\fR
  46 print the total for a directory (or file, with \fB\-\-all\fR)
  47 only if it is N or fewer levels below the command
  48 line argument;  \fB\-\-max\-depth\fR=\fI\,0\/\fR is the same as
  49 \fB\-\-summarize\fR
  50 .TP
  51 \fB\-\-files0\-from\fR=\fI\,F\/\fR
  52 summarize disk usage of the
  53 NUL\-terminated file names specified in file F;
  54 if F is \-, then read names from standard input
  55 .TP
  56 \fB\-H\fR
  57 equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR)
  58 .TP
  59 \fB\-h\fR, \fB\-\-human\-readable\fR
  60 print sizes in human readable format (e.g., 1K 234M 2G)
  61 .TP
  62 \fB\-\-inodes\fR
  63 list inode usage information instead of block usage
  64 .TP
  65 \fB\-k\fR
  66 like \fB\-\-block\-size\fR=\fI\,1K\/\fR
  67 .TP
  68 \fB\-L\fR, \fB\-\-dereference\fR
  69 dereference all symbolic links
  70 .TP
  71 \fB\-l\fR, \fB\-\-count\-links\fR
  72 count sizes many times if hard linked
  73 .TP
  74 \fB\-m\fR
  75 like \fB\-\-block\-size\fR=\fI\,1M\/\fR
  76 .TP
  77 \fB\-P\fR, \fB\-\-no\-dereference\fR
  78 don't follow any symbolic links (this is the default)
  79 .TP
  80 \fB\-S\fR, \fB\-\-separate\-dirs\fR
  81 for directories do not include size of subdirectories
  82 .TP
  83 \fB\-\-si\fR
  84 like \fB\-h\fR, but use powers of 1000 not 1024
  85 .TP
  86 \fB\-s\fR, \fB\-\-summarize\fR
  87 display only a total for each argument
  88 .TP
  89 \fB\-t\fR, \fB\-\-threshold\fR=\fI\,SIZE\/\fR
  90 exclude entries smaller than SIZE if positive,
  91 or entries greater than SIZE if negative
  92 .TP
  93 \fB\-\-time\fR
  94 show time of the last modification of any file in the
  95 directory, or any of its subdirectories
  96 .TP
  97 \fB\-\-time\fR=\fI\,WORD\/\fR
  98 show time as WORD instead of modification time:
  99 atime, access, use, ctime or status
 100 .TP
 101 \fB\-\-time\-style\fR=\fI\,STYLE\/\fR
 102 show times using STYLE, which can be:
 103 full\-iso, long\-iso, iso, or +FORMAT;
 104 FORMAT is interpreted like in 'date'
 105 .TP
 106 \fB\-X\fR, \fB\-\-exclude\-from\fR=\fI\,FILE\/\fR
 107 exclude files that match any pattern in FILE
 108 .TP
 109 \fB\-\-exclude\fR=\fI\,PATTERN\/\fR
 110 exclude files that match PATTERN
 111 .TP
 112 \fB\-x\fR, \fB\-\-one\-file\-system\fR
 113 skip directories on different file systems
 114 .TP
 115 \fB\-\-help\fR
 116 display this help and exit
 117 .TP
 118 \fB\-\-version\fR
 119 output version information and exit
 120 .PP
 121 Display values are in units of the first available SIZE from \fB\-\-block\-size\fR,
 122 and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables.
 123 Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set).
 124 .PP
 125 The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
 126 Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000).
 127 Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
 128 .SH PATTERNS
 129 PATTERN is a shell pattern (not a regular expression).  The pattern
 130 .B ?\&
 131 matches any one character, whereas
 132 .B *
 133 matches any string (composed of zero, one or multiple characters).  For
 134 example,
 135 .B *.o
 136 will match any files whose names end in
 137 .BR .o .
 138 Therefore, the command
 139 .IP
 140 .B du \-\-exclude=\(aq*.o\(aq
 141 .PP
 142 will skip all files and subdirectories ending in
 143 .B .o
 144 (including the file
 145 .B .o
 146 itself).
 147 .SH AUTHOR
 148 Written by Torbjorn Granlund, David MacKenzie, Paul Eggert,
 149 and Jim Meyering.
 150 .SH "REPORTING BUGS"
 151 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
 152 .br
 153 Report any translation bugs to <https://translationproject.org/team/>
 154 .SH COPYRIGHT
 155 Copyright \(co 2020 Free Software Foundation, Inc.
 156 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
 157 .br
 158 This is free software: you are free to change and redistribute it.
 159 There is NO WARRANTY, to the extent permitted by law.
 160 .SH "SEE ALSO"
 161 Full documentation <https://www.gnu.org/software/coreutils/du>
 162 .br
 163 or available locally via: info \(aq(coreutils) du invocation\(aq