source ... directory
In its first form, the mv
utility moves the file
named by the source
operand to the
destination path named by the target
This form is assumed when the last operand does not name an already existing
In its second form, mv
moves each file named by a
operand to the destination specified
by the directory
operand. It is an error if
does not exist. The destination
path for each source
operand is the pathname
produced by the concatenation of the
operand, a slash, and the final
pathname component of the named file.
In both forms, a source
operand is skipped with
an error message when the respective destination path is a non-empty
directory, or when the source is a non-directory file but the destination path
is a directory, or vice versa.
The options are as follows:
- Do not prompt for confirmation before overwriting the
destination path. The -f option overrides any
previous -i options.
- Causes mv to write a prompt to
standard error before moving a file that would overwrite an existing file.
If the response from the standard input begins with the character
“y”, the move is attempted. The
-i option overrides any previous
- Display the source and destination after each move.
utility moves symbolic links, not the files
referenced by the links.
If the destination path does not have a mode which permits writing,
prompts the user for confirmation as specified
for the -i
Should the rename(2)
because the source and destination are on different file systems,
to accomplish the move. The
effect is equivalent to:
$ rm -df -- destination_path && \
cp -PRp -- source destination_path && \
rm -rf -- source
utility exits 0 on success,
and >0 if an error occurs.
Rename file foo
, overwriting bar
if it already exists:
$ mv -f foo bar
Either of these commands will rename the file -f
, prompting for confirmation if
$ mv -i -- -f bar
$ mv -i ./-f bar
utility is compliant with the
IEEE Std 1003.1-2008
The flag [-v
] is an
extension to that specification.
command appeared in
Version 1 AT&T UNIX
In the second synopsis form, incompatible file types in
cause partial moves. For example,
non-directory files and d
are directories, the command
$ mv f g d
will print an error message, leave f
where it is,
return a non-zero exit status.