# salt.states.vbox_guest

VirtualBox Guest Additions installer state

salt.states.vbox_guest.additions_installed(name, reboot=False, upgrade_os=False)

  Ensure that the VirtualBox Guest Additions are installed. Uses the CD, connected by VirtualBox.

  name

    The name has no functional value and is only used as a tracking reference.

  rebootFalse

    Restart OS to complete installation.

  upgrade_osFalse

    Upgrade OS (to ensure the latests version of kernel and developer tools installed).

salt.states.vbox_guest.additions_removed(name, force=False)

  Ensure that the VirtualBox Guest Additions are removed. Uses the CD, connected by VirtualBox.

  To connect VirtualBox Guest Additions via VirtualBox graphical interface press 'Host+D' ('Host' is usually 'Right Ctrl').

  name

    The name has no functional value and is only used as a tracking reference.

  force

    Force VirtualBox Guest Additions removing.

salt.states.vbox_guest.grant_access_to_shared_folders_to(name, users=None)

  Grant access to auto-mounted shared folders to the users.

  User is specified by its name. To grant access for several users use argument users.

  name

    Name of the user to grant access to auto-mounted shared folders to.

  users

    List of names of users to grant access to auto-mounted shared folders to. If specified, name will not be taken into account.