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

4.1 Commands for GFS Local File System Management

For each file system, there are two different types of management commands, namely, the general purpose management commands and the system specific management commands. The general purpose management commands that provided by Solaris OE are used for basic functions and the system specific commands are called by specifying options or file system types.

The GFS Local File System features an exclusive management commands that act as the general purpose management command and the system specific management command for the GFS Local File System's original functions.

Specify "sfxfs" for -F option as a file system type when using the general purpose management command to a GFS local file system. If you omit the -F option, a search is made of those entries matched with "special" or "mount_point" in "/etc/vfstab," after which the registered file system types are automatically selected.

[General-purpose file system management commands]

Command	Description
clri(1M)	Clears the i-node.
df(1M)	Displays the number of free disk blocks, number of files, etc.
ff(1M)	Displays file names and statistical information.
fsck(1M)	Checks a file system for consistency and repairs it.
fstyp(1M)	Determines the file system type.
mkfs(1M)	Creates a file system.
mount(1M)	Mounts the GFS Local File System.
ncheck(1M)	Lists file names and i-node numbers.
umount(1M)	Unmounts the GFS Local File System.

For details of the general-purpose management commands, see each command's page of "Solaris X Reference Manual."

[GFS Local File System management commands]

Command	Description
clri_sfxfs(1M)	Clears the i-node.
df_sfxfs(1M)	Displays the number of free disk blocks, number of files, etc.
ff_sfxfs(1M)	Displays file names and statistical information.
fsck_sfxfs(1M)	Checks a file system for consistency and repairs it.
fstyp_sfxfs(1M)	Determines the file system type.
mkfs_sfxfs(1M)	Creates a file system.
mount_sfxfs(1M)	Mounts the GFS Local File System.
ncheck_sfxfs(1M)	Lists file names and i-node numbers.

[GFS Local File System specific management commands]

Command	Description
sfxadd(1M)	Extends the GFS Local File System.
sfxadm(1M)	Changes GFS Local File System partition information settings.
sfxddr(1M)	Restores backup data and check device restoring.
sfxdefrag(1M)	Defragments the GFS Local File System.
sfxdump(1M)	Dumps a GFS Local File System.
sfxedquota(1M)	Edits user quotas for the GFS Local File System.
sfxinfo(1M)	Displays GFS Local File System partition information.
sfxmkbkup(1M)	Creates a shell script for backing up
sfxmkrstr(1M)	Creates a shell script for restoring
sfxnewfs(1M)	Builds the GFS Local File System. (Front-end command of mkfs_sfxfs(1M))
sfxnode(1M)	Adds or changes GFS Local File System node configuration information.
sfxquota(1M)	Displays a user's GFS Local File System disk quota and usage.
sfxquotadm(1M)	Manages quotas file for the GFS Local File System.
sfxquotaoff(1M)	Turns GFS Local File System quotas on.
sfxquotaon(1M)	Turns GFS Local File System quotas off.
sfxrepquota(1M)	Summarizes quotas for the GFS Local File System.
sfxrestore(1M)	Restores from the dump created with sfxdump.
sfxstat(1M)	Reports statistical information on the GFS Local File System.
sfxtune(1M)	Tunes up the GFS Local File System.

When the GFS Local File System is created, an entry is added to /etc/sfxfstab, which is used for file system management. If, for some reason, /etc/sfxfstab or the file entry is deleted, it must be restored from the backup file (/etc/.sfxfstab.back). Restore the deleted file according to the following procedure.

# cp -p /etc/.sfxfstab.back /etc/sfxfstab

If there is no backup file present, /etc/sfxfstab must be created. Create a new /etc/sfxfstab according to the following procedure.

# touch /etc/sfxfstab

# chmod 644 /etc/sfxfstab

Original commands for general users of the GFS Local File System original functions are listed below.

[GFS Local File System management commands]

Command	Description
sfxcp(1)	Copies files with extent attribute information.
sfxcpio(1)	Extracts or restores files from an archive with extent attribute information.
sfxgetext(1)	Displays extent attribute information.
sfxmv(1)	Moves files with extent attribute information.
sfxsetext(1)	Specifies extent attribute information.

Commands of GFS Local File System are classified as follows:

[ used in mounted file system ]

sfxedquota, sfxquota, sfxquotadm, sfxquotaoff, sfxquotaon, sfxrepquota, sfxrestore, sfxstat, umount
sfxcp, sfxcpio, sfxgetext, sfxmv, sfxsetext

[ used in unmounted file system ]

clri, fsck, mkfs(except -m), sfxadm(except -A), sfxddr, sfxnewfs, sfxnode, sfxtune

[ used in both mounted and unmounted file system ]

df, ff, fstyp, mkfs -m, mount, ncheck, sfxadd, sfxadm -A, sfxdefrag, sfxdump(*1), sfxinfo, sfxmkbkup, sfxmkrstr

(*1: While the sfxdump(1M) is used in mounted file system, the file system information must be not updated. For details on sfxdump(1M), see Appendix B.2.5, "sfxdump(1M)".)