10.0;mvf (move_file), revision 1.0, 88/06/10
mvf (move_file) -- Move a file.
usage: mvf source [destination] ... [options]
DESCRIPTION
mvf moves a file to a different location in the naming tree. Its effect
is similar to
$ cpf source destination $ dlf source
Thus, it copies source to destination, and deletes source. mvf always
retains the source ACL on objects moved.
ARGUMENTS
source (required)
Specify name of file to be moved.
destination (optional)
Specify new file location. This pathname may be a derived
name. If destination is a directory, the command moves the
source file into that directory. Otherwise it creates the new
file using the name specified.
Default if omitted:
copy source to current working directory
Multiple source/target pairs are permitted as well as wildcarding,
however, while you can use wildcards with the source, you cannot with the
destination.
OPTIONS
-p[airwise]
Instructs mvf to accept the list of tokens as consecutive
pairs. This is necessary whether you are using wildcards or
not.
-c (default)
Create the target file. If the target file already exists, an
error results.
-r Replace target file with source file. Use this option if the
target file already exists. If the file does not exist, this
option works like -c.
-du Delete when unlocked. This option is useful with -r. If the
object to be replaced is locked when mvf is invoked, the
replace operation is performed when the object is unlocked.
-f Force deletion of destination object if you have 'p' (protect)
rights, even if you do not have 'd' (delete) rights.
-lf List files moved.
-ldl List files deleted by -r option.
-chn Change the name of an existing destination file if required.
This option modifies the meaning of -c and -r. If -c is
specified, this option causes any existing object with the
destination pathname to be renamed prior to the move. If -r is
specified, the destination object is renamed if it is in use
and cannot be deleted.
NOTES
If you use more than one pair of name tokens with this command, you must
use the -p option. It instructs the command to accept the list of tokens
as consecutive pairs. This is necessary whether you are using wildcards
or not. In the past, this command has correctly paired off tokens without
the prompting of a switch; now the -p switch must be used to acheive this
result. The switch has been added to protect against inadvertent use in
a shell, other than /com/sh, where wildcard expansion can be a problem.
EXAMPLES
$ mvf //anger/sam/letter //mary -r
Move the file letter from the directory //anger/sam to the directory
//mary and replace the current file.