NAME
setext (vxfs) — set extent attributes
SYNOPSIS
/usr/sbin/setext
[-F
vxfs]
[-V]
[-e
extent_size]
[-r
reservation]
[-f
flag]
file
DESCRIPTION
The
setext
command allows space to be reserved for a file, and a fixed extent
size to be specified for a file. The file must already exist.
Options
- -F vxfs
Specifies the VxFS file system type.
- -V
Echoes the completed command line, but performs no other action.
The command line is generated by incorporating the user-specified
options. This option allows the user to verify the command line.
- -e extent_size
Specify a fixed extent size. The extent size is specified in file
system blocks.
- -r reservation
Preallocate space for
file.
The reservation is specified in file
system blocks.
- -f flag
The available allocation flags are
- -f align
Specify that all extents must be aligned on
extent_size
boundaries relative to the start of allocation units.
- -f chgsize
Specify that the reservation is to be immediately incorporated
into the file.
The file's on-disk inode is updated with size
increased to include the reserved space.
Unlike an
fcntl F_FREESP
operation that ``truncates-up'' [see
fcntl(2)],
the space included in the file is not initialized.
Only users with appropriate privileges can use the
-f chgsize
flag.
- -f contig
Specify that the reservation must be allocated contiguously.
- -f noextend
Specify that the file may not be extended once the preallocated space
has been exhausted.
- -f 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,
at which time 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 instance).
- -f trim
Specify that the reservation is trimmed to the current file size
upon last close by all processes that have the file open.
NOTES
setext
is only available with the Advanced VxFS package.
Multiple flags may be specified by specifying multiple instances of
-f
in a command line.
The allocation flags must be specified 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.
Other allocation flags
may have persistent effects,
but are not visible as allocation flags.
Under certain circumstances,
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.