Debian Codegraph @

README.markdown

raw ◀ ▶
1 Debian patch touch this file
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