| 1 | <?xml version='1.0' encoding="UTF-8"?> |
1 | <?xml version='1.0' encoding="UTF-8"?> |
| 2 | |
2 | |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.12 2007/04/10 06:48:59 nightmorph Exp $ --> |
4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.13 2007/05/16 09:10:33 nightmorph Exp $ --> |
| 5 | |
5 | |
| 6 | <guide link="/doc/en/bluetooth-guide.xml"> |
6 | <guide link="/doc/en/bluetooth-guide.xml"> |
| 7 | <title>Gentoo Linux Bluetooth Guide</title> |
7 | <title>Gentoo Linux Bluetooth Guide</title> |
| 8 | |
8 | |
| 9 | <author title="Author"> |
9 | <author title="Author"> |
| … | |
… | |
| 30 | |
30 | |
| 31 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
31 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 32 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
32 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 33 | <license/> |
33 | <license/> |
| 34 | |
34 | |
| 35 | <version>1.8</version> |
35 | <version>1.9</version> |
| 36 | <date>2007-04-09</date> |
36 | <date>2007-05-16</date> |
| 37 | |
37 | |
| 38 | <chapter id="introduction"> |
38 | <chapter id="introduction"> |
| 39 | <title>Introduction</title> |
39 | <title>Introduction</title> |
| 40 | <section> |
40 | <section> |
| 41 | <title>What is Bluetooth?</title> |
41 | <title>What is Bluetooth?</title> |
| … | |
… | |
| 264 | security auto; |
264 | security auto; |
| 265 | |
265 | |
| 266 | # Pairing mode |
266 | # Pairing mode |
| 267 | pairing multi; |
267 | pairing multi; |
| 268 | |
268 | |
|
|
269 | <comment>(You only need a pin helper if you are using <=bluez-libs-2.x and <=bluez-utils-2.x) |
| 269 | <comment>(Change pin_helper to use /etc/bluetooth/pin-helper)</comment> |
270 | (Change pin_helper to use /etc/bluetooth/pin-helper)</comment> |
| 270 | # PIN helper |
271 | # PIN helper |
| 271 | pin_helper /etc/bluetooth/pin-helper; |
272 | pin_helper /etc/bluetooth/pin-helper; |
| 272 | } |
273 | } |
| 273 | |
274 | |
| 274 | # Default settings for HCI devices |
275 | # Default settings for HCI devices |
| … | |
… | |
| 301 | <p> |
302 | <p> |
| 302 | After that, we have to configure the Bluetooth device PIN. That will help in |
303 | After that, we have to configure the Bluetooth device PIN. That will help in |
| 303 | pairing this device with another one. |
304 | pairing this device with another one. |
| 304 | </p> |
305 | </p> |
| 305 | |
306 | |
| 306 | <note> |
|
|
| 307 | You can choose from different pin helpers, depending on what you want to use. |
|
|
| 308 | Available pin helpers are: <c>/usr/lib/kdebluetooth/kbluepin</c> |
|
|
| 309 | (net-wireless/kdebluetooth), <c>/usr/bin/bluepin</c> or |
|
|
| 310 | <c>/etc/bluetooth/pin-helper</c> among others. |
|
|
| 311 | </note> |
|
|
| 312 | |
|
|
| 313 | <pre caption="Editing /etc/bluetooth/pin"> |
307 | <pre caption="Editing /etc/bluetooth/pin"> |
| 314 | <comment>(Change 123456 with your desired pin number.)</comment> |
308 | <comment>(Replace 123456 with your desired pin number.)</comment> |
| 315 | 123456 |
309 | 123456 |
| 316 | </pre> |
310 | </pre> |
| 317 | |
311 | |
| 318 | <impo> |
312 | <impo> |
| 319 | This number (of your choice) must be the same in all your hosts with Bluetooth |
313 | This number (of your choice) must be the same in all your hosts with Bluetooth |
| 320 | devices so they can be paired. This number must also be kept secret since anyone |
314 | devices so they can be paired. This number must also be kept secret since anyone |
| 321 | with knowledge of this number can essentially establish connections with your |
315 | with knowledge of this number can essentially establish connections with your |
| 322 | devices. |
316 | devices. |
| 323 | </impo> |
317 | </impo> |
|
|
318 | |
|
|
319 | <note> |
|
|
320 | If you are using <c><=bluez-libs-2.x</c> and <c><=bluez-utils-2.x</c> you |
|
|
321 | can choose from different pin helpers, depending on what you want to use. |
|
|
322 | Available pin helpers are: <c>/usr/lib/kdebluetooth/kbluepin</c> |
|
|
323 | (net-wireless/kdebluetooth), <c>/usr/bin/bluepin</c> or |
|
|
324 | <c>/etc/bluetooth/pin-helper</c> among others. |
|
|
325 | </note> |
|
|
326 | |
|
|
327 | <note> |
|
|
328 | Beginning with <c>>=bluez-libs-3.x</c> and <c>>=bluez-utils-3.x</c>, pin helpers |
|
|
329 | have been replaced by passkey agents. There are a few different graphical |
|
|
330 | passkey agents available to help manage your PIN, such as <c>bluez-gnome</c> and |
|
|
331 | <c>kdebluetooth</c>. You can also use <c>passkey-agent</c> (found in |
|
|
332 | <c>bluez-utils</c>) from the command line. |
|
|
333 | </note> |
| 324 | |
334 | |
| 325 | </body> |
335 | </body> |
| 326 | </section> |
336 | </section> |
| 327 | <section> |
337 | <section> |
| 328 | <title>Services configuration</title> |
338 | <title>Services configuration</title> |