setext(1M)                                                       setext(1M)




 NAME    [Toc]    [Back]
      setext - set VxFS extent attributes

 SYNOPSIS    [Toc]    [Back]
      setext [-F vxfs] [-e extent_size] [-f flag] [-r reservation] [-V] file

 DESCRIPTION    [Toc]    [Back]
      setext specifies a fixed extent size for a file, and reserves space
      for a file.  The file must already exist.

    Options    [Toc]    [Back]
      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



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 setext(1M)                                                       setext(1M)




                               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    [Toc]    [Back]
      setext recognizes the following operand:

           file           Name of an existing VxFS file.

    Notes    [Toc]    [Back]
      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.

 SEE ALSO    [Toc]    [Back]
      getext(1M), fsadm_vxfs(1M), vxtunefs(1M), vxfsio(7).



 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 setext(1M)                                                       setext(1M)




      VX_SETEXT enhancement in Description section of vxfsio(7).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003