NAME

stage - Set staging attributes and copy off-line files to disk

SYNOPSIS

stage [ -a] [ -c n] [ -d] [ -f] [ -I] [ -iinput_file ] [ -w] [ -n] [ -p] [ -V] [ -x] [ -r] [filename…]

AVAILABILITY

SUNWqfs

SUNWsamfs

DESCRIPTION

stage sets staging attributes on a directory or file, transfers one or more off-line files from the archive media to magnetic disk, or cancels a pending or active stage request. By default, staging is automatically done when the file is accessed. If none of the -a, -d, -n, or -x options is specified, staging is initiated.

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

Stage attributes may be set only by the owner of the file or the superuser. Staging can be initiated or canceled either by the owner, superuser, or other user with read or execute permission.

OPTIONS

-a

Set the associative staging attribute on the file or directory. Associative staging is activated when a regular file that has the associative staging attribute set is staged. All files in the same directory that have the associative staging attribute set are staged. If a symbolic link has the associative staging attribute set, the file pointed to by the symbolic link is staged. Not valid with stage never attribute -n.

-c n

Stage from the archive copy number n.

-d

Returns staging attributes on the file to the default. When this option is specified the attributes are first reset to the default, then other attribute-setting options are processed. The only action taken is that attributes are reset.

-f

Do not report errors.

-I

Stage immediate. This option allows the system to place the request in front of the pending requests. Caution, if there are pending requests, those requests are staged after all immediate requests has completed. This option must be run with root permissions.

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

-w

Wait for each file to be staged back on-line before completing. Not valid with -d, or -n.

Note that when staging many files at once (such as with stage -r -w .) the "-w" option causes each file to be completely staged before the stage request for the next file is issued. This does not allow the system to sort the stage requests in the order that the files are archived on the media. In order to get the best performance in this situation, do the following:

stage -r . stage -r -w .

-n

Specifies that the file never be automatically staged. The file will be read directly from the archive media. The mmap function is not supported if the stage -n attribute is set. The stage -n attribute is not valid with the associative staging attribute -a. The stage -n attribute is not valid with the checksum use attribute (ssum -u). The stage -n attribute is not supported on a Oracle HSM shared file system client; the entire file is staged when accessed on a client. If stage -n is issued while the file is being staged, EINVAL is returned.

-p

Specifies that the offline regular file's partial blocks be staged.

-r

Recursively stages 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

Turns on verbose display. A message will be displayed for each file on which a stage will be attempted.

-x

Cancel a pending or active stage request for the named file(s).

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 (`-') stage reads the list of files from standard input.

NOTE

If the application writes (see write(2)) to a file or the application mmaps (see mmap(2)) a file with prot set to PROT_WRITE, the file is staged in and the application waits until the stage has completed. The stage -n attribute is ignored and the file is completely staged back online.