PRIMECLUSTER Global File Services Configuration and Administration Guide 4.2 (Solaris(TM) Operating Environment)

F.3.5 sfcmv(1) Moves files with extent attribute information

[SYNOPSIS]

sfcmv [ -fi ] source target_file

sfcmv [ -fi ] source... target_dir

[DESCRIPTION]

The sfcmv command moves a file with or without file extension attribute information on the GFS Shared File System. The sfcmv command also operates on the other file system, but in this case, using mv(1) is strongly recommended.

In format 1 above, the sfcmv utility moves the file indicated by the source operand to the destination indicated by the target_file. The same name cannot be specified for source and target_file. If target_file is not found, sfcmv creates a new file with the same name. If target_file is found, its contents are overwritten. When the last operand does not indicate an existing directory, sfcmv is assumed to be in format 1.

In format 2, the sfcmv utility moves each file specified in the source operand to each file in an existing directory indicated in the target_dir operand. In the destination path name for a source, a slash (/) and the last path name of source are added after the destination directory name. When the last operand indicates an existing directory, sfcmv is assumed to be in format 2.

When target_file is identified in write-disabled mode, sfcmv displays a mode (see chmod(2)), requests a response, and reads one line from the standard input. If the response is positive and sfcmv has the appropriate permission, it moves the file. Otherwise, this command terminates. When target_file makes ACL valid, the access right is not completely displayed in mode. If the parent directory of source is in write-enabled mode with a sticky bit set, one or more of the following conditions must be true:

• The user must own the file.
• The user must own directories.
• The file must be in user-write-enabled mode.
• The user must be a privileged user.

When source indicates a file and target_file indicates a link to another file having a link, the other link remains, and target_file changes to a new file.

[OPTIONS]

The following options can be specified:

-f

sfcmv moves a file without displaying a prompt even when it writes data to an existing target. Note that this option is the default if the standard input is not a terminal.

-i

sfcmv always displays a confirmation prompt when an existing target is overwritten in a move operation. If the response is y, the move processing continues. If the response is another character, sfcmv does not overwrite target.

When both the -f and -i options are specified, they are not assumed to be illegal. Instead, the -f option is valid.

[OPERANDS]

The following operands can be specified:

source

Path name of a file or directory to be moved

target_file

A new path name of a file or directory to be moved

target_dir

Path name of an existing directory used as the destination of the move file operation

[ENVIRONMENT]

For information about environment variables LC_CTYPE, LC_MESSAGES, and NLSPATH, which affect the execution of sfcmv see environ(5).

[EXIT STATUS]

The following termination status information is returned:

0 All input files have been moved correctly.

>0 An error has occurred.

[SEE ALSO]

sfccp(1), sfccpio(1), sfcgetext(1), sfcgetfattr(1), sfcsetext(1), sfcsettime(1), sfcsetvolume(1).

cp(1), cpio(1), ln(1), mv(1), rm(1), setfacl(1), chmod(2), attributes(5), environ(5), largefile(5) in the "Solaris X Reference Manual Collection."

[NOTES]

• When source and target_dir are on different file systems, sfcmv copies the file and deletes the originals; In this case, all links to other files are deleted.
• Since users can clearly specify the end of a command line option with two consecutive hyphens (--), sfcmv can identify a file name argument that begins with a single hyphen (-). For a move operation in BSD, sfcmv accepts a single hyphen (-) as a synonym of two hyphens (--). Note, however, that the BSD move function may be deleted in future releases. If both two consecutive hyphens (--) and a single hyphen (-) are specified on the same line, the latter is interpreted as specifying a file name.
• When target is specified, use sfccp(1) to store extent attribute information for target (with -e NWE specified).
• sfcmv can move a file between different file systems, and a file with extent attribute information from/to GFS Local File System. If a file on the GFS Shared File System is moved to the other file system (for example, UFS), however, extent attribute information is deleted.
• sfcmv will operate on a file system other than the GFS Shared File System and GFS Local File System, but its operation will be equivalent to the conventional mv(1).