vfilepg(8)vfilepg(8)NAMEvfilepg - Display pages of an AdvFS file
SYNOPSIS
/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]
OPTIONS
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.
OPERANDS
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 inter‐
pret 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 exam‐
ple /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: 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 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
utility. Specifies the file page number of a file.
DESCRIPTION
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 con‐
tiguous disk space.
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 file‐
set must be mounted. 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 logi‐
cal 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.
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 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 run‐
ning. The daemon, as it runs, activates the domain for a brief time.
If the vfilepg 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.
EXAMPLES
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 .... ...#.
The following example displays an etc file in directory format. [The
output has been truncated on the right in order to fit the display lim‐
itations 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
----------------------------------------------------------------------
tag name
6 .
2 ..
114 fstab
133 #.mrg..group
135 #.mrg..magic
136 #.mrg..passwd
137 #.mrg..rc.config
138 #.mrg..rpc
139 #.mrg..shells
140 #.mrg..sysconfigtab
1296 ddr.dbase
1297 disktab The following example displays page 2 of the file
my_file in fileset my_fileset of domain my_domain. The output is dis‐
played in hexadecimal and ASCII text: # /sbin/advfs/vfilepg my_domain
my_fileset my_file 2 The following example displays page 2 of the file
my_file in fileset my_fileset of domain my_domain. The output is dis‐
played in directory format: # /sbin/advfs/vfilepg my_domain my_fileset
my_file 2 -f d 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 The following example displays the
first page (page zero) of the root directory in the fileset my_fileset.
The output is displayed in directory format: # /sbin/advfs/vfilepg
my_domain my_fileset . -f d 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 format. # /sbin/advfs/vfilepg my_domain my_file‐
set a/b/c -d save_it The following example displays page 2 of the saved
file save_it formatted as a directory: # /sbin/advfs/vfilepg save_it 2
-f d
FILES
Specifies the command path. Contains links to the volumes in the
domain.
SEE ALSO
Commands: nvfragpg(8), nvlogpg(8), vsbmpg(8), nvtagpg(8), tag2name(8)vfilepg(8)