 |
Index for
Section 8 |
|
 |
Alphabetical
listing for F |
|
 |
Bottom of
page |
|
fixfdmn(8)
NAME
fixfdmn - Checks and repairs corrupted AdvFS domains
SYNOPSIS
/sbin/advfs/fixfdmn [-m type[,type]...] [-d directory] [-v number] [-a [-c]
| -n] [-s {y | n}] [domain] [fileset]
/sbin/advfs/fixfdmn -u directory domain
OPTIONS
-a Specifies that after repairing what it can, fixfdmn attempts to
activate the domain at the end of the run. This option cannot be used
with the -n option.
-c Removes any clone filesets. This option is only valid if used with the
-a option.
-d directory
Specifies a directory to which the message log and undo files will be
written. If the -d option is not used, the message log and undo files
are put in the current working directory. The message log file is named
fixfdmn.<domain>.log and the two undo files are named undo.<domain>.<#>
and undoidx.<domain>.<#>, where # causes a number to be appended to a
filename to make it unique. The numbers are rotated sequentially from 0
(zero) through 9 if multiple undo files are created for the same
domain. The undo file will have the same ending number as its
corresponding undo index file.
-m type[,type...]
Specifies a list of types of metadata to be checked and repaired. The
valid types are log, sbm, sync, bmt, frag, quota and files. If you
specify the fileset parameter, then sync, log, sbm, and bmt are made
invalid types for the -m option. If you do not specify -m, the default
is to check all types.
sync
Corrects the AdvFS magic number and synchronizes data across
volumes (for example, volume numbers, mount ids, mount states,
domain ids, and so on.)
log Resets the transaction log so it is not processed.
sbm Synchronizes the SBM to the information in the BMT.
bmt Corrects the BMT.
frag
Corrects frag file groups and free lists and ensures that all file
frags reside in the frag file.
quota
Checks and corrects sizes of quota files.
files
Verifies that directory metadata is correct.
-n Specifies that fixfdmn will check the domain and not do any repairs. It
will report what problems were found and how it would have fixed them.
-s {y | n}
Specifies that "yes" or "no" should be answered to prompts when run
from a script.
-u directory
Restores the domain to its previous state by undoing the effects of the
last run of fixfdmn, using the most recent undo files in the specified
directory.
-v number
Specifies the verbose mode level which controls the messages printed to
stdout.
0 = Only error messages
1 = ( Default) Progress, errors and summary messages
2 = Progress messages, detailed error messages, fix information and
summary messages
OPERANDS
domain
The name of a corrupted domain to repair.
fileset
The name of the fileset to repair if only one fileset in this domain
exhibits errors.
DESCRIPTION
This is the first release of the fixfdmn utility. It is recommended that
you first run the utility with the -n option to check for errors without
repairing the domain. Create a backup of the filesets in your domain before
you run the fixfdmn utility with repair.
The fixfdmn utility checks and repairs corrupt AdvFS domains and filesets.
Only on-disk metadata will be repaired, as there is currently no way to
check or repair the contents of user files. Only those problems that
prevent mounting the domain, or that would result in a domain or system
panic, are repaired.
The fixfdmn utility is primarily concerned with fixing problems that have a
limited scope. When a large portion of the domain is corrupted, there is
very little fixfdmn can do, so it will recommend restoring data from backup
or running the salvage(8) command.
After major areas of metadata are checked, and if a corruption was fixed,
fixfdmn prompts the user to determine if they want to continue looking for
additional corruption.
If fixfdmn detects an error in a clone fileset, the clone is marked out of
sync and should not be used. If the fixfdmn utility fixes corruptions in a
fileset, it is possible that some free slots in the frag file of that
clone's original fileset will not be listed as free. While this is a
corruption, the only negative consequence is wasted diskspace. A second run
of fixfdmn will clean this up.
If fixfdmn cannot recover the metadata for a specific file, the file may be
truncated, moved, or deleted depending on the situation. The fixfdmn
utility will attempt to save as much of a file as possible.
Every page fixfdmn changes is saved to an undo file. If you do not like
the results of running fixfdmn, undo the changes by running fixfdmn again
with the -u option. If the file system containing the undo files runs out
of space during the fixfdmn run, you are prompted on how to proceed. You
can continue without the undo files by adding more space to the domain
containing the undo files, or you can ask the utility to exit.
Use the -m type option when you have information from a system/domain panic
or output from the verify command or other tools which indicate where the
corruption may be. This option limits the scope of what is checked and
repaired.
NOTES
The fixfdmn command will always clear the transaction log, even on a non-
corrupt domain, unless the -n option is specified
There must be a domain entry for this domain in the /etc/fdmns directory.
The fixfdmn command opens the block devices specified for the volumes in
the /etc/fdmns directory.
If you need to repair the root domain, you must boot from CD-ROM and create
the entry for the root domain under /etc/fdmns.
RESTRICTIONS
You must be root user to run fixfdmn.
All filesets must be unmounted.
Although fixfdmn may report success, it does not guarantee that all
corruptions have been eliminated.
If a domain is mounted and written to after being repaired by fixfdmn,
using the fixfdmn utility with the -u option will likely cause corruptions.
EXIT STATUS
0 (Zero)
Success.
1 Corrupt
Unable to repair all found corruptions
2 Failure
Program or system error
FILES
/etc/fdmns
Contains AdvFS domain directories and locks.
SEE ALSO
Commands: salvage(8), umount(8), verify(8), vrestore(8)
|
Index for
Section 8 |
|
|
Alphabetical
listing for F |
|
 |
Top of
page |
|