virtualbox/README



    1 
    2 README for virtualbox
    3 
    4 
    5 REQUIREMENTS
    6 
    7   Kernel headers needed to build virtualbox's modules.
    8 
    9 
   10 PRE-INSTALL
   11 
   12   -- IMPORTANT --
   13   Run the post-install script in order to add a vboxusers group to your system.
   14   After that, add your user to the vboxusers group:
   15   # usermod -a -G vboxusers <your_user> 
   16   ---------------
   17 
   18 
   19 POST-INSTALL
   20 
   21   During installation 'vboxdrv.ko' has been installed to your modules directory
   22   and you can load it using modprobe vboxdrv (needed before run VirtualBox).
   23   Also make sure you give yourself read and write access to /dev/vboxdrv.
   24   For this, virtualbox port has their own udev rules.
   25 
   26   Also is a good idea to fine tune your udev rules as you want.
   27   For getting some info from your system run udevinfo:
   28   # udevadm info -a -p /sys/class/misc/vboxdrv
   29 
   30   Udevadm info starts with the device specified by the devpath and then
   31   walks up the chain of parent devices. It prints for every device
   32   found, all possible attributes in the udev rules key format.
   33   A rule to match, can be composed by the attributes of the device
   34   and the attributes from one single parent device.
   35 
   36     looking at device '/devices/virtual/misc/vboxdrv':
   37     KERNEL=="vboxdrv"
   38     SUBSYSTEM=="misc"
   39     DRIVER==""
   40 
   41 
   42 PRECAUTION
   43 
   44   Virtualbox by default uses /usr/src/linux as the source directory of your
   45   Linux kernel. To use an alternative kernel directory you should type
   46   something like:
   47   # env KERN_DIR=/not-default-path/src/linux pkgmk
   48 
   49 
   50 NOTES
   51 
   52   Upgrading a kernel should not affect external modules. Modules which are
   53   included in the kernel are installed in: /lib/modules/$(KERNELRELEASE)/kernel
   54   And external modules are installed in: /lib/modules/$(KERNELRELEASE)/extra
   55 
   56   Anyway if you want to compile and install virtualbox modules again you have
   57   some alternatives:
   58   # make -C /usr/share/virtualbox/bin/src \
   59     MODULE_DIR=/lib/modules/$(uname -r)/extra install
   60 
   61   Or if you want to an specific kernel version (for example: 4.1.8)
   62   # make -C /usr/share/virtualbox/bin/src \
   63     KERN_DIR=/usr/src/linux-4.1.8 \
   64     MODULE_DIR=/lib/modules/4.1.8/extra install