PRIMECLUSTER Global File Services Configuration and Administration Guide 4.2 (Solaris(TM) Operating Environment)

F.1.1 df_sfcfs(1M) Reports the free disk area of GFS Shared File System

[SYNOPSIS]

df -F sfcfs [ generic_options ] [ -o specific_options ] [ directory | special ]

[DESCRIPTION]

The df displays the number of free disk blocks and the number of free i-nodes of a GFS Shared File System.

Note that the area reported as being in use and available for use is smaller than the file system area. This is because the system reserves a part of the file system and uses it for processing a file system allocation routine. The reserve area is generally 10 percent. This value can be adjusted with sfctune(1M). If all file system areas other than the reserve area is in use, only a super user can allocate data blocks for new and existing files. If such over-allocation of the file system occurs, the df display indicates that more than 100 percent of the file system is being used.

Either a special file name or a mount point name can be specified. If neither is specified, all mounted file systems are displayed.

If a file system has configured with multiple partitions with a multi-partition function, specify the path name of the representative partition as a special file name.

If a GFS Shared File System is configured with multi-partitions, information for each partition can be displayed.

For meta-data area, the following information is displayed:

• i-node use status (i-node count, free i-node count)
• Free extent status (leaf count, free leaf count)
• V-data use status (block count, free block count)

For file data area, the following information is displayed:

• Free file data area size

For update log area, the following information is displayed:

• Update log area size

[OPTIONS]

The following options can be specified:

generic_options

generic_options is supported by the general-purpose df(1M).

See the options of df(1M).

-a

Outputs information even for a file system whose /etc/mnttab entry contains an ignore option set.

-b

Outputs the capacity available for use in kilobytes.

-e

Outputs only the number of files available for use.

-g

Outputs statvfs structures.

-k

Outputs the allocation state in kilobytes.

-l

Outputs only local file systems.

-n

Outputs only the file system type.

-t

Outputs a complete list, including a total.

-V

Displays a command line, but does not execute the command.

-o specific_options

Allows options specific to GFS Shared File System to be specified. Insert a comma delimiter between options.

i

Reports the counts for i-nodes in use and free i-nodes.

v

Displays information about each partition if the file system is configured with multi-partitions.

[OPERANDS]

The following operands can be specified:

directory

Specifies path name of a directory for the GFS Shared File System.

special

Specifies path name of a block-special file for the representative partition of the GFS Shared File System.

[EXAMPLES]

The following example writes information about the file system for single-partition:

# df -F sfcfs -o v /mnt
Filesystem:/mnt
                       inodes    free   vdata   free    leaf    free    Type
/dev/sfdsk/gfs/dsk/volume1
                        14248   12192    4781   4615    7128    7127    META
                       kbytes    used    free  %used
/dev/sfdsk/gfs/dsk/volume1
                       113992   62664   51328    55%                    DATA
                       kbytes
/dev/sfdsk/gfs/dsk/volume1
                         5120                                           LOG

The following example writes information about the file system for multi-partition:

# df -F sfcfs -o v /mnt
Filesystem:/mnt
                       inodes    free   vdata   free    leaf    free    Type
/dev/sfdsk/gfs/dsk/volume1
                        29686   27630    9922   9756   14848   14846    META
                       kbytes    used    free  %used
/dev/sfdsk/gfs/dsk/volume1
                       105752   31832   73920    30%                    DATA
                       kbytes
/dev/sfdsk/gfs/dsk/volume2
                         5120                                           LOG
                       kbytes    used    free  %used
/dev/sfdsk/gfs/dsk/volume3
                       131736   30832  100904    23%                    DATA
                       inodes    free   vdata   free    leaf    free
/dev/sfdsk/gfs/dsk/volume4
                       32768    32714   32768    2819      0       0    META
                       kbytes
/dev/sfdsk/gfs/dsk/volume4
                       385020                                           FREE

[SEE ALSO]

mkfs_sfcfs(1M), sfcnewfs(1M), sfctune(1M).

df(1M), statvfs(2), mnttab(4), attributes(5) in the "Solaris X Reference Manual Collection."

[NOTE]

• df_sfcfs cannot display accurate values while a partition is added. Use sfcinfo(1M) to confirm whether the partition is being processed, then re-execute df_sfcfs following the addition of the partition.