unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



verify(8)							    verify(8)



NAME

  verify - Checks the AdvFS on-disk metadata structures

SYNOPSIS

  /sbin/advfs/verify [-l  | -d]	[-v  | -q] [-t]	[-a  | -f] [-F]	[-D]
  domain_name

OPTIONS

  -a  Checks an	active domain. All filesets in the domain must be mounted.

  -d  Deletes lost files (that is, files with no directory entry).

  -D  Checks a domain that has been previously mounted with the	-o dual
      option of	the mount command.

  -f  Attempts to fix some corruptions found in	the domain; deletes any
      directory	entries	that do	not have associated files; deletes files that
      have storage bitmap or extent map	problems; corrects some	inconsisten-
      cies in a	storage	bitmap.

  -F  Use this option with caution only	when the domain's fileset(s) will not
      mount and	running	verify without the -F option exits with	the message
      "verify: can't get set info for domain".

      When the -F option is used, AdvFS	reinitializes the domain transaction
      log without recovery. As a result, no domain recovery will occur for
      previously incomplete operations (which can cause	data corruption).

  -l  Creates a	hard link to a lost file in the	/<&lt;mountpoint>&gt;/lost+found
      directory.

  -q  Prints minimal file status information.

  -t  Displays the mcell totals.

  -v  Prints file status information.  Selecting this option slows down	the
      verify procedure and creates a large volume of output information.

OPERANDS

  domain_name
      Specifies	the file domain.









DESCRIPTION

  The verify command mounts all	the filesets in	a domain at temporary mount
  points to process them and unmounts them when	finished. If you have chosen
  the -a option, existing mount	points will be retained.

  The command checks on-disk structures	such as	the bitfile metadata table
  (BMT), the storage bitmaps, the tag directory, and the frag file for each
  fileset. It verifies that the	directory structure is correct and that	all
  directory entries reference a	valid file (tag) and that all files (tags)
  have a directory entry.

  The verify command checks the	storage	bitmap for double allocations and
  missing storage. It checks that all mcells in	use belong to a	bitfile	and
  that all bitfiles have all of	their mcells.

  The verify command checks the	consistency of free lists for mcells and tag
  directories. It checks that the mcells pointed to by tags in the tag direc-
  tory match the corresponding mcells.

  For each fileset in the specified file domain, the verify command checks
  the frag file	headers	for consistency. For each file that has	a fragment,
  the frag file	is checked to ensure that the frag is marked as	in use.

RESTRICTIONS

  You must be the root user to use this	command.

  If you want to run the verify	command	on the root file domain, choose	the
  -a option to view diagnostic warnings, or boot from another disk or instal-
  lation CD and	use the	-f or -d option	as shown in the	Example	section.

  It is	recommended that you run the verify command with the -f	option and
  unmount all filesets in the file domain.  This option	attempts to repair
  certain types	of metadata inconsistencies and	allows the most	complete
  recovery.

  If you choose	the -a option, not all verification tests will be run and no
  fixes	will be	made. In addition, if file system activity is occurring, the
  verify command may report erroneous diagnostic warnings. This	is because
  the utility cross-checks metadata files and, if these	are changing, incon-
  sistencies may appear	that do	not actually exist.  Therefore,	if you choose
  the -a option, it is a good idea to run in single-user mode, if possible,
  and to restrict system activity.

  If you run the verify	command	on a fileset that has any other	file system
  (AdvFS or otherwise) mounted on it, an error may result.  If you have	a
  fileset erroneously labeled as UFS and it overlaps a fileset labeled AdvFS,
  an error results.  You can recover from this error by	changing the
  erroneously-labeled fileset's	fstype field from ufs to unused	with the
  disklabel -s command.	 After changing	the disk label,	run the	verify com-
  mand.

  If the -F option is specified, the verify command mounts the fileset using
  the mount command with the -d	option.	Because	no recovery is performed,
  your file domain may become inconsistent.

  Choose the -D	option to run the verify command if the	file domain has	ever
  been dual mounted. Running the verify	command	without	the -D option on a
  domain that has been dual mounted will report	setID conflicts	for frag
  files. Running the verify command with the -D	option will skip the frag
  file setID checks.




EXIT STATUS

  The verify utility returns a 0 (zero)	on success if it did not find any
  corruption and a positive integer on success if it did find corruption.
  The verify utility returns a -1 on failure.

EXAMPLES

  The following	example	verifies the file domain dmnx with the filesets	setx
  and sety:

       # /sbin/advfs/verify dmnx

       +++ Domain verification +++

       Domain Id 2f9eb70a.000f1db0

       Checking	disks ...

       Checking	storage	allocated on disk /dev/disk/dsk10g

       Checking	storage	allocated on disk /dev/disk/dsk10a

       Checking	mcell list ...

       Checking	mcell position field ...

       Checking	tag directories	...

       +++ Fileset verification	+++

       +++ Fileset setx	+++

       Checking	frag file headers ...

       Checking	frag file type lists ...

       Scanning	directories and	files ...
	    300
       Scanned 307 directories.

       Scanning	tags ...
	    1100
       Scanned a total of 1135 tags.

       Searching for lost files	...
	    1100
       Searched	1135 tags, no lost files found.

       +++ Fileset sety	+++

       Checking	frag file headers ...

       Checking	frag file type lists ...

       Scanning	directories and	files ...
	    900
       Scanned 911 directories.

       Scanning	tags ...
	    5100
       Scanned a total of 5173 tags.

       Searching for lost files	...
	    5100
       Searched	5173 tags, no lost files found.
       #

  To run the verify command with either	the -f or -d options on	a root
  domain, you must boot	off another disk or CD-ROM as follows:

   1.  Boot from your installation CD then exit	the installation to the	UNIX
       shell or	boot from another system disk.

   2.  Change to the /etc/fdmns	directory:

       # cd /etc/fdmns

   3.  Create a	temporary domain directory:

       # mkdir verify_root

   4.  Change to the newly created directory:

       # cd verify_root

   5.  Create a	symbolic link in this directory	to the disk partition that
       contains	the domain you wish to run the verify command on:

       # ln -s /dev/disk/dsk3a dsk3a

   6.  Change back to the root directory (/):

       # cd /

   7.  Run the verify command on the temporary domain:

       # /sbin/advfs/verify -f verify_root

   8.  Delete the temporary domain

       # rm -rf	/etc/fdmns/verify_root

FILES

  /sbin/advfs/verify

SEE ALSO

  Commands: fsck(8), mount(8)

  Files: advfs(4)