unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 setext(1M)							  setext(1M)




 NAME
      setext (vxfs) - set extent attributes

 SYNOPSIS
      /usr/sbin/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
	   -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 vxfs	  Specify the VxFS file system type.

	   -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



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 setext(1M)							  setext(1M)




			       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.

	   -r reservation Preallocate space for file. reservation is
			  specified in file system blocks.

	   -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.

 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.  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.

 SEE ALSO
      getext(1M), fsadm_vxfs(1M), vxtunefs(1M), vxfsio(7) (particularly the
      section on VX_SETEXT).
















 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000