DF(1)               RISC/os Reference Manual                DF(1)



NAME
     df - report number of free disk blocks and files (generic)

SYNOPSIS
     df [-F FSType] [-begklntV] [current_options] [-o
     specific_options] [directory | special | resource...]

DESCRIPTION
     df prints the allocation portions of the generic superblock
     for mounted or unmounted file systems, directories or
     mounted resources.  directory represents a valid directory
     name.  If directory is specified df reports on the device
     that contains the directory.  special represents a special
     device (e.g., /dev/dsk/c1d0s8).  resource is an RFS/NFS
     resource name.  If arguments to df are pathnames, df pro-
     duces a report on the file system containing the named file.

     current_options are options supported by the s5-specific
     module of df.  Other FSTypes do not necessarily support
     these options.  specific_options indicate suboptions speci-
     fied in a comma-separated list of suboptions and/or
     keyword-attribute pairs for interpretation by the FSType-
     specific module of the command.

     The options are:

     -F   Specify the FSType on which to operate.  This is only
          needed if the file system is unmounted.  The FSType
          should be specified here or be determinable from
          /etc/vfstab by matching the mount_point, special, or
          resource with an entry in the table.

     -b   Print only the number of kilobytes free.

     -e   Print only the number of files free.

     -g   Print the entire statvfs structure.  Used only for
          mounted file systems.  Can not be used with
          current_options or with the -o option.  This option
          will override the -b, -e, -k, -n, and -t options.

     -k   Print allocation in kilobytes. This option should be
          invoked by itself because its output format is dif-
          ferent from that of the other options.

     -l   Report on local file systems only.  Used only for
          mounted file systems.  Can not be used with
          current_options or with the -o option.

     -n   Print only the FSType name.  Invoked with no arguments
          this option prints a list of mounted file system types.
          Used only for mounted file systems.  Can not be used



                        Printed 11/19/92                   Page 1

DF(1)               RISC/os Reference Manual                DF(1)



          with current_options or with the -o option.

     -t   Print full listings with totals.  This option will
          override the -b, -e, and -n options.

     -V   Echo the complete command line, but do not execute the
          command.  The command line is generated by using the
          options and arguments provided by the user and adding
          to them information derived from /etc/mnttab or
          /etc/vfstab.  This option should be used to verify and
          validate the command line.

     -o   Specify FSType-specific options.

     If no arguments or options are specified, the free space on
     all local and remotely mounted file systems is printed.

NOTES
     The -F option is intended for use with unmounted file sys-
     tems.

     This command may not be supported for all FSTypes.

FILES
     /dev/dsk/*
     /etc/mnttab    mount table
     /etc/vfstab    list of default parameters for each file sys-
     tem

SEE ALSO
     mount(1M), mnttab(4), vfstab(4).
     statvfs(2) in the Programmer's Reference Manual.
     Manual pages for the FSType-specific modules of df.






















 Page 2                 Printed 11/19/92