nvtagpg(8)nvtagpg(8)NAMEnvtagpg - 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)