bin/df/df.1

   1 .\" Copyright (c) 1989, 1990, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)df.1        8.3 (Berkeley) 5/8/95
  33 .\" $FreeBSD$
  34 .\"
  35 .Dd May 8, 1995
  36 .Dt DF 1
  37 .Os BSD 4
  38 .Sh NAME
  39 .Nm df
  40 .Nd display free disk space
  41 .Sh SYNOPSIS
  42 .Nm df
  43 .Op Fl b | h | H | k | m | P
  44 .Op Fl ain
  45 .Op Fl t Ar type
  46 .Op Ar file | Ar filesystem ...
  47 .Sh DESCRIPTION
  48 .Nm Df
  49 displays statistics about the amount of free disk space on the specified
  50 .Ar filesystem
  51 or on the filesystem of which
  52 .Ar file
  53 is a part.
  54 Values are displayed in 512-byte per block counts.
  55 If neither a file or a filesystem operand is specified,
  56 statistics for all mounted filesystems are displayed
  57 (subject to the
  58 .Fl t
  59 option below).
  60 .Pp
  61 The following options are available:
  62 .Bl -tag -width Ds
  63 .It Fl a
  64 Show all mount points, including those that were mounted with the MNT_IGNORE
  65 flag.
  66 .It Fl b
  67 Use 512-byte blocks rather than the default.  Note that
  68 this overrides the
  69 .Ev BLOCKSIZE
  70 specification from the environment.
  71 .It Fl H
  72 "Human-readable" output.  Use unit suffixes: Byte, Kilobyte, Megabyte,
  73 Gigabyte, Terabyte and Petabyte in order to reduce the number of
  74 digits to three or less using base 10 for sizes.
  75 .It Fl h
  76 "Human-readable" output.  Use unit suffixes: Byte, Kilobyte, Megabyte,
  77 Gigabyte, Terabyte and Petabyte in order to reduce the number of
  78 digits to three or less using base 2 for sizes.
  79 .It Fl i
  80 Include statistics on the number of free inodes.
  81 .It Fl k
  82 Use 1024-byte (1-Kbyte) blocks rather than the default.  Note that
  83 this overrides the
  84 .Ev BLOCKSIZE
  85 specification from the environment.
  86 .It Fl m
  87 Use 1048576-byte (1-Mbyte) blocks rather than the default.  Note that
  88 this overrides the
  89 .Ev BLOCKSIZE
  90 specification from the environment.
  91 .It Fl n
  92 Print out the previously obtained statistics from the filesystems.
  93 This option should be used if it is possible that one or more
  94 filesystems are in a state such that they will not be able to provide
  95 statistics without a long delay.
  96 When this option is specified,
  97 .Nm
  98 will not request new statistics from the filesystems, but will respond
  99 with the possibly stale statistics that were previously obtained.
 100 .It Fl P
 101 Use POSIX compliant output of 512-byte blocks rather than the default.
 102 Note that this overrides the
 103 .Ev BLOCKSIZE
 104 specification from the environment.
 105 .It Fl t
 106 Only print out statistics for filesystems of the specified types.
 107 More than one type may be specified in a comma separated list.
 108 The list of filesystem types can be prefixed with
 109 .Dq no
 110 to specify the filesystem types for which action should
 111 .Em not
 112 be taken.
 113 For example, the
 114 .Nm
 115 command:
 116 .Bd -literal -offset indent
 117 df -t nonfs,mfs
 118 .Ed
 119 .Pp
 120 lists all filesystems except those of type
 121 .Tn NFS
 122 and
 123 .Tn MFS .
 124 The
 125 .Xr lsvfs 1
 126 command can be used to find out the types of filesystems
 127 that are available on the system.
 128 .El
 129 .Sh ENVIRONMENT
 130 .Bl -tag -width BLOCKSIZE
 131 .It Ev BLOCKSIZE
 132 If the environment variable
 133 .Ev BLOCKSIZE
 134 is set, the block counts will be displayed in units of that size block.
 135 .El
 136 .Sh BUGS
 137 The
 138 .Fl n
 139 and
 140 .Fl t
 141 flags are ignored if a file or filesystem is specified.
 142 .Sh SEE ALSO
 143 .Xr lsvfs 1 ,
 144 .Xr quota 1 ,
 145 .Xr fstatfs 2 ,
 146 .Xr getfsstat 2 ,
 147 .Xr statfs 2 ,
 148 .Xr getmntinfo 3 ,
 149 .Xr fstab 5 ,
 150 .Xr mount 8 ,
 151 .Xr quot 8
 152 .Sh HISTORY
 153 A
 154 .Nm
 155 command appeared in
 156 .At v1 .