nvtagpg man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

nvtagpg(8)							    nvtagpg(8)

NAME
       nvtagpg - Displays a disk block formatted as a tag file.

SYNOPSIS
       /sbin/advfs/nvtagpg [-v] tag_id

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

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

       /sbin/advfs/nvtagpg domain_id fileset_id -d dump_file

       /sbin/advfs/nvtagpg domain_id -d dump_file

       /sbin/advfs/nvtagpg [-v] volume_id -b block

       /sbin/advfs/nvtagpg [-v] domain_id fileset_id -f

       /sbin/advfs/nvtagpg domain_id -X

       /sbin/advfs/nvtagpg domain_id fileset_id -X

OPTIONS
       Displays all the pages in the file.  Specifies the logical block number
       of a disk block on an AdvFS volume.  Specifies the name of a file  that
       will hold the contents of the specified tag file.  Prints lists of free
       tag slots.  Displays all the data in a specified tag file.   Tests  the
       tag file against the BMT for inconsistencies.

OPERANDS
       Specifies  a  tag file using one of the following formats: 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.  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.  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  for
       the  volume, for example /dev/rdisk/dsk12a or dsk12a. Specifying a par‐
       tial 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.
	      Specifies 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  follow‐
	      ing format: Specify the file by entering either the file's file‐
	      set relative pathname or the file's tag number. Specify  the  -F
	      option  to force the command to interpret the name you supply as
	      a file name.  Specifies the file page number of the tag file.

DESCRIPTION
       The nvtagpg utility displays summaries or formatted pages of  the  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 nvfragpg utility can display a summary of the root  tag  file.   To
       display	a  summary  of	the root tag file in a domain called domain_1,
       enter the following command: # /sbin/advfs/nvtagpg domain_1

       The utility can display a single entry in the root tag file. To display
       the  entry  for	the fileset fileset_1 in the root tag file in a domain
       called domain_1, enter the  following  command:	#  /sbin/advfs/nvtagpg
       domain_1 ROOT fileset_1

   Displaying a Fileset Tag File
       To  display  a  summary of the tag file for a fileset, enter the domain
       and the fileset. For example, to display a summary for the tag file for
       fileset fileset_1 in a domain called domain_1, enter the following com‐
       mand: # /sbin/advfs/nvtagpg domain_1 fileset_1

       To display a page of a fileset tag file, enter the domain, fileset, and
       page.  For example, to display page 2 of the tag file for fileset file‐
       set_1 in a domain called	 domain_1,  enter  the	following  command:  #
       /sbin/advfs/nvtagpg domain_1 fileset_1 2

   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
       following  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
       logical	block  1024  on	 disk  dsk5c  (which  is  volume one 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 file‐
       sets  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  con‐
       secutive	 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 filesets 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 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
       Specifies   the	 command   path.    Specifies  the  AdvFS  volumes  in
       domain_name.

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

       Files: advfs(4)

								    nvtagpg(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net