VirtualBox Guest Additions installer
salt.modules.vbox_guest.
additions_install
(**kwargs)¶Install VirtualBox Guest Additions. Uses the CD, connected by VirtualBox.
To connect VirtualBox Guest Additions via VirtualBox graphical interface press 'Host+D' ('Host' is usually 'Right Ctrl').
See https://www.virtualbox.org/manual/ch04.html#idp52733088 for more details.
CLI Example:
salt '*' vbox_guest.additions_install
salt '*' vbox_guest.additions_install reboot=True
salt '*' vbox_guest.additions_install upgrade_os=True
salt.modules.vbox_guest.
additions_mount
()¶Mount VirtualBox Guest Additions CD to the temp directory.
To connect VirtualBox Guest Additions via VirtualBox graphical interface press 'Host+D' ('Host' is usually 'Right Ctrl').
CLI Example:
salt '*' vbox_guest.additions_mount
True or OSError exception
salt.modules.vbox_guest.
additions_remove
(**kwargs)¶Remove VirtualBox Guest Additions.
Firstly it tries to uninstall itself by executing '/opt/VBoxGuestAdditions-VERSION/uninstall.run uninstall'. It uses the CD, connected by VirtualBox if it failes.
CLI Example:
salt '*' vbox_guest.additions_remove
salt '*' vbox_guest.additions_remove force=True
force (bool) -- force VirtualBox Guest Additions removing
True if VirtualBox Guest Additions were removed successfully else False
salt.modules.vbox_guest.
additions_umount
(mount_point)¶Unmount VirtualBox Guest Additions CD from the temp directory.
CLI Example:
salt '*' vbox_guest.additions_umount
mount_point -- directory VirtualBox Guest Additions is mounted to
True or an string with error
salt.modules.vbox_guest.
additions_version
()¶Check VirtualBox Guest Additions version.
CLI Example:
salt '*' vbox_guest.additions_version
version of VirtualBox Guest Additions or False if they are not installed
Grant access to auto-mounted shared folders to the users.
User is specified by it's name. To grant access for several users use argument users. Access will be denied to the users not listed in users argument.
See https://www.virtualbox.org/manual/ch04.html#sf_mount_auto for more details.
CLI Example:
salt '*' vbox_guest.grant_access_to_shared_folders_to fred
salt '*' vbox_guest.grant_access_to_shared_folders_to users ['fred', 'roman']
name (str) -- name of the user to grant access to auto-mounted shared folders to
users (list of str) -- list of names of users to grant access to auto-mounted shared folders to (if specified, name will not be taken into account)
list of users who have access to auto-mounted shared folders
List users who have access to auto-mounted shared folders.
See https://www.virtualbox.org/manual/ch04.html#sf_mount_auto for more details.
CLI Example:
salt '*' vbox_guest.list_shared_folders_users
list of users who have access to auto-mounted shared folders