| 1 |
Bumblebee Daemon |
| 2 |
================= |
| 3 |
|
| 4 |
Bumblebee daemon is a rewrite of the original |
| 5 |
[Bumblebee](https://github.com/Bumblebee-Project/Bumblebee-old) |
| 6 |
service, providing an elegant and stable means of managing Optimus |
| 7 |
hybrid graphics chipsets. A primary goal of this project is to not only |
| 8 |
enable use of the discrete GPU for rendering, but also to enable |
| 9 |
smart power management of the dGPU when it's not in use. |
| 10 |
|
| 11 |
Build Requirements |
| 12 |
------------------- |
| 13 |
|
| 14 |
Source tarballs can be downloaded from |
| 15 |
https://github.com/Bumblebee-Project/Bumblebee/downloads |
| 16 |
|
| 17 |
The following packages are dependencies for the build process: |
| 18 |
|
| 19 |
- pkg-config |
| 20 |
- glib-2.0 and development headers |
| 21 |
- libx11 and development headers |
| •22 |
- libkmod2 and development headers |
| 23 |
- libbsd and development headers (if pidfile support is enabled, default yes) |
| 24 |
- help2man (optional, it is needed for building manual pages) |
| 25 |
|
| 26 |
If you are building from git, you will also need: |
| 27 |
|
| 28 |
- autotools (2.68+ recommended) |
| 29 |
|
| 30 |
Runtime dependencies |
| 31 |
-------------------- |
| 32 |
|
| 33 |
If you want to use `optirun` for running applications with the discrete nVidia |
| 34 |
card, you will also need: |
| 35 |
|
| 36 |
- At least one back-end for `optirun`: |
| 37 |
- [virtualgl](http://virtualgl.org/) |
| 38 |
- [primus](https://github.com/amonakov/primus) (beta) |
| 39 |
- Driver for nvidia graphics card: [nouveau](http://nouveau.freedesktop.org/) |
| 40 |
or the proprietary nvidia driver. Don't install it directly from nvidia.com |
| 41 |
as it will break 3D capabilities on the Intel graphics card and therefore |
| 42 |
affect the display of frames from the nvidia card. |
| 43 |
|
| 44 |
If you want to make use of Power Management, you will need: |
| 45 |
|
| 46 |
- [bbswitch](https://github.com/Bumblebee-Project/bbswitch) |
| 47 |
- If you're brave and want to try the `switcheroo` method, install at least the |
| 48 |
[optimus patch](http://lekensteyn.nl/files/nouveau-switcheroo-optimus.patch) |
| 49 |
(merged in Linux 3.3). Note that suspend is not yet supported by this |
| 50 |
method. |
| 51 |
|
| 52 |
Building |
| 53 |
--------- |
| 54 |
|
| 55 |
If you are building from git, you first need to run `autoreconf -fi` to generate |
| 56 |
the `configure` script. |
| 57 |
|
| 58 |
Next, run the configure script to check for dependencies and populate the |
| 59 |
`Makefile`: |
| 60 |
|
| 61 |
./configure |
| 62 |
|
| 63 |
To set the default driver to `nvidia` and adjust the library and module paths |
| 64 |
for it, use `./configure` like: |
| 65 |
|
| 66 |
./configure CONF_DRIVER=nvidia CONF_DRIVER_MODULE_NVIDIA=nvidia-current \ |
| 67 |
CONF_LDPATH_NVIDIA=/usr/lib/nvidia-current:/usr/lib32/nvidia-current \ |
| 68 |
CONF_MODPATH_NVIDIA=/usr/lib/nvidia-current/xorg,/usr/lib/xorg/modules |
| 69 |
|
| 70 |
For all available options, run: |
| 71 |
|
| 72 |
./configure --help |
| 73 |
|
| 74 |
After configuring, you can build the binaries with: |
| 75 |
|
| 76 |
make |
| 77 |
|
| 78 |
Installing System-wide and Packaging |
| 79 |
------------------------------------- |
| 80 |
|
| 81 |
You can build the binaries and set the system wide paths at configure time |
| 82 |
|
| 83 |
./configure --prefix=/usr --sysconfdir=/etc |
| 84 |
make |
| 85 |
|
| 86 |
After building the binaries and bash completion script, it can be installed |
| 87 |
together with an udev rule (unless `--without-udev-rules` was passed) using |
| 88 |
`make`: |
| 89 |
|
| 90 |
sudo make install |
| 91 |
|
| 92 |
For packagers you need to add DESTDIR=$pkgdir |
| 93 |
|
| 94 |
make install DESTDIR=$pkgdir |
| 95 |
|
| 96 |
Example initscripts are available in the `scripts/` directory. Currently, |
| 97 |
Upstart, systemd and Sys V initscripts are available. |
| 98 |
|
| 99 |
Usage |
| 100 |
------ |
| 101 |
|
| 102 |
The first time you install Bumblebee, the `bumblebee` group has to be created. |
| 103 |
Users who are allowed to use Bumblebee need to be added to the group: |
| 104 |
|
| 105 |
sudo groupadd bumblebee |
| 106 |
sudo gpasswd -a $USER bumblebee |
| 107 |
|
| 108 |
To run Bumblebee after installing it system-wide, run: |
| 109 |
|
| 110 |
sudo bumblebeed --daemon |
| 111 |
optirun -- <application> |
| 112 |
|
| 113 |
For more information, try `--help` on either of the two binaries. |
| 114 |
|
| 115 |
Interesting Links |
| 116 |
------ |
| 117 |
- Facebook: http://www.bumblebee-project.org/facebook |
| 118 |
- Twitter: http://www.bumblebee-project.org/twitter |
| 119 |
- Google Plus: http://www.bumblebee-project.org/g+ |
| 120 |
- Ubuntu wiki: https://wiki.ubuntu.com/Bumblebee |
| 121 |
- Arch wiki: https://wiki.archlinux.org/index.php/Bumblebee |
| 122 |
- Mandriva wiki: http://wiki.mandriva.com/en/Bumblebee |
| 123 |
- Debian wiki: http://wiki.debian.org/Bumblebee |