1.\" $OpenBSD: du.1,v 1.28 2010/09/03 11:09:28 jmc Exp $ 2.\" $NetBSD: du.1,v 1.6 1996/10/18 07:20:31 thorpej Exp $ 3.\" 4.\" Copyright (c) 1990, 1993 5.\" The Regents of the University of California. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. Neither the name of the University nor the names of its contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)du.1 8.2 (Berkeley) 4/1/94 32.\" 33.Dd $Mdocdate: September 3 2010 $ 34.Dt DU 1 35.Os 36.Sh NAME 37.Nm du 38.Nd display disk usage statistics 39.Sh SYNOPSIS 40.Nm du 41.Op Fl a | s 42.Op Fl chkrx 43.Op Fl H | L | P 44.Op Ar 45.Sh DESCRIPTION 46The 47.Nm 48utility displays the file system block usage for each 49.Ar file 50argument 51and for each directory in the file hierarchy rooted in each directory 52argument. 53Note that the system block usage is usually greater than 54the actual size of the file. 55If no file is specified, the block usage of the hierarchy rooted in 56the current directory is displayed. 57.Pp 58The options are as follows: 59.Bl -tag -width Ds 60.It Fl a 61Display an entry for each file in the file hierarchy. 62.It Fl c 63Display the grand total after all the arguments have been processed. 64.It Fl H 65Symbolic links on the command line are followed. 66(Symbolic links encountered in the tree traversal are not followed.) 67.It Fl h 68"Human-readable" output. 69Use unit suffixes: Byte, Kilobyte, Megabyte, 70Gigabyte, Terabyte, Petabyte, Exabyte in order to reduce the number of 71digits to four or less. 72.It Fl k 73By default, all sizes are reported in 512-byte block counts. 74The 75.Fl k 76option causes the numbers to be reported in kilobyte counts. 77.It Fl L 78All symbolic links are followed. 79.It Fl P 80No symbolic links are followed. 81.It Fl r 82Generate messages about directories that cannot be read, files 83that cannot be opened, and so on. 84This is the default. 85.It Fl s 86Display only the grand total for the specified files. 87.It Fl x 88File system mount points are not traversed. 89.El 90.Pp 91It is not an error to specify more than one of 92the mutually exclusive options 93.Fl h 94and 95.Fl k . 96Where more than one of these options is specified, 97the last option given overrides the others. 98.Pp 99.Nm 100counts the storage used by symbolic links and not the files they 101reference unless the 102.Fl H 103or 104.Fl L 105option is specified. 106If either the 107.Fl H 108or 109.Fl L 110options are specified, storage used by any symbolic links which are 111followed is not counted or displayed. 112The 113.Fl H , 114.Fl L , 115and 116.Fl P 117options override each other and the command's actions are determined 118by the last one specified. 119.Pp 120Files having multiple hard links are counted (and displayed) a single 121time per 122.Nm 123execution. 124.Sh ENVIRONMENT 125.Bl -tag -width BLOCKSIZE 126.It Ev BLOCKSIZE 127Block counts will be displayed in units of this size block, unless the 128.Fl k 129or 130.Fl h 131option is specified. 132.El 133.Sh EXIT STATUS 134.Ex -std du 135.Sh SEE ALSO 136.Xr df 1 , 137.Xr fts 3 , 138.Xr symlink 7 , 139.Xr quot 8 140.Sh STANDARDS 141The 142.Nm 143utility is compliant with the 144.St -p1003.1-2008 145specification. 146.Pp 147The flags 148.Op Fl chPr 149are extensions to that specification. 150.Pp 151The flag 152.Op Fl r 153exists solely for conformance with 154.St -xpg4 . 155.Sh HISTORY 156A 157.Nm 158command appeared in 159.At v3 . 160