1.\" $NetBSD: du.1,v 1.6 1996/10/18 07:20:31 thorpej 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 du 44.Op Fl H | Fl L | Fl P 45.Op Fl a | Fl s 46.Op Fl ckx 47.Op Ar file ... 48.Sh DESCRIPTION 49The 50.Nm du 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 du 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 1024-byte 77blocks. 78Partial numbers of blocks are rounded up. 79.It Fl c 80Display the grand total after all the arguments have been processed. 81.It Fl s 82Display only the grand total for the specified files. 83.It Fl x 84Filesystem mount points are not traversed. 85.El 86.Pp 87.Nm Du 88counts the storage used by symbolic links and not the files they 89reference unless the 90.Fl H 91or 92.Fl L 93option is specified. 94If either the 95.Fl H 96or 97.Fl L 98options are specified, storage used by any symbolic links which are 99followed is not counted or displayed. 100The 101.Fl H , 102.Fl L 103and 104.Fl P 105options override each other and the command's actions are determined 106by the last one specified. 107.Pp 108Files having multiple hard links are counted (and displayed) a single 109time per 110.Nm du 111execution. 112.Sh ENVIRONMENT VARIABLES 113.Bl -tag -width BLOCKSIZE 114.It Ev BLOCKSIZE 115If the environment variable 116.Ev BLOCKSIZE 117is set, and the 118.Fl k 119option is not specified, the block counts will be displayed in units of that 120size block. 121.El 122.Sh SEE ALSO 123.Xr df 1 , 124.Xr fts 3 , 125.Xr symlink 7 , 126.Xr quot 8 127.Sh HISTORY 128A 129.Nm du 130command appeared in 131.At v6 . 132