release(1)

NAME
     release - Releases disk space and sets release attributes

SYNOPSIS
     release [-a] [-d] [-f] [-n] [-p] [-s partial_size] [-V]
     filename ...

     release [-a] [-d] [-f] [-n] [-p] [-s partial_size] [-V]
     -r dirname ...  [filename ...]

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The release command sets release attributes for a file and
     releases the disk space associated with one or more files.
     At least one archive image must exist for each file before
     its disk space is released.  By default, the releaser daemon
     automatically drops disk space when the file system's high
     water mark is reached.

     Files that are symbolic links are silently ignored.

     If the -a, -d, -n, -p, or -s options are specified, only the
     attribute is set; the disk space is not released, however if
     the partial attribute is reset, all blocks are released for
     an offline regular file.

     When release attributes are set on a directory, files and
     directories subsequently created in that directory inherit
     those attributes.

OPTIONS
     This command accepts the following arguments:

     -a        Sets the attribute that specifies that a file's
               disk space be released when at least one archive
               copy of the file exists.  This option cannot be
               specified on the command line in conjunction with
               the -n option.

     -d        Resets the release attributes on the file to the
               default attributes.  When this option is
               specified, attributes are first reset to the
               default, and then all other attribute-setting
               options are processed.

               If the partial attribute is reset, all blocks are
               released for an offline regular file. If the
               partial blocks are to be retained, specify the -p
               or -s option with the -d option.

     -f        Suppresses error messages.

     -n        Specifies that the disk space for this file never
               be released.  Only a superuser can set this
               attribute on a file.  This option cannot be
               specified on the command line in conjunction with
               the -a option.

     -p        Sets the partial release attribute on the file so
               that when the file's disk space is released, the
               first portion of that disk space is retained on
               the disk.

               By default, the minimum size of the portion
               retained on disk is controlled by the
               -o partial=nk option on the mount_samfs(1M)
               command.  This amount can be adjusted by using the
               -s option on the release command.

               NOTE: Even through only a portion of the file is
               retained on disk, the amount of disk space
               consumed is equal to one DAU. So, for example, if
               the partial size is set to 16K and the DAU size is
               256K, even though only 16K of data remains after a
               partial release, the actual disk space used is
               256K.

               If this option is specified for an offline file,
               the partial blocks are not on the disk, and the
               entire file is be staged if accessed.  You can use
               the stage(1) command's -p option to stage the
               partial blocks to the disk.

               This option cannot be specified under the
               following circumstances:

               o This option cannot be specified for a file that
                 has the checksum use attribute set.  This
                 attribute is set by using the ssum(1) command -u
                 option.

               o The stage(1) command's -n option enables the
                 never-stage attribute.

                 For more information on the stage(1) command,
                 see the stage(1) man page.

     -s partial_size
               Specifies the number of kilobytes to be retained
               on disk when a file with the partial-release
               attribute is released.  When the file's disk space
               is released, the first partial_size kilobytes of

               that disk space are retained.

               By default, the minimum partial_size is 8
               kilobytes, and the maximum partial_size is 16
               kilobytes or whatever the -o maxpartial=maxpartial
               setting is for this file system as specified on
               the mount(1M) command.  For more information on
               the mount(1M) command, see the mount_samfs(1M) man
               page.

               This option cannot be specified under the
               following circumstances:

               o This option cannot be specified for a file that
                 has either the checksum-generate or checksum-use
                 attributes set.  These attributes are set by
                 using the ssum(1) command's -g or -u options,
                 respectively.

               o The stage(1) command's -n option enables the
                 never-stage attribute.

     -r        Recursively releases disk space or sets release
               attributes for files contained in the specified
               dirname and its subdirectories.  More than one
               dirname can be specified.

               Symbolic links that are encountered when this
               option is in effect are not traversed.

               If used in conjunction with other command line
               options, the -r dirname option must be specified
               prior to any individual files listed (using the
               filename argument), but it must be specified after
               any other individual options.

     -V        Enables a detailed, verbose display.  A message is
               displayed for each file for which release is
               attempted.

     filename  Specifies one or more file names.  If the
               -r dirname option is also specified, filename
               arguments must appear after all dirname
               specifications.

SEE ALSO
     archive(1), ssum(1), stage(1).

     mount_samfs(1M).