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)