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

NAME

       vfilepg - Display pages of an AdvFS file

SYNOPSIS

       /sbin/advfs/vfilepg domain_id fileset_id file_id [page | -a] [-f d]

       /sbin/advfs/vfilepg volume_id -b block

       /sbin/advfs/vfilepg domain_id fileset_id file_id -d dump_file

       /sbin/advfs/vfilepg [-F] dump_file  [page | -a] [-f d]

OPTIONS

       Specifies  that	all the pages in the file be displayed.  Specifies the logical block number of a disk block on an AdvFS volume.  Specifies
       the name of a file that contains the output of this utility.  Specifies that the output is to be formatted in a directory  hierarchy.   The
       default, if this option is not specified, is to format the output as a hexadecimal and ASCII dump.

OPERANDS

       Specifies  an  AdvFS  file  domain  using the following format: By default, the utility opens all volumes using block device special files.
       Specify the -r option to operate on the raw device (character device special file) of the domain instead of the block device.  Specify  the
       [-D] option to force the utility to interpret the name you supply in the domain argument as a domain name.  Specifies an AdvFS volume using
       the following format: Specify the -V option to force the utility to interpret the name you supply in the volume argument as a volume  name.
       The  volume  name  argument also can be a full or partial path name, for example /dev/disk/dsk12a or dsk12a. Specifying a partial path name
       always opens the character device special file.

	      Alternatively, specify the volume by using arguments for its domain, domain_id, and its volume index number,  volume_index.   Speci-
	      fies an AdvFS fileset using the following format: Specify the [-S] option to force the command to interpret the name you supply as a
	      fileset name.  Specify the fileset by entering either the name of the fileset, fileset, or the fileset's tag number, -T fileset_tag.
	      Specifies  a  file name in the following format: Specify the file by entering either the file's fileset relative path name, file, or
	      the file's tag number, -t file_tag.  Specifies the name of a file that contains the output from this utility.   Specifies  the  file
	      page number of a file.

DESCRIPTION

       The  vfilepg  utility  formats,	dumps, and displays AdvFS file pages. A file page is the unit of disk storage for AdvFS file:  8 Kbytes of
       contiguous disk space.

       The utility has the following functions: Format and display one file page or all the file pages of a file. The file can be in a mounted	or
       unmounted  fileset.  Save the contents of a file in one fileset to a file in another fileset.  The file written is called a dump file.  The
       source file can be in a mounted or unmounted fileset; the output fileset must be mounted.  Format and display a dump  file  that  has  been
       dumped  using  the  utility.  Format and display a disk block of a file.  A disk block is always 512 bytes and is located by specifying its
       logical block number.

       You can specify which file page is to be displayed (page zero is the default), or you can display all the file pages in a file. The default
       display of file page information is in hexadecimal and ASCII formats.  If you use the -f d option, you can specify that the data be format-
       ted as a directory page as it is displayed.

       The utility displays one 8 Kbyte file page unless you specify the -b or -a options.  The utility displays one 512-byte disk block when  you
       use the -b option; all the file pages when you use the -a option.

NOTES

       An  active  domain,  which  is  a domain with one or more of its filesets mounted, has all of its volumes opened using block device special
       files.  These devices cannot be opened a second time without first being unmounted.  However, the character device special  files  for  the
       volumes can be opened more than once while still mounted.

       It  can be misleading to use this utility on a domain with mounted filesets because the utility does not synchronize its read requests with
       AdvFS file domain read and write requests.

       For example, the AdvFS can be writing to the disk as the utility is reading from the disk.  Therefore, when you run the	utility,  metadata
       may  not  have been flushed in time for the utility to read it and consecutive reads of the same file page may return unpredictable or con-
       tradictory results. [The domain is not harmed.]

       To avoid this problem, unmount all the fileset in the domain before using this utility.

RESTRICTIONS

       The utility can fail to open a block device, even when there are no filesets mounted for the domain and the AdvFS daemon,  advfsd  is  run-
       ning.  The daemon, as it runs, activates the domain for a brief time.  If the vfilepg utility fails in this situation, run it again.

EXIT STATUS

       The utility returns a 0 (zero) on success, otherwise it returns a nonzero value and an error diagnostic.

EXAMPLES

       The  following  example	displays  an etc file in the root fileset in the domain root_domain in the default format, a hexadecimal and ASCII
       dump.  [The output has been truncated on the right in order to fit the display limitations of  the  man	command.]:  #  /sbin/advfs/vfilepg
       root_domain root etc

       ======================================================================  DOMAIN  "root_domain"  VDI 1 (/dev/disk/dsk9a)	lbn 8528    page 0
       ---------------------------------------------------------------------- 000000   06 00 00 00  14	00  01	00  2e	00  00	00  06	00  00	00
       ..........   000010    01 80 00 00 02 00 00 00 14 00 02 00 2e 2e 00 00	 ..........  000020   02 00 00 00 01 80 00 00 72 00 00 00 18 00 05
       00    ........r.  000030   66 73 74 61 62 00 00 00 72 00 00 00 01 80 00 00    fstab...r.  000040   85 00 00 00 20 00 0c 00 23 2e 6d  72	67
       2e  2e  67    .... ...#.  000050   72 6f 75 70 00 00 00 00 85 00 00 00 01 80 00 00    roup......  000060   87 00 00 00 20 00 0c 00 23 2e 6d
       72 67 2e 2e 6d	 .... ...#.  000070   61 67 69 63 00 00 00 00 87 00 00 00 01 80 00 00	 agic......  000080   88 00 00 00 20 00 0d  00	23
       2e  6d  72 67 2e 2e 70	 .... ...#.  The following example displays an etc file in directory format. [The output has been truncated on the
       right in order to fit the display limitations of the man command.]: # /sbin/advfs/vfilepg root_domain root etc -f d

       ====================================================================== DOMAIN "root_domain"  VDI 1 (/dev/rdisk/dsk9a)  lbn  8528    page  0
       ----------------------------------------------------------------------
	   tag	name
	     6	.
	     2	..
	   114	fstab
	   133	#.mrg..group
	   135	#.mrg..magic
	   136	#.mrg..passwd
	   137	#.mrg..rc.config
	   138	#.mrg..rpc
	   139	#.mrg..shells
	   140	#.mrg..sysconfigtab
	  1296	ddr.dbase
	  1297	 disktab  The following example displays page 2 of the file my_file in fileset my_fileset of domain my_domain.	The output is dis-
       played in hexadecimal and ASCII text: # /sbin/advfs/vfilepg my_domain my_fileset my_file 2 The following example displays  page	2  of  the
       file  my_file  in  fileset  my_fileset  of  domain my_domain.  The output is displayed in directory format: # /sbin/advfs/vfilepg my_domain
       my_fileset my_file 2 -f d The following example displays disk block 47 on AdvFS volume /dev/disk/dsk12C. The output is  displayed in  ASCII
       text:  #  /sbin/advfs/vfilepg  dsk12c  -b 47 The following example displays the first page (page zero) of the root directory in the fileset
       my_fileset. The output is displayed in directory format: # /sbin/advfs/vfilepg my_domain my_fileset . -f d The following example dumps  the
       file  located in the path a/b/c in fileset my_fileset to a file named save_it in the default ASCII format.  # /sbin/advfs/vfilepg my_domain
       my_fileset a/b/c -d save_it The following example displays page 2 of the saved file save_it formatted as a directory: # /sbin/advfs/vfilepg
       save_it 2 -f d

FILES

       Specifies the command path.  Contains links to the volumes in the domain.

SEE ALSO

       Commands: nvfragpg(8), nvlogpg(8), vsbmpg(8), nvtagpg(8), tag2name(8)

																	vfilepg(8)