NAME

release - Releases disk space and sets release attributes

SYNOPSIS

release [-a] [-d] [-f] [-i input_file] [-n] [-p] [-s partial_size] [-V] [-r] [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.

-i input_file

The name of a file containing file names to be processed. Every file named in the input file must be on a separate line; leading and trailing white space is removed. If the input file name is specified as a single dash (`-') standard input is read. This option cannot be used when file names are specified on the command line. If the -r option is specified its behavior is applied to all files in the input file.

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

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

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.
The stage (1) command's -n option enables the never-stage attribute.

-r

Recursively releases or sets attributes for files contained in the supplied file name(s) and their subdirectories. Symbolic links that are encountered when this option is in effect are not traversed.

-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. Specifying file names is mutually exclusive with the -i option. If a single file name is specified as a single dash (`-') release reads the list of files from standard input.