1.\" $NetBSD: du.1,v 1.12 2001/12/01 19:03:31 wiz Exp $ 2.\" 3.\" Copyright (c) 1990, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by the University of 17.\" California, Berkeley and its contributors. 18.\" 4. Neither the name of the University nor the names of its contributors 19.\" may be used to endorse or promote products derived from this software 20.\" without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" 34.\" @(#)du.1 8.2 (Berkeley) 4/1/94 35.\" 36.Dd October 4, 1996 37.Dt DU 1 38.Os 39.Sh NAME 40.Nm du 41.Nd display disk usage statistics 42.Sh SYNOPSIS 43.Nm 44.Op Fl H | Fl L | Fl P 45.Op Fl a | Fl s 46.Op Fl ckmrx 47.Op Ar file ... 48.Sh DESCRIPTION 49The 50.Nm 51utility displays the file system block usage for each file argument 52and for each directory in the file hierarchy rooted in each directory 53argument. 54If no file is specified, the block usage of the hierarchy rooted in 55the current directory is displayed. 56.Pp 57The options are as follows: 58.Bl -tag -width Ds 59.It Fl H 60Symbolic links on the command line are followed. 61(Symbolic links encountered in the tree traversal are not followed.) 62.It Fl L 63All symbolic links are followed. 64.It Fl P 65No symbolic links are followed. 66.It Fl a 67Display an entry for each file in the file hierarchy. 68.It Fl k 69By default, 70.Nm 71displays the number of blocks as returned by the 72.Xr stat 2 73system call, i.e. 512-byte blocks. 74If the 75.Fl k 76flag is specified, the number displayed is the number of kilobyte 77(1024 bytes) blocks. Partial numbers of blocks are rounded up. 78.It Fl m 79If the 80.Fl m 81flag is specified, the number displayed is the number of megabyte 82(1024*1024 bytes) blocks. 83.It Fl c 84Display the grand total after all the arguments have been processed. 85.It Fl r 86Generate warning messages about directories that cannot be read. 87This is the default behaviour. 88.It Fl s 89Display only the grand total for the specified files. 90.It Fl x 91Filesystem mount points are not traversed. 92.El 93.Pp 94.Nm 95counts the storage used by symbolic links and not the files they 96reference unless the 97.Fl H 98or 99.Fl L 100option is specified. 101If either the 102.Fl H 103or 104.Fl L 105options are specified, storage used by any symbolic links which are 106followed is not counted or displayed. 107The 108.Fl H , 109.Fl L 110and 111.Fl P 112options override each other and the command's actions are determined 113by the last one specified. 114.Pp 115Files having multiple hard links are counted (and displayed) a single 116time per 117.Nm 118execution. 119.Sh ENVIRONMENT 120.Bl -tag -width BLOCKSIZE 121.It Ev BLOCKSIZE 122If the environment variable 123.Ev BLOCKSIZE 124is set, and the 125.Fl k 126and 127.Fl m 128options are not specified, the block counts will be displayed in units of that 129size block. 130.El 131.Sh SEE ALSO 132.Xr df 1 , 133.Xr fts 3 , 134.Xr getbsize 3 , 135.Xr symlink 7 , 136.Xr quot 8 137.Sh HISTORY 138A 139.Nm 140command appeared in 141.At v6 . 142