unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



vfilepg(8)							   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

  -a  Specifies	that all the pages in the file be displayed.

  -b block
      Specifies	the logical block number of a disk block on an AdvFS volume.

  -d dump_file
      Specifies	the name of a file that	contains the output of this utility.

  -f d
      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

  domain_id
      Specifies	an AdvFS file domain using the following format:

      [-r] [-D]	domain
	  By default, the utility opens	all volumes using block	device spe-
	  cial 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.

  volume_id
      Specifies	an AdvFS volume	using the following format:

      [-V] volume | domain_id volume_index
	  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.

  fileset_id
      Specifies	an AdvFS fileset using the following format:

      [-S] fileset | -T	fileset_tag
	  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.

  file_id
      Specifies	a file name in the following format:

      file | [-t] file_tag
	  Specify the file by entering either the file's fileset relative
	  path name, file, or the file's tag number, -t	file_tag.

  dump_file
      Specifies	the name of a file that	contains the output from this util-
      ity.

  page
      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 formatted 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 contradictory 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 running.
  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

   1.  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	.... ...#.

   2.  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

   3.  The following example displays page 2 of	the file my_file in fileset
       my_fileset of domain my_domain.	The output is displayed	in hexade-
       cimal and ASCII text:
	    # /sbin/advfs/vfilepg my_domain my_fileset my_file 2

   4.  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

   5.  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

   6.  The following example displays the first	page (page zero) of the	root
       directory in the	fileset	my_fileset. The	output is displayed in direc-
       tory format:
	    # /sbin/advfs/vfilepg my_domain my_fileset . -f d

   7.  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 for-
       mat.
	    # /sbin/advfs/vfilepg my_domain my_fileset a/b/c -d	save_it

   8.  The following example displays page 2 of	the saved file save_it for-
       matted as a directory:
	    # /sbin/advfs/vfilepg save_it 2 -f d



FILES

  /sbin/advfs/vfilepg
      Specifies	the command path.

  /etc/fdmns/domain_name
      Contains links to	the volumes in the domain.

SEE ALSO

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