samfsck - Checks and repairs a Sun QFS or SAM-QFS file sys-
samfsck [ -s scratch_dir ] [ -F [ -R ] ] [ -G ] [ -S ] [ -U
] [ -u fs_version ] [ -V ] [ -p ] [ -A ] fs_name
The samfsck command checks and optionally repairs a Sun QFS
or SAM-QFS file system from the disk partitions that belong
to fs_name. For fs_name, specify either a family set name
from the mcf file or a mount point absolute path name from
the /etc/vfstab file. One or more disk partitions are
specified in the mcf file. If no options are specified,
samfsck checks and reports, but does not repair, all the
blocks that belong to inodes and lists inodes which have
duplicate blocks. samfsck also checks inodes which have
blocks that are free blocks. If only one inode is listed in
the duplicate list, that inode contains a block that is also
free. To repair the file system, the file system must be
unmounted, and the -F option specified.
If there are files encountered that are not attached to a
parent directory, they will be moved to the
/mount_point/lost+found directory. If this directory does
not exist, you must create this directory first and make it
sufficently large to hold the expected number of discon-
nected files if you wish this to happen. Here is how to do
this in the Bourne shell for a SAM file system mounted on
while [ $N -lt 1024 ]; do
N=`expr $N + 1`
Specifies the scratch directory. If specified, this
directory is used for the scratch files that are used.
The default scratch directory is /tmp.
-F Check and repair the file system. For all inodes that
have duplicate blocks, mark those inodes offline if
they have been archived. If the file system is not
unmounted samfsck will exit with an error.
-G Generate directory entry hash. In SAM-FS 3.5.0 and
above, a hash code was added to directory entries to
speed up directory searches. This is particularly use-
ful for longer file names. The -G option, when used in
conjunction with the -F option, will modify directory
entries which do not have a proper hash value to have a
hash. When the -G option is used without the -F option,
the number of directory entries which could be hashed
is reported. The presence of a hash value has no
effect on versions of SAM-FS prior to 3.5.0.
-S Convert the filesystem from a non-shared filesystem to
a shared filesystem. This option is not available to
filesystems with a version 1 superblock. The -F option
must also be specified to convert a filesystem. This
will cause samfsck to update the on-disk structures to
make the filesystem shared. Note that samfsck does not
update the /etc/vfstab entry (see vfstab(4)), the mcf
entry (see mcf(4)), or the shared hosts file (see
samsharefs(1M)) for the filesystem, nor does it config-
ure the services file (see services(4)) for shared SAM
operations. These must be configured and updated
before the filesystem is converted.
-U Convert the filesystem from a shared filesystem to a
non-shared filesystem. The -F option must also be
specified to convert a filesystem. The on-disk struc-
tures of the filesystem are updated to make the
filesystem non-shared. Note that samfsck does not
update the /etc/vfstab entry (see vfstab(4)), or the
mcf entry (see mcf(4)). These must be configured and
updated before the filesystem is converted.
Convert the filesystem to the given fs_version. The
only value that is valid for 5.0 is 2A. Only Filesys-
tems version 2 can be converted to 2A. Filesystems
version 2A can use 5.0 features like Online add/remove,
Large Host Table and Project IDs. Note that 2A
filesystems are only mountable on 5.0 and not backwards
compatible. The -F option must also be specified to
convert a filesystem. The on-disk structures of the
filesystem are updated to make the filesystem version
2A. Note that version 2A filesystems are not backward
compatible or reversible.
-V Turns on a verbose display of DEBUG information. This
information is useful to Oracle analysts.
-R Rename the file system. When specified along with the
-F option, the -R option will rewrite the super block
with the disk cache family set name found in
/etc/opt/SUNWsamfs/mcf. No action will be taken if the
-R option is used without the -F option. It is impor-
tant that sam-fsd be notified after any change to
/etc/opt/SUNWsamfs/mcf (see samd(1M)).
-p Return an indication of the filesystem's health. Non-
zero return indicates that the filesystem should not be
mounted without first using samfsck to check and repair
the filesystem (see EXIT STATUS). A zero return value
indicates that the filesystem can be mounted immedi-
-A Convert the POSIX exteneded ACL to the NFSV4 extended
ACL. This operation is not reversible, and only
applies to file system versions V2 or V2A. The -F
option must also be specified to convert a filesystem.
NOTE: This option is only available for Solaris release
after Solaris 10.
The following exit values are returned:
0 The filesystem is consistent.
4 Nonfatal: Filesystem block counts need to be
5 Nonfatal: Filesystem blocks can be reclaimed.
10 Nonfatal: Orphan inodes can be moved to
20 Fatal: invalid directory blocks exist, overlapping
blocks mapped to 2 inodes exist. Files/directories
will be marked offline if an archive copy exists
or damaged if no archive copy exists.
30 Fatal: I/O Errors occurred, but samfsck kept pro-
cessing. Filesystem is not consistent.
35 Fatal: Argument errors terminated samfsck.
36 Fatal: Malloc errors terminated samfsck.
37 Fatal: Device errors terminated samfsck.
40 Fatal: Filesystem superblock is invalid.
41 Fatal: Filesystem option mask has non-backwards
45 Fatal: Filesystem .inodes file is invalid.
50 Fatal: I/O Errors terminated samfsck.
55 Nonfatal: The -p option was specified, and the
filesystem should be checked and repaired prior to
The configuration file for samfs
/etc/vfstab File system defaults table
mcf(4), services(4), vfstab(4).