usr/src/man/man1b/du.1b

   1 '\" te
   2 .\"  Copyright (c) 2001 Sun Microsystems, Inc. - All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH DU 1B "Jun 5, 2001"
   7 .SH NAME
   8 du \- display the number of disk blocks used per directory or file
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/ucb/du\fR [\fB-adkLr\fR] [\fB-o\fR | \fB-s\fR] [\fIfilename\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBdu\fR utility gives the number of kilobytes contained in all files and,
  19 recursively, directories within each specified directory or file
  20 \fIfilename\fR. If \fIfilename\fR is missing, `\fB\&.\fR' (the current
  21 directory) is used.
  22 .sp
  23 .LP
  24 A file that has multiple links to it is only counted once.
  25 .SH OPTIONS
  26 .sp
  27 .LP
  28 The following options are supported:
  29 .sp
  30 .ne 2
  31 .na
  32 \fB\fB-a\fR\fR
  33 .ad
  34 .RS 6n
  35 Generates an entry for each file.
  36 .RE
  37
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fB-d\fR\fR
  42 .ad
  43 .RS 6n
  44 Does not cross file system boundaries. For example, \fBdu\fR \fB-d\fR \fB/\fR
  45 reports usage only on the root partition.
  46 .RE
  47
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fB-k\fR\fR
  52 .ad
  53 .RS 6n
  54 Writes the files sizes in units of 1024  bytes, rather than the default
  55 512-byte units.
  56 .RE
  57
  58 .sp
  59 .ne 2
  60 .na
  61 \fB\fB-L\fR\fR
  62 .ad
  63 .RS 6n
  64 Processes symbolic links by using the file or directory that the symbolic link
  65 references, rather than the link itself.
  66 .RE
  67
  68 .sp
  69 .ne 2
  70 .na
  71 \fB\fB-o\fR\fR
  72 .ad
  73 .RS 6n
  74 Does not add child directories' usage to a parent's total. Without this option,
  75 the usage listed for a particular directory is the space taken by the files in
  76 that directory, as well as the files in all directories beneath it. This option
  77 does nothing if the \fB-s\fR option is used.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fB-r\fR\fR
  84 .ad
  85 .RS 6n
  86 Generates messages about directories that cannot be read, files that cannot be
  87 opened, and so forth, rather than being silent (the default).
  88 .RE
  89
  90 .sp
  91 .ne 2
  92 .na
  93 \fB\fB-s\fR\fR
  94 .ad
  95 .RS 6n
  96 Only displays the grand total for each of the specified \fIfilename\fRs.
  97 .RE
  98
  99 .sp
 100 .LP
 101 Entries are generated only for each directory in the absence of options.
 102 .SH EXAMPLES
 103 .LP
 104 \fBExample 1 \fRShowing usage of all subdirectories in a directory
 105 .sp
 106 .LP
 107 This example uses \fBdu\fR in a directory. The \fBpwd\fR(1) command was used to
 108 identify the directory, then \fBdu\fR was used to show the usage of all the
 109 subdirectories in that directory. The grand total for the directory is the last
 110 entry in the display:
 111
 112 .sp
 113 .in +2
 114 .nf
 115 example% \fBpwd\fR
 116 /usr/ralph/misc
 117 example% \fBdu\fR
 118 5      ./jokes
 119 33     ./squash
 120 44     ./tech.papers/lpr.document
 121 217    ./tech.papers/new.manager
 122 401    ./tech.papers
 123 144    ./memos
 124 80     ./letters
 125 388    ./window
 126 93     ./messages
 127 15     ./useful.news
 128 1211   .
 129 .fi
 130 .in -2
 131 .sp
 132
 133 .SH ENVIRONMENT VARIABLES
 134 .sp
 135 .LP
 136 If any of the \fBLC_*\fR variables, that is, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR,
 137 \fBLC_TIME\fR, \fBLC_COLLATE\fR, \fBLC_NUMERIC\fR, and \fBLC_MONETARY\fR (see
 138 \fBenviron\fR(5)), are not set in the environment, the operational behavior of
 139 \fBdu\fR for each corresponding locale category is determined by the value of
 140 the \fBLANG\fR environment variable. If \fBLC_ALL\fR is set, its contents are
 141 used to override both the \fBLANG\fR and the other \fBLC_*\fR variables. If
 142 none of the above variables is set in the environment, the "C" (U.S. style)
 143 locale determines how \fBdu\fR behaves.
 144 .sp
 145 .ne 2
 146 .na
 147 \fB\fBLC_CTYPE\fR\fR
 148 .ad
 149 .RS 15n
 150 Determines how  \fBdu\fR handles characters. When \fBLC_CTYPE\fR is set to a
 151 valid value, \fBdu\fR can display and handle text and filenames containing
 152 valid characters for that locale. \fBdu\fR can display and handle Extended Unix
 153 Code (EUC) characters where any individual character can be 1, 2, or 3 bytes
 154 wide. \fBdu\fR can also handle EUC characters of 1, 2, or more column widths.
 155 In the "C" locale, only characters from ISO 8859-1 are valid.
 156 .RE
 157
 158 .sp
 159 .ne 2
 160 .na
 161 \fB\fBLC_MESSAGES\fR\fR
 162 .ad
 163 .RS 15n
 164 Determines how diagnostic and informative messages are presented. This includes
 165 the language and style of the messages, and the correct form of affirmative and
 166 negative responses.  In the "C" locale, the messages are presented in the
 167 default form found in the program itself (in most cases, U.S. English).
 168 .RE
 169
 170 .SH SEE ALSO
 171 .sp
 172 .LP
 173 \fBpwd\fR(1), \fBdf\fR(1M), \fBdu\fR(1), \fBquot\fR(1M), \fBattributes\fR(5),
 174 \fBenviron\fR(5)
 175 .SH NOTES
 176 .sp
 177 .LP
 178 Filename arguments that are not directory names are ignored, unless you use
 179 \fB-a\fR.
 180 .sp
 181 .LP
 182 If there are too many distinct linked files, \fBdu\fR will count the excess
 183 files more than once.