unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



nvtagpg(8)							   nvtagpg(8)



NAME

  nvtagpg - Displays a disk block formatted as a tag directory

SYNOPSIS

  /sbin/advfs/nvtagpg [-v] tag_id

  /sbin/advfs/nvtagpg [-v] tag_id { page | -a  }

  /sbin/advfs/nvtagpg [-v] fileset_id file_id

  /sbin/advfs/nvtagpg domain_id	fileset_id -d dump_file

  /sbin/advfs/nvtagpg domain_id	-d dump_file

  /sbin/advfs/nvtagpg volume_id	-b block

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	will hold the contents of the speci-
      fied tag file.

  -v  Display all the data in a	specified tag file.

OPERANDS

  tag_id
      Specifies	a tag file using one of	the following formats:

      domain_id	| [-F] dump_file
	  Specify only the domain to select and	display	the root tag file.
	  The dump_file	parameter is a previously-saved	copy of	the root tag
	  file.	You can	use the	-F option to force the utility to interpret
	  the dump_file	parameter as a file name if it has the same name as a
	  domain name.

      domain_id	fileset_id | [-F] dump_file
	  Specify the domain and the fileset to	select and display the
	  fileset's tag	file. The dump_file parameter is a previously-saved
	  copy of the fileset's	tag file. You can use the -F option to force
	  the utility to interpret the dump_file parameter as a	file name if
	  it has the same name as a domain name.

  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 for the volume, for
	  example /dev/rdisk/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:

      [-F] file	| [-t] file_tag
	  Specify the [-F] option to force the command to interpret the	name
	  you supply as	a file name. Specify the file by entering either the
	  file's fileset relative pathname, file, or the file's	tag number,
	  -t file_tag.

  page
      Specifies	the file page number of	the tag	file.

DESCRIPTION

  The nvtagpg utility displays formatted pages of a root tag file or a
  fileset tag file. The	utility	also can save a	copy of	a tag file.

  Each AdvFS domain has	a root tag file	that lists all the filesets in the
  domain.  Each	fileset	has a tag file that lists all the files	in the
  fileset.

  Displaying the root Tag File


  The utility can display a page of the	root tag file.	For example, to
  display only the second page (which is page 1) of the	root tag file in a
  domain named domain_1, enter the following command:

       # /sbin/advfs/nvtagpg domain_1 1

  To display the first page of the root	tag file (which	is page	0), you	can
  specify the page, as in the example above, or	you can	just name the domain,
  and the default display is page 0.  If you use the default, the display
  includes the names of	all the	filesets in the	domain.	 For example, to
  display page 0 of the	root tag file and the names of all the filesets	in
  the domain named domain_1, enter the following command:

       # /sbin/advfs/nvtagpg domain_1






  Displaying A Fileset Tag File


  To display all the tags in a fileset,	use the	-a option.  For	example, to
  display all the tags in the fileset fileset_1	in the domain domain_1,	enter
  the following	command:

       # /sbin/advfs/nvtagpg domain_1 fileset_1	-a

  To display the tag entry for a file that has tag 9 in	a fileset that has
  tag 2	in the domain domain_1,	enter the following command:

       # /sbin/advfs/nvtagpg domain_1 -T 2 -t 9

  Saving the Tag File


  To read the root tag file and	save it	to a file for later examination, use
  the -d dump_file option.  For	example, to save the root tag file from
  domain domain_1 to a file in the current working directory named
  save_domain_1, enter the following command:

       # /sbin/advfs/nvtagpg domain_1 -d save_domain_1

  To save the tag file from the	fileset	fileset_2 in domain_1, enter the fol-
  lowing command:

       # /sbin/advfs/nvtagpg domain_1 fileset_2	-d save_fileset2

  Displaying Corrupted AdvFS Volumes


  When the disk	structures are too corrupted to	use the	normal methods of
  viewing volumes, you can specify a logical block on a	disk.

  For example, to display and format as	a tag page a page that contains	logi-
  cal block 1024 on disk dsk5c (which is volume	one in in domain domain_1),
  enter	the following command:

       # /sbin/advfs/nvtagpg dsk5c -b 1024

  Or, enter the	following command:

       # /sbin/advfs/nvtagpg domain_1 1	-b 1024

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

FILES

  /sbin/advfs/nvtagpg
      Specifies	the command path.

  /etc/fdmns/domain_name
      Specifies	the AdvFS volumes in domain_name.

SEE ALSO

  Commands: nvfragpg(8), nvlogpg(8), vfilepg(8), vsbmpg(8)

  Files: advfs(4)