fscat_vxfs(1M)fscat_vxfs(1M)NAME
fscat_vxfs: fscat - cat a VxFS file system
SYNOPSIS
output-file] offset] length] block_size] special
DESCRIPTION
provides an interface to a VxFS snapshot file system, similar to that
provided by invoked on the block or character special file of regular
VxFS file systems. works when executed on the special device of any
VxFS file system.
On most VxFS file systems, the block or character special file for the
file system provides access to a raw image of the file system to back
up the file system to tape. On a snapshot file system, access to the
corresponding block or character special file provides little useful
information. provides a stream of bytes representing the file system
snapshot. This datastream is written by default to standard output,
although the output-file option can be used to specify another destina‐
tion. The datastream on standard output can be processed several ways,
such as in a pipeline, or written to a tape.
By default, the output is a stream of bytes that starts at the begin‐
ning of the file system and continues to the last byte. On a snapshot
file system, data is read from the file system using special ioctls on
the mount point. On other VxFS file systems, data is read from the
specified special file. Unless otherwise specified, data is written to
standard output.
All numbers entered as option arguments can have as a prefix to indi‐
cate octal, or as a prefix to indicate hexadecimal. A or can be
appended to indicate the value is in 512-byte blocks, a or to indicate
the value is in kilobytes, an or to indicate the value is in megabytes,
or a or to indicate the value is in gigabytes. An appended letter can
be separated from the number by a space, in which case the letter and
number should be enclosed in a set of quotes. For example:
All numbers entered as options must be in multiples of 512 bytes. For
example, a value of 5713 as an offset is rejected.
Options
recognizes the following options:
Specify the output block size, in bytes.
block_size must be less than or equal to 1 megabyte.
Specify the VxFS file system type.
Specify an output file in which to write the datastream.
Specify the transfer length, in bytes.
A length of includes the remainder of the file system
after the specified offset.
Specify the starting offset in bytes.
Operands
recognizes the following operand:
special Name of the special device from which the VxFS
file system is accessed.
Notes
Snapshot file systems are only available with the HP OnLineJFS product.
A snapshot file system cannot be written to.
A snapshot file system exists only as long as it is mounted; once
unmounted, the special file no longer contains a snapshot file system.
When is run on a mounted VxFS snapshot, the content of free blocks
(that is, blocks not allocated to any file or metadata) is undefined.
The content of free blocks can change after additional data is written
to the primary file system, but blocks associated with files always
display the content they had when the snapshot was created.
does not work with Storage Checkpoints.
SEE ALSOdd(1), fs_vxfs(4), vxfsio(7).
fscat_vxfs(1M)