nvtagpg - Displays a disk block formatted as a tag directory
/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 [v]
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. Displays all the data in a specified
tag file.
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 previouslysaved
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 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. 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 following
format: 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. Specifies the file
page number of the tag file.
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 [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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
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 filesets in the
domain before using this utility.
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.
The utility returns a 0 (zero) on success, otherwise it
returns a nonzero value and an error diagnostic.
Specifies the command path. Specifies the AdvFS volumes
in domain_name.
Commands: nvfragpg(8), nvlogpg(8), vfilepg(8), vsbmpg(8)
Files: advfs(4)
nvtagpg(8)
[ Back ] |
