unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



fixfdmn(8)							   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.<&lt;domain>&gt;.log and the two undo files are named undo.<&lt;domain>&gt;.<&lt;#>&gt;
      and undoidx.<&lt;domain>&gt;.<&lt;#>&gt;,	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 corr-
  uption, 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	util-
  ity 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 con-
  taining 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 corrup-
  tions	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)