#! /bin/sh # $Id: vboxadd.sh 69564 2017-11-03 14:36:26Z vboxsync $ ## @file # Linux Additions kernel module init script ($Revision: 69564 $) # # # Copyright (C) 2006-2017 Oracle Corporation # # This file is part of VirtualBox Open Source Edition (OSE), as # available from http://www.virtualbox.org. This file is free software; # you can redistribute it and/or modify it under the terms of the GNU # General Public License (GPL) as published by the Free Software # Foundation, in version 2 as it comes in the "COPYING" file of the # VirtualBox OSE distribution. VirtualBox OSE is distributed in the # hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. # # X-Start-Before is a Debian Addition which we use when converting to # a systemd unit. X-Service-Type is our own invention, also for systemd. # chkconfig: 345 10 90 # description: VirtualBox Linux Additions kernel modules # ### BEGIN INIT INFO # Provides: vboxadd # Required-Start: # Required-Stop: # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # X-Start-Before: display-manager # X-Service-Type: oneshot # Description: VirtualBox Linux Additions kernel modules ### END INIT INFO ## @todo This file duplicates a lot of script with vboxdrv.sh. When making # changes please try to reduce differences between the two wherever possible. # Testing: # * Should fail if the configuration file is missing or missing INSTALL_DIR or # INSTALL_VER entries. # * vboxadd user and vboxsf groups should be created if they do not exist - test # by removing them before installing. # * Shared folders can be mounted and auto-mounts accessible to vboxsf group, # including on recent Fedoras with SELinux. # * Setting INSTALL_NO_MODULE_BUILDS inhibits modules and module automatic # rebuild script creation; otherwise modules, user, group, rebuild script, # udev rule and shared folder mount helper should be created/set up. # * Setting INSTALL_NO_MODULE_BUILDS inhibits module load and unload on start # and stop. # * Uninstalling the Additions and re-installing them does not trigger warnings. PATH=$PATH:/bin:/sbin:/usr/sbin PACKAGE=VBoxGuestAdditions MODPROBE=/sbin/modprobe OLDMODULES="vboxguest vboxadd vboxsf vboxvfs vboxvideo" SERVICE="VirtualBox Guest Additions" QUICKSETUP= ## systemd logs information about service status, otherwise do that ourselves. QUIET= setup_log() { test -n "${LOG}" && return 0 # Rotate log files LOG="/var/log/vboxadd-setup.log" mv "${LOG}.3" "${LOG}.4" 2>/dev/null mv "${LOG}.2" "${LOG}.3" 2>/dev/null mv "${LOG}.1" "${LOG}.2" 2>/dev/null mv "${LOG}" "${LOG}.1" 2>/dev/null } if $MODPROBE -c 2>/dev/null | grep -q '^allow_unsupported_modules *0'; then MODPROBE="$MODPROBE --allow-unsupported-modules" fi # Check architecture cpu=`uname -m`; case "$cpu" in i[3456789]86|x86) cpu="x86" ldconfig_arch="(libc6)" lib_candidates="/usr/lib/i386-linux-gnu /usr/lib /lib" ;; x86_64|amd64) cpu="amd64" ldconfig_arch="(libc6,x86-64)" lib_candidates="/usr/lib/x86_64-linux-gnu /usr/lib64 /usr/lib /lib64 /lib" ;; esac for i in $lib_candidates; do if test -d "$i/VBoxGuestAdditions"; then lib_path=$i break fi done # Preamble for Gentoo if [ "`which $0`" = "/sbin/rc" ]; then shift fi begin() { test -z "${QUIET}" && echo "${SERVICE}: ${1}" } info() { if test -z "${QUIET}"; then echo "${SERVICE}: $1" else echo "$1" fi } fail() { log "${1}" echo "$1" >&2 echo "The log file $LOG may contain further information." >&2 exit 1 } log() { setup_log echo "${1}" >> "${LOG}" } dev=/dev/vboxguest userdev=/dev/vboxuser config=/var/lib/VBoxGuestAdditions/config owner=vboxadd group=1 if test -r $config; then . $config else fail "Configuration file $config not found" fi test -n "$INSTALL_DIR" -a -n "$INSTALL_VER" || fail "Configuration file $config not complete" running_vboxguest() { lsmod | grep -q "vboxguest[^_-]" } running_vboxadd() { lsmod | grep -q "vboxadd[^_-]" } running_vboxsf() { lsmod | grep -q "vboxsf[^_-]" } running_vboxvideo() { lsmod | grep -q "vboxvideo[^_-]" } do_vboxguest_non_udev() { if [ ! -c $dev ]; then maj=`sed -n 's;\([0-9]\+\) vboxguest;\1;p' /proc/devices` if [ ! -z "$maj" ]; then min=0 else min=`sed -n 's;\([0-9]\+\) vboxguest;\1;p' /proc/misc` if [ ! -z "$min" ]; then maj=10 fi fi test -z "$maj" && { rmmod vboxguest 2>/dev/null fail "Cannot locate the VirtualBox device" } mknod -m 0664 $dev c $maj $min || { rmmod vboxguest 2>/dev/null fail "Cannot create device $dev with major $maj and minor $min" } fi chown $owner:$group $dev 2>/dev/null || { rm -f $dev 2>/dev/null rm -f $userdev 2>/dev/null rmmod vboxguest 2>/dev/null fail "Cannot change owner $owner:$group for device $dev" } if [ ! -c $userdev ]; then maj=10 min=`sed -n 's;\([0-9]\+\) vboxuser;\1;p' /proc/misc` if [ ! -z "$min" ]; then mknod -m 0666 $userdev c $maj $min || { rm -f $dev 2>/dev/null rmmod vboxguest 2>/dev/null fail "Cannot create device $userdev with major $maj and minor $min" } chown $owner:$group $userdev 2>/dev/null || { rm -f $dev 2>/dev/null rm -f $userdev 2>/dev/null rmmod vboxguest 2>/dev/null fail "Cannot change owner $owner:$group for device $userdev" } fi fi } start() { begin "Starting." # If we got this far assume that the slow set-up has been done. QUICKSETUP=yes if test -z "${INSTALL_NO_MODULE_BUILDS}"; then uname -r | grep -q -E '^2\.6|^3|^4' 2>/dev/null && ps -A -o comm | grep -q '/*udevd$' 2>/dev/null || no_udev=1 running_vboxguest || { rm -f $dev || { fail "Cannot remove $dev" } rm -f $userdev || { fail "Cannot remove $userdev" } $MODPROBE vboxguest >/dev/null 2>&1 || { setup $MODPROBE vboxguest >/dev/null 2>&1 || fail "modprobe vboxguest failed" } case "$no_udev" in 1) sleep .5;; esac } case "$no_udev" in 1) do_vboxguest_non_udev;; esac running_vboxsf || { $MODPROBE vboxsf > /dev/null 2>&1 || { if dmesg | grep "VbglR0SfConnect failed" > /dev/null 2>&1; then info "Unable to start shared folders support. Make sure that your VirtualBox build supports this feature." else info "modprobe vboxsf failed" fi } } fi # INSTALL_NO_MODULE_BUILDS # Put the X.Org driver in place. This is harmless if it is not needed. "${INSTALL_DIR}/init/vboxadd-x11" setup 2>> "${LOG}" # Install the guest OpenGL drivers. For now we don't support # multi-architecture installations rm -f /etc/ld.so.conf.d/00vboxvideo.conf rm -Rf /var/lib/VBoxGuestAdditions/lib if /usr/bin/VBoxClient --check3d 2>/dev/null; then mkdir -p /var/lib/VBoxGuestAdditions/lib ln -sf "${INSTALL_DIR}/lib/VBoxOGL.so" /var/lib/VBoxGuestAdditions/lib/libGL.so.1 # SELinux for the OpenGL libraries, so that gdm can load them during the # acceleration support check. This prevents an "Oh no, something has gone # wrong!" error when starting EL7 guests. if test -e /etc/selinux/config; then if command -v semanage > /dev/null; then semanage fcontext -a -t lib_t "/var/lib/VBoxGuestAdditions/lib/libGL.so.1" fi chcon -h -t lib_t "/var/lib/VBoxGuestAdditions/lib/libGL.so.1" fi echo "/var/lib/VBoxGuestAdditions/lib" > /etc/ld.so.conf.d/00vboxvideo.conf fi ldconfig # Mount all shared folders from /etc/fstab. Normally this is done by some # other startup script but this requires the vboxdrv kernel module loaded. # This isn't necessary anymore as the vboxsf module is autoloaded. # mount -a -t vboxsf return 0 } stop() { begin "Stopping." if test -r /etc/ld.so.conf.d/00vboxvideo.conf; then rm /etc/ld.so.conf.d/00vboxvideo.conf ldconfig fi if ! umount -a -t vboxsf 2>/dev/null; then fail "Cannot unmount vboxsf folders" fi test -n "${INSTALL_NO_MODULE_BUILDS}" || info "You may need to restart your guest system to finish removing the guest drivers." return 0 } restart() { stop && start return 0 } # Remove any existing VirtualBox guest kernel modules from the disk, but not # from the kernel as they may still be in use cleanup_modules() { log "Removing existing VirtualBox kernel modules." for i in ${OLDMODULES}; do # We no longer support DKMS, remove any leftovers. rm -rf "/var/lib/dkms/${i}"* # And remove old modules. rm -f /lib/modules/*/misc/"${i}"* done # Remove leftover module folders. for i in /lib/modules/*/misc; do test -d "${i}" && rmdir -p "${i}" 2>/dev/null done rm -f /etc/depmod.d/vboxvideo-upstream.conf } # Build and install the VirtualBox guest kernel modules setup_modules() { # don't stop the old modules here -- they might be in use test -z "${QUICKSETUP}" && cleanup_modules # This does not work for 2.4 series kernels. How sad. test -n "${QUICKSETUP}" && test -f "${MODULE_DIR}/vboxguest.ko" && return 0 info "Building the VirtualBox Guest Additions kernel modules." # We are allowed to do ">> $LOG" after we have called "log()" once. log "Building the main Guest Additions module." if ! $BUILDINTMP \ --save-module-symvers /tmp/vboxguest-Module.symvers \ --module-source $MODULE_SRC/vboxguest \ --no-print-directory install >> $LOG 2>&1; then # If check_module_dependencies.sh fails it prints a message itself. "${INSTALL_DIR}"/other/check_module_dependencies.sh 2>&1 && info "Look at $LOG to find out what went wrong" return 0 fi log "Building the shared folder support module" if ! $BUILDINTMP \ --use-module-symvers /tmp/vboxguest-Module.symvers \ --module-source $MODULE_SRC/vboxsf \ --no-print-directory install >> $LOG 2>&1; then info "Look at $LOG to find out what went wrong" return 0 fi log "Building the graphics driver module" if ! $BUILDINTMP \ --use-module-symvers /tmp/vboxguest-Module.symvers \ --module-source $MODULE_SRC/vboxvideo \ --no-print-directory install >> $LOG 2>&1; then info "Look at $LOG to find out what went wrong" fi [ -d /etc/depmod.d ] || mkdir /etc/depmod.d echo "override vboxguest * misc" > /etc/depmod.d/vboxvideo-upstream.conf echo "override vboxsf * misc" >> /etc/depmod.d/vboxvideo-upstream.conf echo "override vboxvideo * misc" >> /etc/depmod.d/vboxvideo-upstream.conf depmod return 0 } create_vbox_user() { log "Creating user for the Guest Additions." # This is the LSB version of useradd and should work on recent # distributions useradd -d /var/run/vboxadd -g 1 -r -s /bin/false vboxadd >/dev/null 2>&1 # And for the others, we choose a UID ourselves useradd -d /var/run/vboxadd -g 1 -u 501 -o -s /bin/false vboxadd >/dev/null 2>&1 } create_udev_rule() { # Create udev description file if [ -d /etc/udev/rules.d ]; then log "Creating udev rule for the Guest Additions kernel module." udev_call="" udev_app=`which udevadm 2> /dev/null` if [ $? -eq 0 ]; then udev_call="${udev_app} version 2> /dev/null" else udev_app=`which udevinfo 2> /dev/null` if [ $? -eq 0 ]; then udev_call="${udev_app} -V 2> /dev/null" fi fi udev_fix="=" if [ "${udev_call}" != "" ]; then udev_out=`${udev_call}` udev_ver=`expr "$udev_out" : '[^0-9]*\([0-9]*\)'` if [ "$udev_ver" = "" -o "$udev_ver" -lt 55 ]; then udev_fix="" fi fi ## @todo 60-vboxadd.rules -> 60-vboxguest.rules ? echo "KERNEL=${udev_fix}\"vboxguest\", NAME=\"vboxguest\", OWNER=\"vboxadd\", MODE=\"0660\"" > /etc/udev/rules.d/60-vboxadd.rules echo "KERNEL=${udev_fix}\"vboxuser\", NAME=\"vboxuser\", OWNER=\"vboxadd\", MODE=\"0666\"" >> /etc/udev/rules.d/60-vboxadd.rules fi } create_module_rebuild_script() { # And a post-installation script for rebuilding modules when a new kernel # is installed. mkdir -p /etc/kernel/postinst.d /etc/kernel/prerm.d cat << EOF > /etc/kernel/postinst.d/vboxadd #!/bin/sh test -d "/lib/modules/\${1}/build" || exit 0 KERN_VER="\${1}" /sbin/rcvboxadd quicksetup exit 0 EOF cat << EOF > /etc/kernel/prerm.d/vboxadd #!/bin/sh for i in ${OLDMODULES}; do rm -f /lib/modules/"\${1}"/misc/"\${i}".ko; done rmdir -p /lib/modules/"\$1"/misc 2>/dev/null exit 0 EOF chmod 0755 /etc/kernel/postinst.d/vboxadd /etc/kernel/prerm.d/vboxadd } shared_folder_setup() { # Add a group "vboxsf" for Shared Folders access # All users which want to access the auto-mounted Shared Folders have to # be added to this group. groupadd -r -f vboxsf >/dev/null 2>&1 # Put the mount.vboxsf mount helper in the right place. ## @todo It would be nicer if the kernel module just parsed parameters # itself instead of needing a separate binary to do that. ln -sf "${INSTALL_DIR}/other/mount.vboxsf" /sbin # SELinux security context for the mount helper. if test -e /etc/selinux/config; then # This is correct. semanage maps this to the real path, and it aborts # with an error, telling you what you should have typed, if you specify # the real path. The "chcon" is there as a back-up for old guests. command -v semanage > /dev/null && semanage fcontext -a -t mount_exec_t "${INSTALL_DIR}/other/mount.vboxsf" chcon -t mount_exec_t "${INSTALL_DIR}/other/mount.vboxsf" fi } # setup_script setup() { export BUILD_TYPE export USERNAME MODULE_SRC="$INSTALL_DIR/src/vboxguest-$INSTALL_VER" BUILDINTMP="$MODULE_SRC/build_in_tmp" chcon -t bin_t "$BUILDINTMP" > /dev/null 2>&1 test -z "${INSTALL_NO_MODULE_BUILDS}" && setup_modules create_vbox_user create_udev_rule test -z "${INSTALL_NO_MODULE_BUILDS}" && create_module_rebuild_script test -n "${QUICKSETUP}" && return 0 shared_folder_setup if running_vboxguest || running_vboxadd; then info "Running kernel modules will not be replaced until the system is restarted" fi return 0 } # cleanup_script cleanup() { if test -z "${INSTALL_NO_MODULE_BUILDS}"; then # Delete old versions of VBox modules. cleanup_modules depmod # Remove old module sources for i in $OLDMODULES; do rm -rf /usr/src/$i-* done fi # Clean-up X11-related bits "${INSTALL_DIR}/init/vboxadd-x11" cleanup 2>> "${LOG}" # Remove other files rm /sbin/mount.vboxsf 2>/dev/null if test -z "${INSTALL_NO_MODULE_BUILDS}"; then rm -f /etc/kernel/postinst.d/vboxadd /etc/kernel/prerm.d/vboxadd rmdir -p /etc/kernel/postinst.d /etc/kernel/prerm.d 2>/dev/null fi rm /etc/udev/rules.d/60-vboxadd.rules 2>/dev/null } dmnstatus() { if running_vboxguest; then echo "The VirtualBox Additions are currently running." else echo "The VirtualBox Additions are not currently running." fi } case "$2" in quiet) QUIET=yes;; esac case "$1" in start) start ;; stop) stop ;; restart) restart ;; setup) setup start ;; quicksetup) QUICKSETUP=yes setup ;; cleanup) cleanup ;; status) dmnstatus ;; *) echo "Usage: $0 {start|stop|restart|status|setup|quicksetup|cleanup} [quiet]" exit 1 esac exit