NAME
setext — set VxFS extent attributes
SYNOPSIS
setext
[-F
vxfs]
[-e
extent_size]
[-f
flag]
[-r
reservation]
[-V]
file
DESCRIPTION
setext
specifies a fixed extent size for a file,
and reserves space for a file.
The file must already exist.
Options
setext
recognizes the following options:
- -e extent_size
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.
- -f flags
The available allocation flags are
- align
Specify that all extents must be aligned on
extent_size
boundaries relative to the start of allocation units.
- chgsize
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
chgsize
option.
- contig
Specify that the reservation must be allocated contiguously.
- noextend
Specify that the file may not be extended after the preallocated space
is used.
- noreserve
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
VX_GETEXT
ioctl, for example).
- trim
Specify that the reservation is reduced to the current file size
after the last close by all processes that have the file open.
- -F vxfs
Specify the VxFS file system type.
- -r reservation
Preallocate space for
file.
reservation
is specified in file
system blocks
or the actual size in bytes.
- -V
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
/etc/fstab.
This option allows the user to verify the command line.
Operands
setext
recognizes the following operand:
- file
Name of an existing VxFS file.
Notes
setext
is available only with the HP OnLineJFS product.
You can specify multiple flags by entering multiple instances of
-f
on the command line.
You must specify the allocation flags with either the
-e
or
-r
option.
Only the
align
and
noextend
allocation flags are persistent attributes of the file and
therefore visible via
getext(1M)
or the
VX_GETEXT
ioctl.
Although
trim
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,
fsadm
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
-e
or
-r
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:
k
for kilobytes,
m
for megabytes,
or
g
for gigabytes.