vmtools
NAME
vmmv — move or rename a virtual machine home directory
SYNOPSIS
|
vmmv |
[-hqvy] source destination |
|
vmmv |
[-hqvy] source … directory |
|
vmmv |
[-hqvy] -t directory source … |
DESCRIPTION
Move or rename a virtual machine home directory.
If two arguments are provided and
destination does not exists yet,
source will be renamed as
destination.
Else, the last argument must be a writable directory and
source will be moved as subdirectory of
directory.
Alternatively, the
-t flag allows to pass
directory as a separate option instead of the last argument.
OPTIONS
The options are as follows:
-
-h
-
Show usage information summary then exit.
-
-q
-
Decrease verbosity. Add several -q options to decrease verbosity even more (-qq by default to get minimal output). See vmtools.conf(5) for more information about verbosity levels.
See -v to increase the verbosity level.
-
-t directory
-
Move all source virtual machine homes as subdirectories of directory.
This is equivalent of passing directory as the last command-line argument.
-
-v
-
Increase verbosity. Add several -v options to increase verbosity even more (-vvv by default to get the most verbose output, including debugging messages). See vmtools.conf(5) for more information about verbosity levels.
See -q to decrease the verbosity level.
-
-y
-
Don’t ask any question: accept all confirmation requests and automatically select the default answer in any other situation.
Use this option with great care: no confirmation will be asked before deleting or overwriting any files!
ENVIRONMENT
-
TMPDIR
-
Default location to store temporary files, by default /tmp.
-
XDG_CONFIG_HOME
-
Location of user’s configuration files, by default ~/.config.
FILES
-
/usr/local/lib/vmtools
-
Libraries shared by the vmtools project utilities.
-
/usr/local/share/vmtools/vmtools.conf
-
Virtual machine default settings, see vmtools.conf(5).
Moreover, the content of
/usr/local/share/vmtools can be overridden in the following locations (in the order of precedence):
-
~/.config/vmtools
-
User overrides (if cfg_include_userhome is set to “yes”).
-
/etc/vmtools
-
System-wide overrides.
EXIT STATUS
-
0
-
The operation ended successfully.
-
1
-
An error occurred, incomplete tasks have been reverted.
-
2
-
Wrong usage, nothing has been done.
EXAMPLES
-
Example 1:
-
Rename a virtual machine:
vmmv ./oldname ./newname
-
Example 2:
-
Move several virtual machines to a directory:
vmmv ./foo ./bar ~/trash
