NAME
SHOWFS - Displays disk space statistics and file system
stripe attributes.
SYNTAX
showfs [-k] [-t type] [filesystem | directory]
ARGUMENTS
-k Causes numbers to be reported in kilobytes. By
default, all numbers are reported in 512-byte
blocks.
-t type Displays statistics for the specified file system
type only. The available file system types include
the following:
pfs Parallel File System (PFS)
nfs Network File System (NFS)
ufs UNIX File System (UFS) (Berkeley
fast file system)
If the -t switch is specified and a filesystem or
directory is specified, the -t specification is
ignored.
file_system
Pathname of a mounted file system.
directory
Pathname of a directory.
DESCRIPTION
The showfs command displays statistics on the amount of free
disk space in a file system and the stripe attributes of a
Parallel File System (PFS). If neither a file system or a
directory is specified, statistics for all mounted file sys-
tems are displayed. The showfs command displays the follow-
ing information about the specified file systems:
Mounted on
File system's mount point: the directory on which
the file system is mounted. To obtain the file
system's device name, use the OSF/1 mount or df
command.
512-blks Total capacity of the file system, in 512-byte
disk blocks, by default. The -k option can be used
to display this in 1K byte blocks.
avail Number of disk blocks currently available, in
512-byte disk blocks by default. The -k option can
be used to display this in 1K-byte blocks.
capacity Approximate percentage of the file system's capa-
city currently in use.
The showfs command displays the following additional infor-
mation for each PFS file system:
sunit File system's stripe unit size, in bytes. The unit
of data interleaving in a PFS file.
sfactor File system's stripe factor. The sfactor multi-
plied by the sunit equals the size of one PFS file
stripe.
sdirs Description of the file system's stripe group. The
stripe group is a list of directories in UFS (typ-
ically UFS mount points) or NFS file systems that
define the storage locations for the PFS file sys-
tem.
The stripe attributes of individual PFS files can be
displayed by using the ls -P command. See the ls(1) manual
page for more information.
EXAMPLES
The following examples displays files system information for
a PFS file system:
% showfs -t pfs
Mounted on 512-blks avail capacity sunit sfactor
/pfs 4128988 3689124 1% 65536 4
sdirs: /home/.sdirs/vol0
/home/.sdirs/vol1
/home/.sdirs/vol2
/home/.sdirs/vol3
This examples show a PFS file system with four stripe direc-
tories, a stripe unit size of 64K bytes, and a stripe factor
of four.
LIMITATIONS AND WORKAROUNDS
For information about limitations and workarounds, see the
release notes files in /usr/share/release_notes.
SEE ALSO
df, fstab(), getpfsinfo(), pfstab, statpfs()
OSF/1 Command Reference: df(1), ls(1)
OSF/1 Programmer's Reference: fcntl(2), getmntinfo(3),
mount(2), statfs(2)
OSF/1 System and Network Administrator's Reference:
mount(8), quot(8)
Acknowledgement and Disclaimer