setext(1M)setext(1M)NAMEsetext - 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 pol‐
icy. 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 tempo‐
rary 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 ver‐
ify 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 per‐
sistent attribute of the file, it is visible until it is cleared during
the final close of the file. Other allocation flags may have persis‐
tent 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 geometry
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 ALSOgetext(1M), fsadm_vxfs(1M), vxtunefs(1M), vxfsio(7).
enhancement in Description section of vxfsio(7).
setext(1M)
