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 ALSO
       dd(1), fs_vxfs(4), vxfsio(7).

								fscat_vxfs(1M)

Vote for polarhome