summaryrefslogtreecommitdiff
path: root/man/du.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/du.1')
-rw-r--r--man/du.1153
1 files changed, 153 insertions, 0 deletions
diff --git a/man/du.1 b/man/du.1
new file mode 100644
index 0000000..97c197d
--- /dev/null
+++ b/man/du.1
@@ -0,0 +1,153 @@
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
+.TH DU "1" "March 2007" "GNU coreutils 6.9" "User Commands"
+.SH NAME
+du \- estimate file space usage
+.SH SYNOPSIS
+.B du
+[\fIOPTION\fR]... [\fIFILE\fR]...
+.br
+.B du
+[\fIOPTION\fR]... \fI--files0-from=F\fR
+.SH DESCRIPTION
+.\" Add any additional description here
+.PP
+Summarize disk usage of each FILE, recursively for directories.
+.PP
+Mandatory arguments to long options are mandatory for short options too.
+.TP
+\fB\-a\fR, \fB\-\-all\fR
+write counts for all files, not just directories
+.TP
+\fB\-\-apparent\-size\fR
+print apparent sizes, rather than disk usage; although
+the apparent size is usually smaller, it may be
+larger due to holes in (`sparse') files, internal
+fragmentation, indirect blocks, and the like
+.TP
+\fB\-B\fR, \fB\-\-block\-size\fR=\fISIZE\fR
+use SIZE\-byte blocks
+.TP
+\fB\-b\fR, \fB\-\-bytes\fR
+equivalent to `\-\-apparent\-size \fB\-\-block\-size\fR=\fI1\fR'
+.TP
+\fB\-c\fR, \fB\-\-total\fR
+produce a grand total
+.TP
+\fB\-D\fR, \fB\-\-dereference\-args\fR
+dereference FILEs that are symbolic links
+.TP
+\fB\-\-files0\-from\fR=\fIF\fR
+summarize disk usage of the NUL\-terminated file
+names specified in file F
+.TP
+\fB\-H\fR
+like \fB\-\-si\fR, but also evokes a warning; will soon
+change to be equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR)
+.TP
+\fB\-h\fR, \fB\-\-human\-readable\fR
+print sizes in human readable format (e.g., 1K 234M 2G)
+.TP
+\fB\-\-si\fR
+like \fB\-h\fR, but use powers of 1000 not 1024
+.TP
+\fB\-k\fR
+like \fB\-\-block\-size\fR=\fI1K\fR
+.TP
+\fB\-l\fR, \fB\-\-count\-links\fR
+count sizes many times if hard linked
+.TP
+\fB\-m\fR
+like \fB\-\-block\-size\fR=\fI1M\fR
+.TP
+\fB\-L\fR, \fB\-\-dereference\fR
+dereference all symbolic links
+.TP
+\fB\-P\fR, \fB\-\-no\-dereference\fR
+don't follow any symbolic links (this is the default)
+.TP
+\fB\-0\fR, \fB\-\-null\fR
+end each output line with 0 byte rather than newline
+.TP
+\fB\-S\fR, \fB\-\-separate\-dirs\fR
+do not include size of subdirectories
+.TP
+\fB\-s\fR, \fB\-\-summarize\fR
+display only a total for each argument
+.TP
+\fB\-x\fR, \fB\-\-one\-file\-system\fR
+skip directories on different file systems
+.TP
+\fB\-X\fR FILE, \fB\-\-exclude\-from\fR=\fIFILE\fR
+Exclude files that match any pattern in FILE.
+.TP
+\fB\-\-exclude\fR=\fIPATTERN\fR
+Exclude files that match PATTERN.
+.TP
+\fB\-\-max\-depth\fR=\fIN\fR
+print the total for a directory (or file, with \fB\-\-all\fR)
+only if it is N or fewer levels below the command
+line argument; \fB\-\-max\-depth\fR=\fI0\fR is the same as
+\fB\-\-summarize\fR
+.TP
+\fB\-\-time\fR
+show time of the last modification of any file in the
+directory, or any of its subdirectories
+.TP
+\fB\-\-time\fR=\fIWORD\fR
+show time as WORD instead of modification time:
+atime, access, use, ctime or status
+.TP
+\fB\-\-time\-style\fR=\fISTYLE\fR
+show times using style STYLE:
+full\-iso, long\-iso, iso, +FORMAT
+FORMAT is interpreted like `date'
+.TP
+\fB\-\-help\fR
+display this help and exit
+.TP
+\fB\-\-version\fR
+output version information and exit
+.PP
+SIZE may be (or may be an integer optionally followed by) one of following:
+kB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.
+.SH PATTERNS
+PATTERN is a shell pattern (not a regular expression). The pattern
+.BR ?
+matches any one character, whereas
+.BR *
+matches any string (composed of zero, one or multiple characters). For
+example,
+.BR *.o
+will match any files whose names end in
+.BR .o .
+Therefore, the command
+.IP
+.B du --exclude='*.o'
+.PP
+will skip all files and subdirectories ending in
+.BR .o
+(including the file
+.BR .o
+itself).
+.SH AUTHOR
+Written by Torbjorn Granlund, David MacKenzie, Paul Eggert, and Jim Meyering.
+.SH "REPORTING BUGS"
+Report bugs to <bug\-coreutils@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2007 Free Software Foundation, Inc.
+.br
+This is free software. You may redistribute copies of it under the terms of
+the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+The full documentation for
+.B du
+is maintained as a Texinfo manual. If the
+.B info
+and
+.B du
+programs are properly installed at your site, the command
+.IP
+.B info du
+.PP
+should give you access to the complete manual.