vfilepg - Display pages of an AdvFS file
/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]
-a Specifies that all the pages in the file be displayed.
Specifies the logical block number of a disk block on an AdvFS volume.
Specifies the name of a file that contains the output of this utility.
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.
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.
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.
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.
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.
Specifies the name of a file that contains the output from this util-
Specifies the file page number of a file.
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
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
+ 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.
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
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.
The utility returns a 0 (zero) on success, otherwise it returns a nonzero
value and an error diagnostic.
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
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
# /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-
# /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-
# /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
Specifies the command path.
Contains links to the volumes in the domain.
Commands: nvfragpg(8), nvlogpg(8), vsbmpg(8), nvtagpg(8), tag2name(8)