Specifications

170 Version 2.0
mv
Summary
Moves one or more files to a destination within a file system.
Usage
mv src [src...] [dst]
Options
src
Source file/directory name (wildcards are permitted)
dst
Destination file/directory name (wildcards are permitted). If not specified, then
the current working directory is assumed to be the destination. If there is more
than one argument on the command line, the last one will always be considered
the destination.
Description
This command moves one or more files to a destination within a file system. Moving
between filesystem volumes is not supported. If the destination is an existing
directory, then the sources are moved into that directory. Otherwise, the sources are
moved to the destination, as if the directory has been renamed. If a destination is not
specified, the current directory is assumed to be the destination.
Attempting to move a read-only file/directory will result in an error. Moving a
directory that contains read-only files is allowed. You cannot move a directory into
itself or its subdirectories. You cannot move a directory if the current working
directory is itself or its subdirectories.
If an error occurs, the remaining files or directories will still be moved.
Status Codes Returned
SHELL_SUCCESS The action was completed as requested.
SHELL_INVALID_PARAMETER One of the passed in parameters was incorrectly formatted or its
value was out of bounds.
SHELL_NOT_FOUND The source file was not able to be found
SHELL_OUT_OF_RESOURCES There was insufficient free space to move the requested file to its
destination.
SHELL_SECURITY_VIOLATION This function was not performed due to a security violation
SHELL_WRITE_PROTECTED An attempt was made to create a file on media that was write-
protected.