'\"macro stdmacro
.if n .pH g1a.df @(#)df	41.1 of 12/12/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} df 1M "" "\&"
.if \nX=1 .ds x} df 1M ""
.if \nX=2 .ds x} df 1M "" "\&"
.if \nX=3 .ds x} df  "" "" "\&"
.TH \*(x}
.SH NAME
\f4df\f1 (generic) \- report number of free disk blocks and files 
.SH SYNOPSIS
\f4df \f1[\|\f4\-F \f2FSType\f1] [\|\f4\-begklntV\f1]
[\f2current_options\f1]
[\|\f4\-o \f2specific_options\f1]
\f1[\f2directory | special | resource...\f1]
.SH DESCRIPTION
\f4df\fP prints the
allocation portions of the generic superblock
for mounted or unmounted file systems, 
directories or mounted resources.
\f2directory\f1 represents a valid directory name.
If \f2directory\f1 is 
specified \f4df\f1 reports on
the device that contains the \f2directory\f1.
\f2special\f1 represents a special device (e.g., \f4/dev/dsk/c1d0s8\f1).
\f2resource\f1 is an RFS/NFS resource name.
If arguments to \f4df\fP are pathnames,
\f4df\fP produces a report on the file system containing the named file.
.PP
.PP
\f2current_options\f1
are options supported by the \f4s5\f1-specific module of \f4df\f1.
Other FSTypes do not necessarily support these options.
\f2specific_options\f1 indicate suboptions specified in a comma-separated 
list of suboptions and/or keyword-attribute pairs for interpretation by 
the \f2FSType\f1-specific module of the command. 
.PP
The options are:
.TP 10 
\f4\-F\f1
Specify the \f2FSType\f1 on which to operate.
This is only needed if the file system is unmounted.
The \f2FSType\f1 should be specified here
or be determinable from \f4/etc/vfstab\f1
by matching the \f2mount_point\f1, \f2special\f1,
or \f2resource\f1 with an entry in the table.
.TP 10 
\f4\-b\f1
Print only the number of kilobytes free.
.TP 10 
\f4\-e\f1
Print only the number of files free.
.TP 10 
\f4\-g\f1
Print the entire \f4statvfs\f1 structure.
Used only for mounted file systems.
Can not be used with \f2current_options\fP
or with the \f4-o\fP option.
This option will override the \f4-b\fP,
\f4-e\fP, \f4-k\fP, \f4-n\fP, and \f4-t\fP options.
.TP 10 
\f4\-k\f1
Print allocation in kilobytes. This option should be invoked by itself
because its output format is different from that of the other options.
.TP 10 
\f4\-l\f1
Report on local file systems only.
Used only for mounted file systems.
Can not be used with \f2current_options\fP
or with the \f4-o\fP option.
.TP 10 
\f4\-n\f1
Print only the \f2FSType\f1 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 with \f2current_options\fP
or with the \f4-o\fP option.
.TP 10 
\f4\-t\f1
Print full listings with totals.
This option will override the \f4-b\fP,
\f4-e\fP, and \f4-n\fP options.
.TP 10 
\f4\-V\f1
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 \f4/etc/mnttab\f1 or \f4/etc/vfstab\f1.
This option should be used to
verify and validate the command line.
.TP 10 
\f4\-o\f1
Specify FSType-specific options.
.PP
If no arguments or options are specified, the free space on 
all local and remotely mounted file systems is printed.
.SH NOTES
The \f4\-F\f1 option is intended for use with unmounted file systems. 
.P
This command may not be supported for all FSTypes.
.SH FILES
\f4/dev/dsk/\(**\f1
.br
\f4/etc/mnttab\f1	mount table
.br
\f4/etc/vfstab\f1	list of default parameters for each file system
.SH SEE ALSO
\f4mount\f1(1M), \f4mnttab\f1(4), \f4vfstab\f1(4).
.br
\f4statvfs\f1(2) in the \f2Programmer's Reference Manual\f1.
.br
Manual pages for the FSType-specific modules of \f4df\f1.
