vfile(8)						      System Manager's Manual							  vfile(8)

NAME

       vfile - saves the contents of a reserved file from an unmounted domain.

SYNOPSIS

       /sbin/advfs/vfile BMT_page cell special

OPERANDS

       Specifies  the  page  within  the bitfile metadata table (BMT) of the volume that contains the file's mcell.  Specifies the cell of the BMT
       page that contains the file's mcell.  Specifies the volume on which the file's primary mcell is located.

DESCRIPTION

       The vfile utility outputs the contents of a reserved file from an unmounted domain. The file is identified by the location of  its  primary
       mcell.  Each  mcell  location  is composed of three parts: volume, page within the BMT file located on that volume, and cell within the BMT
       page.

       The primary mcell for the root tag directory is found in the BMT of the volume containing the log. To find this volume for  a  domain,  use
       the showfdmn or the advscan command. The volume marked "L" contains the log.

       This  utility  may  be  run for file domains prior to Version 5.0 or for Version 5 file domains specifically designated as having the older
       file format.  (File domain structure has changed in Version 5. Earlier file domains carry a domain version number (DVN) of 3 while  Version
       5.0 and later file domains have a DVN of 4.) Use the showfdmn command to obtain the correct version number of your system. For DVN of 4 and
       greater, use the nvbmtpg --d commmand to obtain file contents from unmounted domains.

       Certain metadata files are in fixed locations:

       ---------------------------------------------------------
				Page   Cell   Volume
       ---------------------------------------------------------
       Bitfile metadata table	0      0      every	volume,
					      version 3 domains
				0      4      every	volume,
					      version 4 domains
       Storage bitmap		0      1      every volume
       Root tag directory	0      2      volume with log
       Transaction log file	0      3      volume with log
       ---------------------------------------------------------

RESTRICTIONS

       You must be the root user to use this command.

       This utility may be used on DVN of 3 domains only.

EXAMPLES

       The following command will extract the contents of the transaction log from the device /dev/rdisk/dsk23h and place it in a new file  called
       log.  # vfile 0 3 /dev/rdisk/dsk23h > log

SEE ALSO

       Commands: advscan(8)

       Files: advfs(4)

																	  vfile(8)