mv - Moves files and directories
mv [-i|-f] [--] file1 file2
mv [-i|-f] [--] file1... directory
mv [-i|-f] [--] directory1... destination_directory
command moves files from one directory to
another or renames files and directories.
Interfaces documented on this reference page conform to industry standards as follows:
mv: XPG4, XPG4-UNIX
Refer to the
reference page for more information
about industry standards and associated tags.
option and any mode restrictions.
example, because an alias includes one of them--whichever appears last
overrides the other.)
Prompts you with the name of the file followed by a question
mark whenever a move is to supersede an existing file. If the answer begins
y, or the locale's equivalent of a
the move continues. Any other reply prevents the move from occurring. (If
are specified--for example,
because an alias includes one of them--whichever appears last overrides
Interprets all following arguments to
as file names. This allows file names to start with a
If you move a file to a new directory, mv retains the original file name. When you move a file, all other links to the file remain intact.
In the second form, one or more files are moved to directory with their original file names. In the third form, one or more directories are moved to the destination directory with their original names.
The mv command does not move a file onto itself.
When you use mv to rename a file, the target file can be either a new file name or a new directory path name. If moving the file would overwrite an existing file that does not have write permission set and if standard input is a terminal, mv displays the permission code of the file to be overwritten and reads one line from standard input. If the line begins with y, or the locale's equivalent of a y, the move takes place and the file is overwritten. If not, mv does nothing with the file.
When you use mv to move a directory into an existing directory, the directory and its contents are added under the existing directory.
The LC_MESSAGES variable determines the locale's equivalent of y or n (for yes/no queries).
If a mv operation fails, mv generally writes a diagnostic message to standard error, does nothing more with the current source file, and goes on to process any remaining source files.
If the copying or removal of a file is prematurely terminated by a signal
might leave a partial copy of the file at
either the source or the target path name. The
does not modify the source and target path names simultaneously; therefore,
program termination at any point always leaves either the source file or the
target file complete.
[Compaq] If the source is on a different file system than
must copy the source to the destination's
file system and then delete the source. The effect is equivalent to the following:
rm -f destination && cp -pr source destination && rm -rf source
command might overwrite existing
files. Specify the
option last on the command line to cause
command to prompt you before it moves a file.
The following exit values are returned:
All files were moved successfully.
An error occurred.
To rename a file, enter: mv file1 file2
The following environment variables affect the execution of
Provides a default value for the internationalization variables
that are unset or null. If
is unset or null, the corresponding value from the default locale is used.
If any of the internationalization variables contain an invalid setting, the
utility behaves as if none of the variables had been defined.
If set to a non-empty string value, overrides the values of
all the other internationalization variables.
Determines the locale for the interpretation of sequences
of bytes of text data as characters (for example, single-byte as opposed to
multibyte characters in arguments).
Determines the locale for the format and contents of diagnostic
messages written to standard error.
Determines the location of message catalogues for the processing
Commands: cp(1), ln(1), rm(1)