mirror of
https://github.com/gryf/vboxmanage-bash-completion.git
synced 2025-12-17 19:40:17 +01:00
gryf
10900543fa
Changed videocap to recording in modifyvm and controlvm, changed from usb to usbohci in modifyvm command, added new movevm and mediumio commands and cloud related options.
57 lines
1.6 KiB
ReStructuredText
57 lines
1.6 KiB
ReStructuredText
VBoxManage bash completion script
|
|
=================================
|
|
|
|
This version of the completion was initially based on Sebastian T. Hafner
|
|
script. However, in some point of time I've decided to rewrite it almost from
|
|
scratch.
|
|
|
|
Current version of script was written and tested against VBoxManage in version
|
|
6.0.12, and should contain all commands and their options.
|
|
|
|
Unlike other attempts, I've tried to make the script context aware. See the
|
|
simple session with the VBoxManage command below, to have an idea how it works:
|
|
|
|
.. image:: /images/vboxmanage_session.gif?raw=true
|
|
:alt: VBoxManage session
|
|
|
|
|
|
Note, that ``startvm`` command proposes only VMs, which are not running, while
|
|
``controlvm`` will complete only running VMs.
|
|
|
|
What is worth to mention, this completion script is a real thing, so it only
|
|
offer things which have sense for particular commands, for example:
|
|
|
|
.. image:: /images/vboxmanage_snapshot.gif?raw=true
|
|
:alt: Take a snapshot
|
|
|
|
For ``snapshot take`` subcommand, the only options which are proposed are
|
|
``--live`` and ``--description``. Other commands and subcommands are behaving in
|
|
similar way.
|
|
|
|
|
|
Installation
|
|
============
|
|
|
|
Either source the file::
|
|
|
|
$ . /path/to/this/repo/VBoxManage
|
|
|
|
or add it to a proper place depending on your distribution. Usual place would
|
|
be:
|
|
|
|
* ~/bash-completion.d/
|
|
* /usr/local/etc/bash-completion.d/
|
|
* /etc/bash_completion.d/
|
|
* etc.
|
|
|
|
It's also okay to copy it into some directory, and place proper line in
|
|
``.profile`` or ``.bashrc``::
|
|
|
|
source /some/directory/VBoxManage
|
|
|
|
License
|
|
=======
|
|
|
|
This software is licensed under 3-clause BSD license. See LICENSE file for
|
|
details.
|