home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / df.man < prev    next >
Text File  |  1993-06-13  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. DF(1L)                                                     DF(1L)
  5.  
  6.  
  7. NAME
  8.        df - summarize free disk space
  9.  
  10. SYNOPSIS
  11.        df  [-aikPv]  [-t  fstype]  [-x fstype] [--all] [--inodes]
  12.        [--type=fstype]   [--exclude-type=fstype]    [--kilobytes]
  13.        [--portability] [--help] [--version] [path...]
  14.  
  15. DESCRIPTION
  16.        This manual page documents the GNU version of df.  df dis-
  17.        plays the amount of disk space available on the filesystem
  18.        containing  each  argument  pathname.  If no pathnames are
  19.        given,  the  space  available  on  all  currently  mounted
  20.        filesystems is shown.  Disk space is shown in 1K blocks by
  21.        default, unless the environment  variable  POSIXLY_CORRECT
  22.        is set, in which case 512-byte blocks are used.
  23.  
  24.        If  an argument is the full pathname of a disk device node
  25.        containing a mounted filesystem, df shows the space avail-
  26.        able on that filesystem rather than on the filesystem con-
  27.        taining the device node (which is always the root filesys-
  28.        tem).   This version of df cannot show the space available
  29.        on unmounted filesystems, because on most kinds of systems
  30.        doing  so  requires very nonportable intimate knowledge of
  31.        filesystem structures.
  32.  
  33.    OPTIONS
  34.        -a, --all
  35.               Include in the  listing  filesystems  that  have  0
  36.               blocks,   which   are  omitted  by  default.   Such
  37.               filesystems are typically  special-purpose  pseudo-
  38.               filesystems,  such as automounter entries.  On some
  39.               systems, filesystems of type ``ignore'' or ``auto''
  40.               are  also  omitted  by  default and included in the
  41.               listing by this option.
  42.  
  43.        -i, --inodes
  44.               List  inode  usage  information  instead  of  block
  45.               usage.   An  inode  (short for ``index node'') is a
  46.               special kind of disk block that  contains  informa-
  47.               tion  about a file, such as its owner, permissions,
  48.               timestamps, and location on the disk.
  49.  
  50.        -k, --kilobytes
  51.               Print  sizes  in  1K  blocks  instead  of  512-byte
  52.               blocks.   This  overrides  the environment variable
  53.               POSIXLY_CORRECT.
  54.  
  55.        -P, --portability
  56.               Use the POSIX output  format.   This  is  like  the
  57.               default  format  except  that the information about
  58.               each filesystem is always printed  on  exactly  one
  59.               line;  a  mount  device  is  never put on a line by
  60.               itself.  This means that if the mount  device  name
  61.  
  62.  
  63.  
  64. FSF                     GNU File Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DF(1L)                                                     DF(1L)
  71.  
  72.  
  73.               is  more  than 20 characters long (as for some net-
  74.               work mounts), the columns are misaligned.
  75.  
  76.        -t, --type=fstype
  77.               Limit the listing to filesystems  of  type  fstype.
  78.               Multiple  filesystem  types  can be shown by giving
  79.               multiple -t options.  By  default,  all  filesystem
  80.               types are listed.
  81.  
  82.        -x, --exclude-type=fstype
  83.               Limit  the  listing  to  filesystems  not  of  type
  84.               fstype.  Multiple filesystem types  can  be  elimi-
  85.               nated  by  giving multiple -x options.  By default,
  86.               all filesystem types are listed.
  87.  
  88.        -v     Ignored; for compatibility with System  V  versions
  89.               of df.
  90.  
  91.        --help Print a usage message and exit with a non-zero sta-
  92.               tus.
  93.  
  94.        --version
  95.               Print version information on  standard  error  then
  96.               exit.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU File Utilities                      2
  131.  
  132.  
  133.