df man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

df(1M)			System Administration Commands			df(1M)

NAME
       df - displays number of free disk blocks and free files

SYNOPSIS
       /usr/bin/df [-F FSType] [-abeghklntVvZ]
	    [-o FSType-specific_options]
	    [block_device | directory | file | resource ...]

       /usr/xpg4/bin/df [-F FSType] [-abeghklnPtVZ]
	    [-o FSType-specific_options]
	    [block_device | directory | file | resource ...]

DESCRIPTION
       The df utility displays the amount of disk space occupied by mounted or
       unmounted file systems, the amount of used and available space, and how
       much of the file system's total capacity has been used. The file system
       is specified by device, or by referring to a file or directory  on  the
       specified file system.

       Used  without  operands or options, df reports on all mounted file sys‐
       tems.

       df may not be supported for all FSTypes.

       If df is run on a networked mount point that the	 automounter  has  not
       yet  mounted, the file system size will be reported as zero. As soon as
       the automounter mounts the file system, the sizes will be reported cor‐
       rectly.

OPTIONS
       The   following	 options   are	supported  for	both  /usr/bin/df  and
       /usr/xpg4/bin/df:

       -a

	   Reports on  all  file  systems  including  ones  whose  entries  in
	   /etc/mnttab (see mnttab(4)) have the ignore option set.

       -b

	   Prints the total number of kilobytes free.

       -e

	   Prints only the number of files free.

       -F FSType

	   Specifies the FSType on which to operate. The -F option is intended
	   for use with unmounted file systems. The FSType should be specified
	   here	 or be determinable from /etc/vfstab (see vfstab(4)) by match‐
	   ing the directory, block_device, or resource with an entry  in  the
	   table, or by consulting /etc/default/fs. See default_fs(4).

       -g

	   Prints  the	entire	statvfs(2) structure. This option is used only
	   for mounted file systems. It can not be used with  the  -o  option.
	   This option overrides the -b, -e, -k, -n, -P, and -t options.

       -h

	   Like -k, except that sizes are in a more human readable format. The
	   output consists of one line of information for each specified  file
	   system.  This  information includes the file system name, the total
	   space allocated in the file system, the amount of  space  allocated
	   to existing files, the total amount of space available for the cre‐
	   ation of new files by unprivileged users,  and  the	percentage  of
	   normally  available	space that is currently allocated to all files
	   on the file system. All sizes are scaled to a human	readable  for‐
	   mat,	 for  example,	14K,  234M,  2.7G, or 3.0T. Scaling is done by
	   repetitively dividing by 1024.

	   This option overrides the -b, -e, -g, -k, -n, -t, and  -V  options.
	   This	 option	 only works on mounted filesystems and can not be used
	   together with -o option.

       -k

	   Prints the allocation in kbytes. The output consists of one line of
	   information	for  each  specified  file  system.  This  information
	   includes the file system name, the total  space  allocated  in  the
	   file	 system,  the amount of space allocated to existing files, the
	   total amount of space available for the creation of	new  files  by
	   unprivileged	 users, and the percentage of normally available space
	   that is currently allocated to all files on the file	 system.  This
	   option overrides the -b, -e, -n, and -t options.

       -l

	   Reports  on	local  file systems only. This option is used only for
	   mounted file systems. It can not be used with the -o option.

       -n

	   Prints only the FSType name. Invoked with no operands, this	option
	   prints  a  list  of	mounted file system types. This option is used
	   only for mounted file systems. It can  not  be  used	 with  the  -o
	   option.

       -o FSType-specific_options

	   Specifies  FSType-specific  options.	 These options are comma-sepa‐
	   rated, with no intervening spaces. See  the	manual	page  for  the
	   FSType-specific command for details.

       -t

	   Prints full listings with totals. This option overrides the -b, -e,
	   and -n options.

       -V

	   Echoes the complete set of file system specific command lines,  but
	   does	 not  execute them. The command line is generated by using the
	   options and operands provided by the user and adding to them infor‐
	   mation  derived  from /etc/mnttab, /etc/vfstab, or /etc/default/fs.
	   This option may be used to verify and validate the command line.

       -Z

	   Displays mounts in all visible zones. By default, df only  displays
	   mounts  located  within the current zone. This option has no effect
	   in a non-global zone.

   /usr/bin/df
       The following option is supported for /usr/bin/df only:

       -v

	   Like -k, except that sizes are displayed in multiples of the small‐
	   est block size supported by each specified file system.

	   The	output	consists of one line of information for each file sys‐
	   tem. This one line of information includes the following:

	       o      the file system's mount point

	       o      the file system's name

	       o      the total number of blocks allocated to the file system

	       o      the number of blocks allocated to existing files

	       o      the number of blocks available for the creation  of  new
		      files by unprivileged users

	       o      the percentage of blocks in use by files

   /usr/xpg4/bin/df
       The following option is supported for /usr/xpg4/bin/df only:

       -P

	   Same as -h except in 512-byte units.

OPERANDS
       The  df	utility	 interprets operands according to the following prece‐
       dence: block_device, directory, file, resource. The following  operands
       are supported:

       block_device

	   Represents a block special device (for example, /dev/dsk/c1d0s7).

       directory

	   Represents  a  valid	 directory name. df reports on the file system
	   that contains directory.

       file

	   Represents a valid file name. df reports on the  file  system  that
	   contains file.

       resource

	   Represents an NFS resource name.

USAGE
       See largefile(5) for the description of the behavior of df when encoun‐
       tering files greater than or equal to 2 Gbyte ( 2^31 bytes).

EXAMPLES
       Example 1 Executing the df command

       The following example shows the df command and its output:

	 example% /usr/bin/df

	 /		    (/dev/dsk/c0t0d0s0 ):  287530 blocks    92028 files
	 /system/contract   (ctfs	       ):	0 blocks 2147483572 files
	 /system/object	    (objfs	       ):	0 blocks 2147483511 files
	 /usr		    (/dev/dsk/c0t0d0s6 ): 1020214 blocks   268550 files
	 /proc		    (/proc	       ):	0 blocks      878 files
	 /dev/fd	    (fd		       ):	0 blocks	0 files
	 /etc/mnttab	    (mnttab	       ):	0 blocks	0 files
	 /var/run	    (swap	       ):  396016 blocks     9375 files
	 /tmp		    (swap	       ):  396016 blocks     9375 files
	 /opt		    (/dev/dsk/c0t0d0s5 ):  381552 blocks    96649 files
	 /export/home	    (/dev/dsk/c0t0d0s7 ):  434364 blocks   108220 files

       where the columns represent the mount point, device  (or	 "filesystem",
       according  to  df  -k),	free blocks, and free files, respectively. For
       contract file systems, /system/contract is the mount point, ctfs is the
       contract	  file	 system	  (used	  by  SMF)  with  0  free  blocks  and
       2147483582(INTMAX-1)  free  files.  For	object	file  systems,	 /sys‐
       tem/object  is  the  mount  point, objfs is the object file system (see
       objfs(7FS)) with 0 free blocks and 2147483511 free files.

       Example 2 Writing Portable Information About the /usr File System

       The following example writes portable information about the  /usr  file
       system:

	 example% /usr/xpg4/bin/df -P /usr

       Example 3 Writing Portable Information About the /usr/src file System

       Assuming	 that  /usr/src is part of the /usr file system, the following
       example writes portable information :

	 example% /usr/xpg4/bin/df -P /usr/src

       Example 4 Using df to Display Inode Usage

       The following example displays inode usage on all ufs file systems:

	 example%/usr/bin/df -F ufs -o i

ENVIRONMENT VARIABLES
       SYSV3

	   This variable is used to override the default behavior  of  df  and
	   provide  compatibility  with	 INTERACTIVE  UNIX System and SCO UNIX
	   installation scripts. As the SYSV3 variable is provided for compat‐
	   ibility purposes only, it should not be used in new scripts.

       When  set,  any header which normally displays "files" will now display
       "nodes". See environ(5) for descriptions of the	following  environment
       variables  that	affect	the  execution	of df: LANG, LC_ALL, LC_CTYPE,
       LC_MESSAGES, and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0

	   Successful completion.

       >0

	   An error occurred.

FILES
       /dev/dsk/*

	   Disk devices

       /etc/default/fs

	   Default local file system type. Default values can be set  for  the
	   following  flags  in /etc/default/fs. For example: LOCAL=ufs, where
	   LOCAL is the default partition for a command if no FSType is speci‐
	   fied.

       /etc/mnttab

	   Mount table

       /etc/vfstab

	   List of default parameters for each file system

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

   /usr/bin/df
       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWcs			   │
       └─────────────────────────────┴─────────────────────────────┘

   /usr/xpg4/bin/df
       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWxcu4			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Committed			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Standard		     │See standards(5).		   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       find(1),	 df_ufs(1M),  mount(1M), statvfs(2), default_fs(4), mnttab(4),
       vfstab(4),  attributes(5),  environ(5),	 largefile(5),	 standards(5),
       objfs(7FS)

NOTES
       If UFS logging is enabled on a file system, the disk space used for the
       log is reflected in the df report.  The	log  is	 allocated  from  free
       blocks  on the file system, and it is sized approximately 1 Mbyte per 1
       Gbyte of file system, up to 256 Mbytes. The log size may be larger  (up
       to  a maximum of 512 Mbytes) depending on the number of cylinder groups
       present in the file system.

SunOS 5.10			  30 Nov 2009				df(1M)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net