1.\" $NetBSD: df.1,v 1.17 1999/03/22 18:30:44 garbled Exp $ 2.\" 3.\" Copyright (c) 1989, 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.\" @(#)df.1 8.2 (Berkeley) 1/13/92 35.\" 36.Dd January 13, 1994 37.Dt DF 1 38.Os 39.Sh NAME 40.Nm df 41.Nd display free disk space 42.Sh SYNOPSIS 43.Nm 44.Op Fl ikln 45.Op Fl t Ar type 46.Op Ar file | Ar file_system ... 47.Sh DESCRIPTION 48.Nm 49displays statistics about the amount of free disk space on the specified 50.Ar file_system 51or on the file system of which 52.Ar file 53is a part. 54Values are displayed in 512-byte per block block counts. 55If neither a file or a 56.Ar file_system 57operand is specified, 58statistics for all mounted file systems are displayed 59(subject to the 60.Fl l 61and 62.Fl t 63options below). 64.Pp 65Note that the printed count of available blocks takes 66.Va minfree 67into account, and thus will be negative when the number of free blocks 68on the filesystem is less than 69.Va minfree . 70.Pp 71The following options are available: 72.Bl -tag -width Ds 73.It Fl i 74Include statistics on the number of free inodes. 75.It Fl k 76By default, all sizes are reported in 512-byte block counts. 77The 78.Fl k 79option causes the numbers to be reported in kilobyte counts. 80.It Fl l 81Display statistics only about mounted file systems with the MNT_LOCAL 82flag set. If a non-local file system is given as an argument, a 83warning is issued and no information is given on that file system. 84.It Fl n 85Print out the previously obtained statistics from the file systems. 86This option should be used if it is possible that one or more 87file systems are in a state such that they will not be able to provide 88statistics without a long delay. 89When this option is specified, 90.Nm 91will not request new statistics from the file systems, but will respond 92with the possibly stale statistics that were previously obtained. 93.It Fl t Ar type 94Is used to indicate the actions should only be taken on 95filesystems of the specified type. 96More than one type may be specified in a comma separated list. 97The list of filesystem types can be prefixed with 98.Dq no 99to specify the filesystem types for which action should 100.Em not 101be taken. If a file system is given on the command line that is not of 102the specified type, a warning is issued and no information is given on 103that file system. 104.El 105.Sh ENVIRONMENT VARIABLES 106.Bl -tag -width BLOCKSIZE 107.It Ev BLOCKSIZE 108If the environment variable 109.Ev BLOCKSIZE 110is set, and the 111.Fl k 112option is not specified, the block counts will be displayed in units of that 113size block. 114.El 115.Sh SEE ALSO 116.Xr quota 1 , 117.Xr statfs 2 , 118.Xr fstatfs 2 , 119.Xr getfsstat 2 , 120.Xr getmntinfo 3 , 121.Xr fstab 5 , 122.Xr mount 8 , 123.Xr quot 8 , 124.Xr fs 5 , 125.Xr tunefs 8 126.Sh HISTORY 127A 128.Nm 129utility appeared in 130.At v6 . 131