df(1B)

NAME

     df - display status of disk space on file systems

SYNOPSIS

     /usr/ucb/df    [-a]    [-i]    [-t type]     [filesystem...]
     [filename...]

DESCRIPTION

     The df utility displays the amount of disk space occupied by
     currently  mounted  file  systems,  the  amount  of used and
     available space, and how much of  the  file  system's  total
     capacity has been used.

     If arguments to df are path names, df produces a  report  on
     the  file  system  containing  the  named file. Thus `df  .'
     shows the amount of space on the file system containing  the
     current directory.

OPTIONS

     The following options are supported:

     -a    Report on all filesystems including the  uninteresting
           ones  which  have  zero  total  blocks (that is, auto-
           mounter).

     -i    Report the number of used and free inodes. Print ` * '
           if no information is available.

     -t type
           Report on filesystems of a given  type  (for  example,
           nfs or ufs).

USAGE

     When a UFS file system is mounted with logging enabled, file
     system  transactions  that  free blocks from files might not
     actually add those freed blocks to the  file  system's  free
     list  until  some  unspecified  time  in  the  future.  This
     behavior improves file system performance but does not  con-
     form  to the POSIX, Single UNIX Specification, SPARC Confor-
     mance Definition, System  V  Application  Binary  Interface,
     System  V Interface Definition, and X/Open Portability Guide
     Standards, which  require  that  freed  space  be  available
     immediately.  To enable standards conformance regarding file
     deletions or to address the problem of  not  being  able  to
     grow  files  on a relatively full UFS file system even after
     files  have  been  deleted,   disable   UFS   logging   (see
     mount_ufs(1M).

EXAMPLES

     Example 1: Output sample

     A sample of output for df looks like:

     example% df
     Filesystem   kbytes  used  avail  capacity  Mounted on
     sparky:/       7445  4714  1986     70%     /
     sparky:/usr   42277 35291  2758     93%     /usr

     Note that used+avail is less than the amount of space in the
     file  system (kbytes); this is because the system reserves a
     fraction of the space in the file system to allow  its  file
     system allocation routines to work well. The amount reserved
     is typically about 10%; this may be  adjusted  using  tunefs
     (see tunefs(1M)). When all the space on a file system except
     for this reserve is in use, only the super-user can allocate
     new  files  and  data  blocks to existing files. When a file
     system is overallocated in this way, df may report that  the
     file system is more than 100% utilized.

FILES

     /etc/mnttab
           list of file systems currently mounted

     /etc/vfstab
           list of default parameters for each file system

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWscpu                    |
    |_____________________________|_____________________________|

SEE ALSO

     du(1M),  mount_ufs(1M),  quot(1M),  tunefs(1M),   mnttab(4),
     attributes(5)