setext(1M)																setext(1M)

NAME

       setext - set VxFS extent attributes

SYNOPSIS

       extent_size] flag] reservation] file

DESCRIPTION

       specifies a fixed extent size for a file, and reserves space for a file.  The file must already exist.

       In  some cases, fsadm may reorganize the extent map of a file in such a way as to make it less contiguous.  However, it does not change the
       geometry of a file that has a fixed extent size.

   Options
       recognizes the following options:

	      Specify a fixed extent size.
			     extent_size is the number of file system blocks to allocate for the extent.  An extent_size of zero cancels  previous
			     fixed-size  extents  for the file and uses the default extent allocation policy.  See vxtunefs(1M) for information on
			     extent size parameters.

	      The available allocation flags are

			     Specify that all extents must be aligned on
				    extent_size boundaries relative to the start of allocation units.

			     Immediately incorporate the reservation
				    into the file and update the file's on-disk inode with size and block count information that is  increased	to
				    include  the  reserved  space.   The  space added to the file is not initialized.  Only users with appropriate
				    privileges can use the option.

			     Specify that the reservation must be allocated contiguously.

			     Specify that the file may not be extended after the preallocated space
				    is used.

			     Specify that the reservation is not a persistent attribute of the file.
				    Instead, the space is allocated until the final close of the file, when any space not  used  by  the  file	is
				    freed.  The temporary reservation is not visible to the user (via getext(1M) or the ioctl, for example).

			     Specify that the reservation is reduced to the current file size
				    after the last close by all processes that have the file open.

	      Specify the VxFS file system type.

	      Preallocate space for
			     file.  reservation is specified in file system blocks or the actual size in bytes.

	      Echo the completed command line, but do not execute the command.
			     The  command  line  is  generated by incorporating the user-specified options and other information derived from This
			     option allows the user to verify the command line.

   Operands
       recognizes the following operand:

	      file	     Name of an existing VxFS file.

   Notes
       is available only with the HP OnLineJFS product.

       You can specify multiple flags by entering multiple instances of on the command line.

       You must specify the allocation flags with either the or option.

       Only the and allocation flags are persistent attributes of the file and therefore visible via getext(1M) or the ioctl.  Although is  not  a
       persistent  attribute  of  the file, it is visible until it is cleared during the final close of the file.  Other allocation flags may have
       persistent effects, but are not visible as allocation flags.

       In some cases, may reorganize the extent map of a file in such a way as to make it less contiguous.  However, it will not change the geome-
       try of a file that has a fixed extent size.

       For  the or options, you can specify the size in number of file system blocks or in bytes.  A numeric value indicates file system blocks, a
       numeric value with a suffix specifies the size in bytes: for kilobytes, for megabytes, or for gigabytes.

SEE ALSO

       getext(1M), fsadm_vxfs(1M), vxtunefs(1M), vxfsio(7).

       enhancement in Description section of vxfsio(7).

																	setext(1M)