HP-UX Reference (11i v2 04/09) - 1M System Administration Commands N-Z (vol 4)

s
setext(1M) setext(1M)
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 visi-
ble until it is cleared during the final close of the file. Other allocation flags may have persistent effects,
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 1M−−767