· 9 years ago · Nov 16, 2015, 08:39 PM
1 BlueZ D-Bus Control API description
2***********************************
3
4Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
5Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
6
7
8Control hierarchy
9=================
10
11Service org.bluez
12Interface org.bluez.Control
13Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
14
15Methods boolean IsConnected() {deprecated}
16
17 Returns True if connected, otherwise FALSE.
18
19 dict GetProperties()
20
21 Returns all properties for the interface. See the
22 properties section for available properties.
23
24 void VolumeUp()
25
26 Adjust remote volume one step up
27
28 void VolumeDown()
29
30 Adjust remote volume one step down
31
32Signals Connected() {deprecated}
33This package was debianized by Edd Dumbill <edd@usefulinc.com> on
34Sat, 13 Apr 2002 16:09:02 +0100.
35
36It was downloaded from http://www.bluez.org/
37
38BlueZ - Bluetooth protocol stack for Linux
39
40Copyright:
41 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
42 Copyright (C) 2006-2009 Nokia Corporation
43 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
44 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
45 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
46 Copyright (C) 2007-2008 Texas Instruments, Inc.
47 Copyright (C) 2000-2005 CSR Ltd.
48 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
49 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
50 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
51 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
52 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
53 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
54 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
55 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
56 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
57 Copyright (C) 2000-2001 Qualcomm Incorporated
58 Copyright (C) 2008 Joao Paulo Rechi Vita
59 Copyright (C) 2009 Lennart Poettering
60 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
61 Copyright (C) 2009 Intel Corporation
62
63License:
64 audio/
65 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
66 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
67 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
68 unix.c unix.h
69
70 License: GPL version 2 or any later version
71
72 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
73 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
74 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
75 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
76 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
77 ipc.c ipc.h rtp.h
78 ipctest.c
79
80 License: LGPL version 2.1 or any later version
81
82 sbc/
83 formats.h sbcdec.c sbcenc.c sbcinfo.c
84 sbctester.c
85
86 License: GPL version 2 or any later version
87
88 sbc.c sbc.h
89 sbc_math.h sbc_primitives.c sbc_primitives.h
90 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
91 sbc_primitives_neon.h sbc_tables.h
92
93 License: LGPL version 2.1 or any later version
94
95 tools/
96 ubcsp.c ubcsp.h
97
98
99
100 avctrl.c bccmd.c avinfo.c
101 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
102 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
103 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
104 hciattach_ti.c
105 hciattach.c hciconfig.c hcitool.c l2ping.c
106 hcisecfilter.c sdptool.c
107
108 License: GPL version 2 or any later version
109
110 doc/
111 All files.
112
113 License: GFDL version 1.1 or any later version
114 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
115
116 other:
117 License: GPL version 2 or any later version
118
119On Debian GNU/Linux systems, the complete text of the GNU General Public
120License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
121General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
122the GNU Free Documentation License can be found in
123`/usr/share/common-licenses/GFDL'.
124Gateway hierarchy
125========================
126
127Service org.bluez
128Interface org.bluez.HandsfreeGateway
129Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
130
131This interface is available for remote devices which can function in the Audio
132Gateway role of the HFP profiles. It is intended to be used with external
133telephony stacks / handlers of the HFP protocol.
134
135Methods void Connect()
136
137 Connect to the AG service on the remote device.
138
139 void Disconnect()
140
141 Disconnect from the AG service on the remote device
142
143 dict GetProperties()
144
145 Returns all properties for the interface. See the
146 properties section for available properties.
147
148 void RegisterAgent(object path)
149
150 The object path defines the path the of the agent
151 that will be called when a new Handsfree connection
152 is established.
153
154 If an application disconnects from the bus all of its
155 registered agents will be removed.
156
157 void UnregisterAgent(object path)
158
159 This unregisters the agent that has been previously
160 registered. The object path parameter must match the
161 same value that has been used on registration.
162
163 Possible Errors: org.bluez.Error.Failed
164 org.bluez.Error.InvalidArguments
165
166
167Signals PropertyChanged(string name, variant value)
168
169 This signal indicates a changed value of the given
170 property.
171
172Properties string State [readonly]
173
174 Indicates the state of the connection. Possible
175 values are:
176 "disconnected"
177 "connecting"
178 "connected"
179 "playing"
180
181HandsfreeAgent hierarchy
182===============
183
184Service unique name
185Interface org.bluez.HandsfreeAgent
186Object path freely definable
187
188Methods void NewConnection(filedescriptor fd, uint16 version)
189
190 This method gets called whenever a new handsfree
191 connection has been established. The objectpath
192 contains the object path of the remote device. This
193 method assumes that DBus daemon with file descriptor
194 passing capability is being used.
195
196 The agent should only return successfully once the
197 establishment of the service level connection (SLC)
198 has been completed. In the case of Handsfree this
199 means that BRSF exchange has been performed and
200 necessary initialization has been done.
201
202 Possible Errors: org.bluez.Error.InvalidArguments
203 org.bluez.Error.Failed
204
205 void Release()
206
207 This method gets called whenever the service daemon
208 unregisters the agent or whenever the Adapter where
209 the HandsfreeAgent registers itself is removed.
210 BlueZ D-Bus Input API description
211*********************************
212
213Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
214
215
216Input hierarchy
217===============
218
219Service org.bluez
220Interface org.bluez.Input
221Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
222
223Methods void Connect()
224
225 Connect to the input device.
226
227 Possible errors: org.bluez.Error.AlreadyConnected
228 org.bluez.Error.ConnectionAttemptFailed
229
230 void Disconnect()
231
232 Disconnect from the input device.
233
234 To abort a connection attempt in case of errors or
235 timeouts in the client it is fine to call this method.
236
237 Possible errors: org.bluez.Error.Failed
238
239 dict GetProperties()
240
241 Returns all properties for the interface. See the
242 properties section for available properties.
243
244 Possible Errors: org.bluez.Error.InvalidArguments
245
246Signals PropertyChanged(string name, variant value)
247
248 This signal indicates a changed value of the given
249 property.
250
251Properties boolean Connected [readonly]
252
253 Indicates if the device is connected.
254 BlueZ D-Bus Manager API description
255***********************************
256
257Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
258Copyright (C) 2005-2006 Johan Hedberg <johan.hedberg@nokia.com>
259Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
260Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
261
262
263Manager hierarchy
264=================
265
266Service org.bluez
267Interface org.bluez.Manager
268Object path /
269
270Methods dict GetProperties()
271
272 Returns all global properties. See the
273 properties section for available properties.
274
275 Possible Errors: org.bluez.Error.DoesNotExist
276 org.bluez.Error.InvalidArguments
277
278 object DefaultAdapter()
279
280 Returns object path for the default adapter.
281
282 Possible errors: org.bluez.Error.InvalidArguments
283 org.bluez.Error.NoSuchAdapter
284
285 object FindAdapter(string pattern)
286
287 Returns object path for the specified adapter. Valid
288 patterns are "hci0" or "00:11:22:33:44:55".
289
290 Possible errors: org.bluez.Error.InvalidArguments
291 org.bluez.Error.NoSuchAdapter
292
293 array{object} ListAdapters() {deprecated}
294
295 Returns list of adapter object paths under /org/bluez.
296 This method is deprecated, instead use the Adapters
297 Property to get the list of adapter object paths.
298
299 Possible errors: org.bluez.Error.InvalidArguments
300 org.bluez.Error.Failed
301 org.bluez.Error.OutOfMemory
302
303Signals PropertyChanged(string name, variant value)
304
305 This signal indicates a changed value of the given
306 property.
307
308 AdapterAdded(object adapter)
309
310 Parameter is object path of added adapter.
311
312 AdapterRemoved(object adapter)
313
314 Parameter is object path of removed adapter.
315
316 DefaultAdapterChanged(object adapter)
317
318 Parameter is object path of the new default adapter.
319
320 In case all adapters are removed this signal will not
321 be emitted. The AdapterRemoved signal has to be used
322 to detect that no default adapter is selected or
323 available anymore.
324
325Properties array{object} Adapters [readonly]
326
327 List of adapter object paths.
328 BlueZ D-Bus Network API description
329***********************************
330
331Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
332
333
334Network hierarchy
335=================
336
337Service org.bluez
338Interface org.bluez.Network
339Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
340
341Methods string Connect(string uuid)
342
343 Connect to the network device and return the network
344 interface name. Examples of the interface name are
345 bnep0, bnep1 etc.
346
347 uuid can be either one of "gn", "panu" or "nap" (case
348 insensitive) or a traditional string representation of
349 UUID or a hexadecimal number.
350
351 The connection will be closed and network device
352 released either upon calling Disconnect() or when
353 the client disappears from the message bus.
354
355 Possible errors: org.bluez.Error.AlreadyConnected
356 org.bluez.Error.ConnectionAttemptFailed
357
358 void Disconnect()
359
360 Disconnect from the network device.
361
362 To abort a connection attempt in case of errors or
363 timeouts in the client it is fine to call this method.
364
365 Possible errors: org.bluez.Error.Failed
366
367 dict GetProperties()
368
369 Returns all properties for the interface. See the
370 properties section for available properties.
371
372Signals PropertyChanged(string name, variant value)
373
374 This signal indicates a changed value of the given
375 property.
376
377Properties boolean Connected [readonly]
378
379 Indicates if the device is connected.
380
381 string Interface [readonly]
382
383 Indicates the network interface name when available.
384
385 string UUID [readonly]
386
387 Indicates the connection role when available.
388
389
390Network server hierarchy
391========================
392
393Service org.bluez
394Interface org.bluez.NetworkServer
395Object path /org/bluez/{hci0,hci1,...}
396
397Methods void Register(string uuid, string bridge)
398
399 Register server for the provided UUID. Every new
400 connection to this server will be added the bridge
401 interface.
402
403 Valid UUIDs are "gn", "panu" or "nap".
404
405 Initially no network server SDP is provided. Only
406 after this method a SDP record will be available
407 and the BNEP server will be ready for incoming
408 connections.
409
410 void Unregister(string uuid)
411
412 Unregister the server for provided UUID.
413
414 All servers will be automatically unregistered when
415 the calling application terminates.
416 BlueZ D-Bus Sim Access Profile API description
417***********************************
418
419Copyright (C) 2010 ST-Ericsson SA
420
421
422Sim Access Profile hierarchy
423============================
424
425Service org.bluez
426Interface org.bluez.SimAccess
427Object path [variable prefix]/{hci0,hci1,...}
428
429Methods void Disconnect()
430
431 Disconnects SAP client from the server.
432
433 Possible errors: org.bluez.Error.Failed
434
435 dict GetProperties()
436
437 Return all properties for the interface. See the
438 properties section for available properties.
439
440 Possible Errors: org.bluez.Error.Failed
441
442Signals PropertyChanged(string name, variant value)
443
444 This signal indicates a changed value of the given
445 property.
446
447Properties boolean Connected [readonly]
448
449 Indicates if SAP client is connected to the server.
450 BlueZ D-Bus Adapter API description
451***********************************
452
453Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
454Copyright (C) 2005-2006 Johan Hedberg <johan.hedberg@nokia.com>
455Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
456Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
457
458
459Service hierarchy
460=================
461
462Service org.bluez
463Interface org.bluez.Service
464Object path [variable prefix]/{hci0,hci1,...}
465
466Methods uint32 AddRecord(string record)
467
468 Adds a new service record from the XML description
469 and returns the assigned record handle.
470
471 Possible errors: org.bluez.Error.InvalidArguments
472 org.bluez.Error.Failed
473
474 void UpdateRecord(uint32 handle, string record)
475
476 Updates a given service record provided in the
477 XML format.
478
479 Possible errors: org.bluez.Error.InvalidArguments
480 org.bluez.Error.NotAvailable
481 org.bluez.Error.Failed
482
483 void RemoveRecord(uint32 handle)
484
485 Remove a service record identified by its handle.
486
487 It is only possible to remove service records that
488 where added by the current connection.
489
490 Possible errors: org.bluez.Error.InvalidArguments
491 org.bluez.Error.NotAuthorized
492 org.bluez.Error.DoesNotExist
493 org.bluez.Error.Failed
494
495 void RequestAuthorization(string address, uint32 handle)
496
497 Request an authorization for an incoming connection
498 for a specific service record. The service record
499 needs to be registered via AddRecord first.
500
501 Possible errors: org.bluez.Error.InvalidArguments
502 org.bluez.Error.NotAuthorized
503 org.bluez.Error.DoesNotExist
504 org.bluez.Error.Failed
505
506 void CancelAuthorization()
507
508 Possible errors: org.bluez.Error.InvalidArguments
509 org.bluez.Error.NotAuthorized
510 org.bluez.Error.DoesNotExist
511 org.bluez.Error.Failed
512 Maxim Krasnyansky <maxk@qualcomm.com>
513Marcel Holtmann <marcel@holtmann.org>
514Stephen Crane <steve.crane@rococosoft.com>
515Jean Tourrilhes <jt@hpl.hp.com>
516Jan Beutel <j.beutel@ieee.org>
517Ilguiz Latypov <ilatypov@superbt.com>
518Thomas Moser <thomas.moser@tmoser.ch>
519Nils Faerber <nils@kernelconcepts.de>
520Martin Leopold <martin@leopold.dk>
521Wolfgang Heidrich <wolfgang.heidrich@esk.fhg.de>
522Fabrizio Gennari <fabrizio.gennari@philips.com>
523Brad Midgley <bmidgley@xmission.com>
524Henryk Ploetz <henryk@ploetzli.ch>
525Philip Blundell <pb@nexus.co.uk>
526Johan Hedberg <johan.hedberg@intel.com>
527Claudio Takahasi <claudio.takahasi@indt.org.br>
528Eduardo Rocha <eduardo.rocha@indt.org.br>
529Denis Kenzior <denis.kenzior@trolltech.com>
530Frederic Dalleau <frederic.dalleau@access-company.com>
531Frederic Danis <frederic.danis@access-company.com>
532Luiz Augusto von Dentz <luiz.dentz@gmail.com>
533Fabien Chevalier <fabchevalier@free.fr>
534Ohad Ben-Cohen <ohad@bencohen.org>
535Daniel Gollub <dgollub@suse.de>
536Tom Patzig <tpatzig@suse.de>
537Kai Vehmanen <kai.vehmanen@nokia.com>
538Vinicius Gomes <vinicius.gomes@openbossa.org>
539Alok Barsode <alok.barsode@azingo.com>
540Bastien Nocera <hadess@hadess.net>
541Albert Huang <albert@csail.mit.edu>
542Glenn Durfee <gdurfee@google.com>
543David Woodhouse <david.woodhouse@intel.com>
544Christian Hoene <hoene@uni-tuebingen.de>
545Pekka Pessi <pekka.pessi@nokia.com>
546Siarhei Siamashka <siarhei.siamashka@nokia.com>
547Nick Pelly <npelly@google.com>
548Lennart Poettering <lennart@poettering.net>
549Gustavo F. Padovan <padovan@profusion.mobi>
550Marc-Andre Lureau <marc-andre.lureau@nokia.com>
551Bea Lam <bea.lam@nokia.com>
552Zygo Blaxell <zygo.blaxell@xandros.com>
553Forrest Zhao <forrest.zhao@intel.com>
554Scott Talbot <psyc@stalbot.com>
555Ilya Rubtsov <lusyaru@gmail.com>
556Mario Limonciello <mario_limonciello@dell.com>
557Filippo Giunchedi <filippo@esaurito.net>
558Jaikumar Ganesh <jaikumar@google.com>
559Elvis Pfutzenreuter <epx@signove.com>
560Santiago Carot-Nemesio <scarot@libresoft.es>
561José Antonio Santos Cadenas <jcaden@libresoft.es>
562Francisco Alecrim <francisco.alecrim@openbossa.org>
563Daniel Orstadius <daniel.orstadius@gmail.com>
564Anderson Briglia <anderson.briglia@openbossa.org>
565Anderson Lizardo <anderson.lizardo@openbossa.org>
566Bruna Moreira <bruna.moreira@openbossa.org>
567Brian Gix <bgix@codeaurora.org>
568Andre Guedes <andre.guedes@openbossa.org>
569Sheldon Demario <sheldon.demario@openbossa.org>
570Lucas De Marchi <lucas.demarchi@profusion.mobi>
571Szymon Janc <szymon.janc@tieto.com>
572 This package was debianized by Edd Dumbill <edd@usefulinc.com> on
573Sat, 13 Apr 2002 16:09:02 +0100.
574
575It was downloaded from http://www.bluez.org/
576
577BlueZ - Bluetooth protocol stack for Linux
578
579Copyright:
580 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
581 Copyright (C) 2006-2009 Nokia Corporation
582 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
583 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
584 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
585 Copyright (C) 2007-2008 Texas Instruments, Inc.
586 Copyright (C) 2000-2005 CSR Ltd.
587 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
588 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
589 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
590 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
591 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
592 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
593 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
594 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
595 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
596 Copyright (C) 2000-2001 Qualcomm Incorporated
597 Copyright (C) 2008 Joao Paulo Rechi Vita
598 Copyright (C) 2009 Lennart Poettering
599 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
600 Copyright (C) 2009 Intel Corporation
601
602License:
603 audio/
604 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
605 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
606 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
607 unix.c unix.h
608
609 License: GPL version 2 or any later version
610
611 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
612 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
613 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
614 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
615 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
616 ipc.c ipc.h rtp.h
617 ipctest.c
618
619 License: LGPL version 2.1 or any later version
620
621 sbc/
622 formats.h sbcdec.c sbcenc.c sbcinfo.c
623 sbctester.c
624
625 License: GPL version 2 or any later version
626
627 sbc.c sbc.h
628 sbc_math.h sbc_primitives.c sbc_primitives.h
629 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
630 sbc_primitives_neon.h sbc_tables.h
631
632 License: LGPL version 2.1 or any later version
633
634 tools/
635 ubcsp.c ubcsp.h
636
637 License: MIT License
638
639 Permission is hereby granted, free of charge, to any person
640 obtaining a copy of this software and associated documentation
641 files (the "Software"), to deal in the Software without
642 restriction, including without limitation the rights to use,
643 copy, modify, merge, publish, distribute, sublicense, and/or sell
644 copies of the Software, and to permit persons to whom the
645 Software is furnished to do so, subject to the following
646 conditions:
647
648
649
650 avctrl.c bccmd.c avinfo.c
651 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
652 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
653 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
654 hciattach_ti.c
655 hciattach.c hciconfig.c hcitool.c l2ping.c
656 hcisecfilter.c sdptool.c
657
658 License: GPL version 2 or any later version
659
660 doc/
661 All files.
662
663 License: GFDL version 1.1 or any later version
664 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
665
666 other:
667 License: GPL version 2 or any later version
668
669On Debian GNU/Linux systems, the complete text of the GNU General Public
670License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
671General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
672the GNU Free Documentation License can be found in
673`/usr/share/common-licenses/GFDL'.
674 BlueZ - Bluetooth protocol stack for Linux
675******************************************
676
677Copyright (C) 2000-2001 Qualcomm Incorporated
678Copyright (C) 2002-2003 Maxim Krasnyansky <maxk@qualcomm.com>
679Copyright (C) 2002-2010 Marcel Holtmann <marcel@holtmann.org>
680
681
682Compilation and installation
683============================
684
685In order to compile Bluetooth utilities you need following software packages:
686 - Linux Bluetooth protocol stack (BlueZ)
687 - GCC compiler
688 - D-Bus library
689 - GLib library
690 - USB library (optional)
691 - Lexical Analyzer (flex, lex)
692 - YACC (yacc, bison, byacc)
693
694To configure run:
695 ./configure --prefix=/usr --mandir=/usr/share/man \
696 --sysconfdir=/etc --localstatedir=/var --libexecdir=/lib
697
698Configure automatically searches for all required components and packages.
699
700To compile and install run:
701 make && make install
702
703
704Information
705===========
706
707Mailing lists:
708 linux-bluetooth@vger.kernel.org
709
710For additional information about the project visit BlueZ web site:
711 http://www.bluez.org
712 This package was debianized by Edd Dumbill <edd@usefulinc.com> on
713Sat, 13 Apr 2002 16:09:02 +0100.
714
715It was downloaded from http://www.bluez.org/
716
717BlueZ - Bluetooth protocol stack for Linux
718
719Copyright:
720 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
721 Copyright (C) 2006-2009 Nokia Corporation
722 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
723 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
724 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
725 Copyright (C) 2007-2008 Texas Instruments, Inc.
726 Copyright (C) 2000-2005 CSR Ltd.
727 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
728 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
729 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
730 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
731 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
732 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
733 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
734 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
735 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
736 Copyright (C) 2000-2001 Qualcomm Incorporated
737 Copyright (C) 2008 Joao Paulo Rechi Vita
738 Copyright (C) 2009 Lennart Poettering
739 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
740 Copyright (C) 2009 Intel Corporation
741
742License:
743 audio/
744 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
745 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
746 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
747 unix.c unix.h
748
749 License: GPL version 2 or any later version
750
751 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
752 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
753 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
754 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
755 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
756 ipc.c ipc.h rtp.h
757 ipctest.c
758
759 License: LGPL version 2.1 or any later version
760
761 sbc/
762 formats.h sbcdec.c sbcenc.c sbcinfo.c
763 sbctester.c
764
765 License: GPL version 2 or any later version
766
767 sbc.c sbc.h
768 sbc_math.h sbc_primitives.c sbc_primitives.h
769 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
770 sbc_primitives_neon.h sbc_tables.h
771
772 License: LGPL version 2.1 or any later version
773
774 tools/
775 ubcsp.c ubcsp.h
776
777 License: MIT License
778
779 avctrl.c bccmd.c avinfo.c
780 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
781 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
782 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
783 hciattach_ti.c
784 hciattach.c hciconfig.c hcitool.c l2ping.c
785 hcisecfilter.c sdptool.c
786
787 License: GPL version 2 or any later version
788
789 doc/
790 All files.
791
792 License: GFDL version 1.1 or any later version
793 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
794
795 other:
796 License: GPL version 2 or any later version
797
798On Debian GNU/Linux systems, the complete text of the GNU General Public
799License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
800General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
801the GNU Free Documentation License can be found in
802`/usr/share/common-licenses/GFDL'.
803 This package was debianized by Edd Dumbill <edd@usefulinc.com> on
804Sat, 13 Apr 2002 16:09:02 +0100.
805
806It was downloaded from http://www.bluez.org/
807
808BlueZ - Bluetooth protocol stack for Linux
809
810Copyright:
811 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
812 Copyright (C) 2006-2009 Nokia Corporation
813 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
814 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
815 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
816 Copyright (C) 2007-2008 Texas Instruments, Inc.
817 Copyright (C) 2000-2005 CSR Ltd.
818 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
819 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
820 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
821 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
822 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
823 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
824 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
825 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
826 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
827 Copyright (C) 2000-2001 Qualcomm Incorporated
828 Copyright (C) 2008 Joao Paulo Rechi Vita
829 Copyright (C) 2009 Lennart Poettering
830 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
831 Copyright (C) 2009 Intel Corporation
832
833License:
834 audio/
835 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
836 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
837 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
838 unix.c unix.h
839
840 License: GPL version 2 or any later version
841
842 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
843 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
844 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
845 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
846 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
847 ipc.c ipc.h rtp.h
848 ipctest.c
849
850 License: LGPL version 2.1 or any later version
851
852 sbc/
853 formats.h sbcdec.c sbcenc.c sbcinfo.c
854 sbctester.c
855
856 License: GPL version 2 or any later version
857
858 sbc.c sbc.h
859 sbc_math.h sbc_primitives.c sbc_primitives.h
860 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
861 sbc_primitives_neon.h sbc_tables.h
862
863 License: LGPL version 2.1 or any later version
864
865 tools/
866 ubcsp.c ubcsp.h
867
868 License: MIT License
869
870
871
872 avctrl.c bccmd.c avinfo.c
873 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
874 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
875 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
876 hciattach_ti.c
877 hciattach.c hciconfig.c hcitool.c l2ping.c
878 hcisecfilter.c sdptool.c
879
880 License: GPL version 2 or any later version
881
882 doc/
883 All files.
884
885 License: GFDL version 1.1 or any later version
886 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
887
888 other:
889 License: GPL version 2 or any later version
890
891On Debian GNU/Linux systems, the complete text of the GNU General Public
892License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
893General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
894the GNU Free Documentation License can be found in
895`/usr/share/common-licenses/GFDL'.
896
897 bluez-cups
898
899To configure a Bluetooth printer, set it up in CUPS like it was connected to
900your parallel or USB port. Then edit your /etc/cups/printers.conf and replace
901the device URI with a bluetooth one.
902
903The printer's URI will look something like this: bluetooth://00408C5E5DA4/spp
904If your printer uses HCRP (hardcopy cable replacement protocol) then remove
905the "/spp" from the end. SPP is serial port protocol.
906
907 -- Edd Dumbill <ejad@debian.org>, Fri Jul 16 19:25:21 BST 2004
908 This package was debianized by Scott Ritchie <scott@open-vote.org> on
909Wed, 03 Jun 2009 10:48:48 -0700.
910
911Copyright:
912
913 Andreas Røsdal <andreasr@gnome.org>:
914 gnome-games/gnometris/pixmaps/gnometris.svg GPL-2.0+ and CC-BY-SA-3.0+
915 Mads Rosendahl Hansen <madsrh@gmail.com>:
916 gnome-games/pixmaps/baize.png GPL-2.0+
917 gnome-games/pixmaps/slot.svg GPL-2.0+
918 gnome-games-common/cards/gnomangelo_bitmap.svg GPL-2.0+
919 gnome-games/mahjongg/pixmaps/postmodern.svg GPL-2.0+
920
921
922
923
924The Debian packaging is copyright 2009, Scott Ritchie <scott@open-vote.org> and
925is licensed under the GPL-2.0+
926
927On Debian systems, the complete text of the GNU General
928Public License can be found in `/usr/share/common-licenses/GPL-2'.
929 This package was debianized by Ondřej Surý <ondrej@debian.org> on
930Fri, 12 May 2006 15:46:36 +0200.
931
932It was downloaded from:
933 http://ftp.gnome.org/pub/GNOME/sources/brasero/
934
935Upstream Author:
936 Philippe Rouquier <bonfire-app@wanadoo.fr>
937
938Copyright:
939
940 Copyright © 2005-2009 Philippe Rouquier
941 Copyright © 2008 Lin Ma
942 Copyright © 2008 Joe Marcus Clarke
943 Copyright © 2009 Joan Duran
944 Copyright © 2005 William Jon McCann
945 Copyright © 2003, 2007 Novell, Inc.
946 Copyright © 1999-2004 Red Hat, Inc.
947 Copyright © 2008 Luis Medinas
948 Copyright © 2006 Paolo Borelli
949 Copyright © 2001 George Lebl
950
951
952License for Brasero:
953
954 Brasero is free software: you can redistribute it and/or modify it
955 under the terms of the GNU General Public License as published by the
956 Free Software Foundation, either version 3 of the License, or
957 (at your option) any later version.
958
959 Brasero is distributed in the hope that it will be useful, but
960 WITHOUT ANY WARRANTY; without even the implied warranty of
961 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
962 See the GNU General Public License for more details.
963
964 You should have received a copy of the GNU General Public License along
965 with this program. If not, see <http://www.gnu.org/licenses/>.
966
967On Debian systems, the complete text of the GNU General
968Public License can be found in `/usr/share/common-licenses/GPL-3'.
969
970
971libbrasero-media is licensed under the following terms:
972
973 This package is free software; you can redistribute it and/or modify
974 it under the terms of the GNU General Public License as published by
975 the Free Software Foundation; either version 2 of the License, or
976 (at your option) any later version.
977
978 This package is distributed in the hope that it will be useful,
979 but WITHOUT ANY WARRANTY; without even the implied warranty of
980 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
981 GNU General Public License for more details.
982
983 You should have received a copy of the GNU General Public License
984 along with this package; if not, write to the Free Software
985 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
986
987 The Libbrasero-media authors hereby grant permission for non-GPL compatible
988 GStreamer plugins to be used and distributed together with GStreamer
989 and Libbrasero-media. This permission is above and beyond the permissions
990 granted by the GPL license by which Libbrasero-media is covered. If
991 you modify this code you may extend this exception to your version of
992 the code, but you are not obligated to do so. If you do not wish to
993 do so, delete this exception statement from your version.
994
995On Debian systems, the complete text of the GNU General
996Public License can be found in `/usr/share/common-licenses/GPL-2'.
997
998
999License for src/egg* and src/baobab*:
1000 This package was debianized by Ondřej Surý <ondrej@debian.org> on
1001Fri, 12 May 2006 15:46:36 +0200.
1002
1003It was downloaded from:
1004 http://ftp.gnome.org/pub/GNOME/sources/brasero/
1005
1006Upstream Author:
1007 Philippe Rouquier <bonfire-app@wanadoo.fr>
1008
1009Copyright:
1010
1011 Copyright © 2005-2009 Philippe Rouquier
1012 Copyright © 2008 Lin Ma
1013 Copyright © 2008 Joe Marcus Clarke
1014 Copyright © 2009 Joan Duran
1015 Copyright © 2005 William Jon McCann
1016 Copyright © 2003, 2007 Novell, Inc.
1017 Copyright © 1999-2004 Red Hat, Inc.
1018 Copyright © 2008 Luis Medinas
1019 Copyright © 2006 Paolo Borelli
1020 Copyright © 2001 George Lebl
1021
1022
1023License for Brasero:
1024
1025 Brasero is free software: you can redistribute it and/or modify it
1026 under the terms of the GNU General Public License as published by the
1027 Free Software Foundation, either version 3 of the License, or
1028 (at your option) any later version.
1029
1030 Brasero is distributed in the hope that it will be useful, but
1031 WITHOUT ANY WARRANTY; without even the implied warranty of
1032 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
1033 See the GNU General Public License for more details.
1034
1035 You should have received a copy of the GNU General Public License along
1036 with this program. If not, see <http://www.gnu.org/licenses/>.
1037
1038On Debian systems, the complete text of the GNU General
1039Public License can be found in `/usr/share/common-licenses/GPL-3'.
1040
1041
1042libbrasero-media is licensed under the following terms:
1043
1044 This package is free software; you can redistribute it and/or modify
1045 it under the terms of the GNU General Public License as published by
1046 the Free Software Foundation; either version 2 of the License, or
1047 (at your option) any later version.
1048
1049 This package is distributed in the hope that it will be useful,
1050 but WITHOUT ANY WARRANTY; without even the implied warranty of
1051 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1052 GNU General Public License for more details.
1053
1054 You should have received a copy of the GNU General Public License
1055 along with this package; if not, write to the Free Software
1056 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1057
1058 The Libbrasero-media authors hereby grant permission for non-GPL compatible
1059 GStreamer plugins to be used and distributed together with GStreamer
1060 and Libbrasero-media. This permission is above and beyond the permissions
1061 granted by the GPL license by which Libbrasero-media is covered. If
1062 you modify this code you may extend this exception to your version of
1063 the code, but you are not obligated to do so. If you do not wish to
1064 do so, delete this exception statement from your version.
1065
1066On Debian systems, the complete text of the GNU General
1067Public License can be found in `/usr/share/common-licenses/GPL-2'.
1068
1069
1070License for src/egg* and src/baobab*:
1071
1072 This package is free software; you can redistribute it and/or
1073 modify it under the terms of the GNU Lesser General Public
1074 License as published by the Free Software Foundation; either
1075 version 2 of the License, or (at your option) any later version.
1076
1077 This package is distributed in the hope that it will be useful,
1078 but WITHOUT ANY WARRANTY; without even the implied warranty of
1079 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1080 Lesser General Public License for more details.
1081
1082 You should have received a copy of the GNU Lesser General Public
1083 License along with this package; if not, write to the Free Software
1084 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1085
1086On Debian systems, the complete text of the GNU Lesser General
1087Public License can be found in `/usr/share/common-licenses/LGPL-2'.
1088
1089The help is licensed under the GFDL:
1090
1091 Permission is granted to copy, distribute and/or modify this
1092 document under the terms of the GNU Free Documentation
1093 License (GFDL), Version 1.1 or any later version published
1094 by the Free Software Foundation with no Invariant Sections,
1095 no Front-Cover Texts, and no Back-Cover Texts.
1096
1097On Debian systems, the complete text of the GNU Lesser General
1098Public License can be found in `/usr/share/common-licenses/GFDL'.
1099 AUTHORS:
1100
1101Philippe Rouquier <bonfire-app@wanadoo.fr>
1102
1103Report bugs at:
1104http://bugzilla.gnome.org/enter_bug.cgi?product=brasero
1105 Brasero is a CD/DVD mastering tool for the GNOME Desktop. It is designed to be simple and easy to use.
1106
1107Features:
1108
1109Data CD/DVD:
1110- supports edition of discs contents (remove/move/rename files inside directories)
1111- can burn data CD/DVD on the fly
1112- automatic filtering for unwanted files (hidden files, broken/recursive symlinks, files not conforming to joliet standard, ...)
1113- supports multisession
1114- supports joliet extension
1115- can write the image to the hard drive
1116
1117Audio CD:
1118- write CD-TEXT information (automatically found thanks to gstreamer)
1119- supports the edition of CD-TEXT information
1120- can burn audio CD on the fly
1121- can use all audio files handled by GStreamer local installation (ogg, flac, mp3, ...)
1122- can search for audio files inside dropped folders
1123- can insert a pause
1124- can split a track
1125
1126CD/DVD copy:
1127- can copy a CD/DVD to the hard drive
1128- can copy DVD and CD on the fly
1129- supports single-session data DVD
1130- supports any kind of CD
1131- can copy encrypted Video DVDs (needs libdvdcss)
1132
1133Others:
1134- erase CD/DVD
1135- can save/load projects
1136- can burn CD/DVD images and cue files
1137- song, image and video previewer
1138- device detection thanks to HAL
1139- file change notification (requires kernel > 2.6.13)
1140- supports Drag and Drop / Cut'n'Paste from nautilus (and others apps)
1141- can use files on a network as long as the protocol is handled by gnome-vfs
1142- can search for files thanks to beagle (search is based on keywords or on file type)
1143- can display a playlist and its contents (note that playlists are automatically searched through beagle)
1144- all disc IO is done asynchronously to prevent the application from blocking
1145- Brasero default backend is provided by cdrtools/cdrkit but libburn can be used as an alternative
1146
1147
1148Notes on plugins for advanced users
1149
11501. configuration
1151
1152From the UI you can only configure (choose to use or not to use mostly) non essential plugins; that is all those that don't burn, blank, or image.
1153If you really want to choose which of the latters you want brasero to use, one simple solution is to remove the offending plugin from brasero plugin directory ("install_path"/lib/brasero/plugins/) if you're sure that you won't want to use it.
1154You can also set priorities between plugins. They all have a hardcoded priority that can be overriden through Gconf. Each plugin has a key in "/apps/brasero/config/priority".
1155If you set this key to -1 this turns off the plugin.
1156If you set this key to 0 this leaves the internal hardcoded priority - the default that basically lets brasero decide what's best.
1157If you set this key to more than 0 then that priority will become the one of the plugin - the higher, the more it has chance to be picked up.
1158
11592. additional note
1160
1161Some plugins have overlapping functionalities (i.e. libburn/wodim/cdrecord/growisofs, mkisofs/libisofs/genisoimage); but they don't always do the same things or sometimes they don't do it in the same way. Some plugins have a "speciality" where they are the best. That's why it's usually good to have them all around
1162As examples, from my experience:
1163- growisofs is good at handling DVD+RW and DVD-RW restricted overwrite
1164- cdrdao is best for on the fly CD copying
1165- libburn returns a progress when it blanks/formats
1166
1167
1168Requirements:
1169- gtk+ >= 3.x
1170- gnome 3.x (gio)
1171- gstreamer (>=0.10.0)
1172- libxml2
1173- cdrtools or cdrkit
1174- growisofs
1175- a fairly new kernel (>= 2.6.13 because of inotify) (optional)
1176- cairo
1177- libcanberra
1178- totem (>= 3.0) (optional)
1179- tracker (>= 0.10.0) (optional)
1180- libburn (>=0.4.0) (optional)
1181- libisofs (>=0.6.2) (optional)
1182 This package was debianized by Ondřej Surý <ondrej@debian.org> on
1183Fri, 12 May 2006 15:46:36 +0200.
1184
1185It was downloaded from:
1186 http://ftp.gnome.org/pub/GNOME/sources/brasero/
1187
1188Upstream Author:
1189 Philippe Rouquier <bonfire-app@wanadoo.fr>
1190
1191Copyright:
1192
1193 Copyright © 2005-2009 Philippe Rouquier
1194 Copyright © 2008 Lin Ma
1195 Copyright © 2008 Joe Marcus Clarke
1196 Copyright © 2009 Joan Duran
1197 Copyright © 2005 William Jon McCann
1198 Copyright © 2003, 2007 Novell, Inc.
1199 Copyright © 1999-2004 Red Hat, Inc.
1200 Copyright © 2008 Luis Medinas
1201 Copyright © 2006 Paolo Borelli
1202 Copyright © 2001 George Lebl
1203
1204
1205License for Brasero:
1206
1207 Brasero is free software: you can redistribute it and/or modify it
1208 under the terms of the GNU General Public License as published by the
1209 Free Software Foundation, either version 3 of the License, or
1210 (at your option) any later version.
1211
1212 Brasero is distributed in the hope that it will be useful, but
1213 WITHOUT ANY WARRANTY; without even the implied warranty of
1214 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
1215 See the GNU General Public License for more details.
1216
1217 You should have received a copy of the GNU General Public License along
1218 with this program. If not, see <http://www.gnu.org/licenses/>.
1219
1220On Debian systems, the complete text of the GNU General
1221Public License can be found in `/usr/share/common-licenses/GPL-3'.
1222
1223
1224
1225On Debian systems, the complete text of the GNU General
1226Public License can be found in `/usr/share/common-licenses/GPL-2'.
1227
1228
1229License for src/egg* and src/baobab*:
1230
1231 This package is free software; you can redistribute it and/or
1232 modify it under the terms of the GNU Lesser General Public
1233 License as published by the Free Software Foundation; either
1234 version 2 of the License, or (at your option) any later version.
1235
1236 This package is distributed in the hope that it will be useful,
1237 but WITHOUT ANY WARRANTY; without even the implied warranty of
1238 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1239 Lesser General Public License for more details.
1240
1241 You should have received a copy of the GNU Lesser General Public
1242 License along with this package; if not, write to the Free Software
1243 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1244
1245On Debian systems, the complete text of the GNU Lesser General
1246Public License can be found in `/usr/share/common-licenses/LGPL-2'.
1247
1248The help is licensed under the GFDL:
1249
1250 Permission is granted to copy, distribute and/or modify this
1251 document under the terms of the GNU Free Documentation
1252 License (GFDL), Version 1.1 or any later version published
1253 by the Free Software Foundation with no Invariant Sections,
1254 no Front-Cover Texts, and no Back-Cover Texts.
1255
1256On Debian systems, the complete text of the GNU Lesser General
1257Public License can be found in `/usr/share/common-licenses/GFDL'.
1258 This directory contains the BRLTTY driver for the Albatross
1259[http://www.tivomatic.fi/html/albatross.html] braille display from Tivomatic
1260[http://www.tivomatic.fi/]. It has been implemented, and is being maintained,
1261by Dave Mielke <dave@mielke.cc> and Sami Haahtinen <ressu@ressukka.net>.
1262
1263
1264The keys on the front of the display are named as depicted below within the
1265documentation for this driver. See the help file for what they do.
1266
1267 +---+ +---+ +------+ +-----------+ +-----------+ +------+ +---+ +---+
1268 |Top| |Bak| | Up | | | | | | Up | |Bak| |Top|
1269 +---+ +---+ +------+ | | | | +------+ +---+ +---+
1270 | Left | | Right |
1271 +---+ +---+ +------+ | | | | +------+ +---+ +---+
1272 |Bot| |Csr| | Down | | | | | | Down | |Csr| |Bot|
1273 +---+ +---+ +------+ +-----------+ +-----------+ +------+ +---+ +---+
1274
1275
1276The keys on the top of the display are named as depicted below within the
1277documentation for this driver. See the help file for what they do.
1278
1279 +---+ +-------+ +---+ +---+ +-------+ +---+
1280 |Hlp| +---+ | Paste | +---+ |Prf| |PrU| +---+ | DifUp | +---+ |PgU|
1281 +---+ |mwp| +-------+ |gwp| +---+ +---+ |iup| +-------+ |idn| +---+
1282 |RF1| |RF2| |RF3| |RF4|
1283 +---+ |ctn| +-------+ |cta| +---+ +---+ |ctl| +-------+ |ctr| +---+
1284 |Lrn| +---+ | Track | +---+ |Stt| |PrD| +---+ | DifDn | +---+ |PgD|
1285 +---+ +-------+ +---+ +---+ +-------+ +---+
1286 Both the keyboard and the serial ports of the Inka should be connected in order
1287to use it with BRLTTY. The Inka itself is capable of communicating entirely via
1288the keyboard port, but the Linux kernel keyboard driver can't handle this.
1289
1290In order to use the Inka with BRLTTY it is necessary to have the latest version
1291(dated 1998) of the firmware. If the Inka says either "mode 1" or "mode 2" at
1292the end of the version number after it's connected to a computer and turned on
1293then it has the necessary firmware. If it doesn't then it'll probably need an
1294upgrade. To do this, contact Baum and give them the serial number of the Inka
1295(which is printed on the under side of the device).
1296
1297The newer firmware supports two modes of operation. Mode 1 uses the old Inka
1298protocol and transfers data at 57,600 baud with non-standard flow control. Mode
12992 uses the new Inka protocol and transfers data at 19,200 baud with no flow
1300control.
1301
1302The Inka defaults to mode 1. This is shown on the braille display when
1303the Inka first initializes or after a soft reset.
1304
1305Before running BRLTTY, change the Inka to mode 2 by pressing tl1+tl2+tr3 (which
1306is the digit 2 represented as a dot-six number). To return to mode 1 (neither
1307necessary nor desirable under Linux), press tl1+tr3 (which is the digit 1
1308represented as a dot-six number). The new mode setting is shown on the display
1309at the end of the line, after the version number and date of the firmware.
1310 ‹ •XÛrÛF}ÇWÃŒ:‘Ö,_’x•+%1±b‰V‘ŒcW*Â¥CrJ †™ˆbþxÿbÃéHÚ²Sµ.?ˆ¸ôôåœÓÃ8õÚV•Q—6uîÃÂñjæ¼: ]N&ï³l²°Aá¿VSµ*wOÄ…Q§•þÛ5¨ç¶6ÆÛz®N÷ æÙÚÛM¦5´·
1311[©¡¶¾—Âm\(]–6ZW 5ón‰
1312Wé ®môF}WãçO³ª¹Ç ymâ™®Kumè§Qouˆ®—Ã?¼ZºÒÎl¡“9Å“6Žÿ]-tÂgÃÆÕê»Â—üã§;[½«óBÿÃËþ…¨}¤ëýfÞ„¨ž ?óìÔÃÃ…6ÉÎÓ—Š¼8VaᚪTkço{rÂ>¦©vkU¸Òà ŠŽÃsâ„¢n¢;*áx%kÂ¥
1313«JoTܬ¢l€,¨i:(_¨èT0ŸÂê¦ô'óˆà –FÃŒŽÂ7o½©SvöÔÆ5Âo´Âž¿øê¨X8_Š…Uû70u4©‚Ù£°2¦X¨©»gÃ#Ã¥Ã_Âõ¦d r¥Þdšï
1314—ž6uK´{oc
1315¦ÔzajC¼Ã±µ
1316Å“7¡æ_ ù¯,½ªu…ªÖ…T’eÀ™&üþÓ_ îÔÊùÂrEÃwºj jQÃì ï—™M Û%zfSÃw±ä„»ù ìö˜Œk ¸Þi:Õ>(`ÊFäåÔW1n䙩ɪYeÃui¸#²ö«^â„¢YTà ·óE …]6a, “'7š—ÈB ¶YÖ"(y›ÃOçÇƨ…©Vyð…P|5¡ðvÃ…d*7s·f£¦¶.áóûÊ‚H~s’}Șžê¯<è
13172<ë)Ô0ÃÄqþUþôø$;êžôu¦n§f‰â⇛Ã裮7L{4÷SȉLÔêìê||3>
1318Cu`kaÞŠÄ+Å¡J{‚Š‰ÒâÞÚÕ_G l"t\éýÊ›x†µ4u#6pÜÒysËœ?à J{à úa ÿ¡ÿe €?ç uªwPd· ¶©N‹4(«§®¼ÑåFià óÎ<<óg3õÂö›O ûr{,Rqs9è†=ùsøîzôæêzò„?®Gé‡à ˜ÆïÎßLƹ“I Æ’~Û¿¼¹îÂǯ ï•™à AÂ)A¥«Â$®™/Ëœ] …&œ‹F¸±S]ÃœLˆtYF¯Ã6uQB ¤x®}ù ÔÆx¾H‡f Û‡fÃŽ*ƒøK©‘hÔ Ã…qx˜š_uý™Ì|³ÃLgZÃ{6º9ûmÒ¿¾ ÃS:äÂåÅp«‘™Š6™¸zs:ø%ÉywaûÂG¿^]SÃ`CQß !·%ÃÅ’ “«þè5ßIvF7¿¼™¼áµ\AB
13194BñFûÙœ0â„¢ZÆ’{¾ ]¤pË%Ã-]lA IضÉK ‰KZœ«ßMóÄS¡«
1320ÈÂoÃ’tû;¤zý¯ÿ#Â_#Â?Û{#®Ã-d·m‚h\
1321ꛣ—Ô²ÓKôõDÄB¯‚¤¯ˆ¾ú¹ÎMa–S†ÃòÃs¿Â¹WÆ’IŸšEÂÃ¥j 3Go¯ÃÚNm’„Ç„ñÙ«þHš…š ÞM&£þp,!Cá `3ÌÈT
1322Â¥YÂÅ’' “¾êjÂ7AU®¸%D+Õ¸™ µebâñ¼k…µÃãõ ®cd‘n8EŸà -Ϙ ÃŽ!Hó™8_ ÃŽV›µš£Ãy[léùoÈTk6,Õ^nQ¨\è)4,ècª.5r¡wÃ"IßTâ€UÂüŠÂhlÛ;¡²Ã¡•DmººÈ`(µ5©C×Nq…ºÃSSpumÃ’SĖYÿzðqà RúsÞ¿²¦ºÅl16«ø¹L<G&ŠÊˆ_uB
1323‚zÃß5½žâ€r6îŸÂúÃ<;WÒþú×rTÃæÇTÃMØ›?Õóü8Wgm)E’wANSÔ:„f¹WHtç^kªÂUPýÂÄuâ€h•FÃŽ
1324 C±à ¯;ëcÅó––=VˆÒ‘5ÃÙœÙêÖ çÃòO9z¶¹nTÙö› ¸Q\ŒÄº²
1325S{ÄÊ^—„ø4s‰Z cRÜ_Sòa
1326là ä¦3ð)4ÿ“ƒO?£ÂÂÃÓþÙëN¯ƿôAÑ‹Ó‡Ö÷æçÎâ€Ãž Q7<·Ç©aÉaeܪj1(“qÂHdIan¢TÚCu½ÆD²IM™¶£ø
1327±ÑeB;‡ Ã…i€j·‚¤éܶ¾D«fUµkÂÞ<Ä“¶AWÃñ¤Õ£Aÿü
1328Ô8ú-pÃŽe¹b{gǨ—Ã^@ Ã…y˜õ—ºsMgiPŽ‘yñ7dR‹÷öߤ÷ñà f+€¬üvVñ-¸5S· ÂïÃMú?uÚKÓ²õ
1329ÔfK
1330?e6ñª oÉ“$WÅ’ -[ ç¤&ì¨$1â„¢4›)L `"ÀüyHŠºÌጒËN ÃÓ¹BªfMÅÛTPÔ )ÿÃÆ’ €Ó3à S w;Éžã 1Fûáé³oÔAh0Ã@º(ؼ%ÿKÅ’~êÃôκ& ã²&´Â±Ã}2®%aÊæ"èë0a â€Ã‡Â:¶m’ö÷ ê¼C.Âoêb–:‘K5´¡ÃÞLÙ ^î)V ®ÓTfBùòŽ-ô^Ž_]ü<‘“™3!à ¸8Qþn;Ù“WÚ jâ€pWºÜ-k(}åÜm—®Ã¿äêM}øბ¹®Qß'ìà üC ßÂ1´ž½:ìÉ(‰i*K3¼ž{½Z>qz9|}9ÄISâ„¢&úöy•
1331=PXÅ¡8ÿ~19{õvr3Dâ€â€¡Ã¹N<:•>xöâëCñûŒfÚÇ5£]Å¡]UÚ[`
1332fà FÓ3GÞ¤]¶D]¢¡Šw;¢tG. \¸ÓÒQáÓfîW2WkÚÙ¢@È%£Ô^Æ’Ân_… C²7$ñz´›Ù“<³p°Ã±¥’‡½t¦ ËÔeêf·¶ ÷>º K‚6²`ÙºI NTsÃm6â„¢ †1Úæt*M[ÔÀ•Ñœ›šszÂ,SÇž:·Â<vž¦ÃT¯Ù¹kG›Ã¬„ â„¢nv}ß¾ŽkÓœ9*à ‰k‚Hh
1333Vµ(YN[ ¶,!z R>˜°ÞS€=ÕäGw“‹K
1334¸×«K䯈 <ï©·Úf Ü’¿ìÔã¤kÞ´ÂysÃ’^O?C{‰=iƒ¢•áé‰:ë§îÚ§ž¨/º‡Ú!BºÛFÕ¶ ËlŒ»ð<å¶ÃÛ¶{Ñøà BsÇu9Â¥c÷i läÚ¼=°ýH¶ýê Ÿö ÊbÊîþ‰Z>ˆè©…Gh³ÞAñ–Û·n;Û
1335K-åÀ,ý‰#aiKQÅèæsJ4fî¹(,¿IEaid8®•Ÿèe mû‚@JÂðÒÂû÷LÂ/ëצ€ YÖÆz:2'éC {ˉL;„þÂUß«ão•Uß©)b3áïo1A¯K õ öñã?q[®‹äÿ±½ó矇ßf€©ÌR²¡ 0ȉ
1336 „êˤz¨
1337ë‹f‰œÊ÷:߀‰>}ÃÈÂG\fõ¨Ž–ßòø!®·k#RH„Õi'?Ù.sl±Z·á§£°°³˜$‰ÛzÂ
1338Â+Ëj…º$žù•Êpp‰ô©Ãɸ }SÄ M†¾Ébâ€P2/
1339j"§ziéDÃãÇl„ö²„9ÙÎkÂ%Û'ÿ(Ñ@êM
1340ÒïÕUÿ ¿Ôl¯ ui ^ôÔS¤µCÃŒ6㼏WÊ@¾o‘ƒ3]h¿%´Æ²¦NeÉ–Ã
1341Jæ¥R
1342¾4…mÑð› ût+Uh=6pWᇨŒgÖ£³k?o„<±3ßk!¿ÇKˆŒÂâ\Td†Â*ëzÃÇ\Ã'jÎõó8ÉÚådÜŒDË,’û?TU8Å¡]
1343
1344 This driver allows BRLTTY to access braille displays through BrlAPI. Multiple
1345instances of brltty can hence be run, one using the real braille driver, the
1346others accessing it through the API. Each instance of BRLTTY can use a different
1347screen driver thanks to the -x command-line option.
1348
1349
1350For example, in a gnome desktop you can run a second BRLTTY that reads
1351gnome-terminal by running
1352
1353brltty -b ba -x as
1354
1355from your X session.
1356
1357
1358Another example is accessing the Linux console of a remote host:
1359
1360ssh -R 4102:localhost:4101 root@theremotehost brltty -b ba -B host=localhost:1
1361
1362This will forward your local BrlAPI port (4101) to the remote machine (as 4102,
1363i.e. :1), where you can then run brltty and tell it to connect to localhost:1.
1364This will however take complete control of your braille device. To restrict the
1365control to some local console (e.g. console 4), you can use e.g.
1366
1367ssh -R 4102:localhost:4101 root@theremotehost WINDOWPATH=4 brltty -b ba -B host=localhost:1
1368 Adi Dascal <ad@baum.ro>
1369Alex Bernier <alex.bernier@free.fr>
1370Andreas Gross <andi@andi-bika.de>
1371Attila Hammer <hammera@pickup.hu>
1372August Hörandl <august.hoerandl@gmx.at>
1373Boris Daix <Boris.Daix@insa-lyon.fr>
1374Cheryl Homiak <chomiak@shellworld.net>
1375Christian Comaschi <christian_comaschi@libero.it>
1376Coscell Kao <coscell@molerat.net>
1377Daniel Dalton <d.dalton@iinet.net.au>
1378Dave Mielke <dave@mielke.cc>
1379David Sauer <sauer@brailcom.cz>
1380Hans Schou <chlor@schou.dk>
1381Helge Havnegjerde <helge.havnegjerde@c2i.net>
1382Hermann Bender <meinelisten@onlinehome.de>
1383James Teh <jamie@jantrid.net>
1384Jan Buchal <buchal@brailcom.org>
1385Jean-Philippe Mengual <jmengual@linuxfromscratch.org>
1386John J. Boyer <john.boyer@jjb-software.com>
1387Kazunori Minatani <99112004@gakushuin.ac.jp>
1388Lars Bjørndal <lars.bjorndal@broadpark.no>
1389Lee Maschmeyer <leemer1@comcast.net>
1390Luke Yelavich <themuso@ubuntu.com>
1391Mario Lang <mlang@delysid.org>
1392Mark Mielke <mark@mielke.cc>
1393Matthew Miller <mattdm@mattdm.org>
1394Michael Curran <mick@kulgan.net>
1395Michel Such <michel.such@free.fr>
1396Mike Pedersen <mpedersen@mindspring.com>
1397Nicolas Pitre <nico@fluxnic.net>
1398Olivier Bert <obert01@mistigri.org>`
1399Oscar Fernandez <ofa@once.es>
1400Pete De Vasto <pdevasto@incyte.com>
1401Peter Lundblad <plundblad@google.com>
1402Rich Burridge <Rich.Burridge@Sun.COM>
1403Rudolf Weeber <Rudolf.Weeber@gmx.de>
1404Samuel Thibault <samuel.thibault@ens-lyon.org>
1405Samuel Yang <mison@bbs.ee.ntu.edu.tw>
1406Sébastien Hinderer <sebastien.hinderer@ens-lyon.org>
1407Sérgio Neves <sergionevess@gmail.com>
1408Simon Kainz <simon@familiekainz.at>
1409Simon Meers <drmeers@gmail.com>
1410Stepan Kasal <kasal@ucw.cz>
1411Stephane Dalton <sdalton@videotron.ca>
1412Stéphane Doyon <s.doyon@videotron.ca>
1413Tapio Kelloniemi <tapio.kelloniemi@thack.org>
1414Thu Trang <phamtrang2002@softhome.net>
1415Timothy Spaulding <spaulding@icanbrew.com>
1416Timo Matsinen <matsinen@jyu.fi>
1417Tom spot Callaway <tcallawa@redhat.com>
1418Tomáš Janoušek <tomi@nomi.cz>
1419Tomoyuki Kudou <kudou@cypac.co.jp>
1420Willi Lutzenberger <willutz@gmx.net>
1421William Hubbs <w.d.hubbs@gmail.com>
1422Wolfgang Astleitner <wolfgang.astleitner@liwest.at>
1423Yair K. <caesium@hotpop.com>
1424Yannick Plassiard <yan@mistigri.org>
1425 Pairing a Bluetooth Device on Linux
1426===================================
1427
1428You need to "pair" your device with the host on which you wish to use it. You
1429can pair a device with more than one host, but you can usually only use it with
1430one host at a time.
1431
1432Pairing a Bluetooth device on Linux is relatively easy if you're comfortable
1433working within the graphical (X) environment. All you need to do is to run
1434"bluetooth-applet" and follow the steps it presents to you. It's a little
1435trickier to pair a Bluetooth device via the command line, but it can be done.
1436One way to do it is as follows:
1437
1438You need to find out your host's Bluetooth Device Address (referred to later in
1439this document as <host-address>). To do this, run the command "hciconfig hci0".
1440Look for the (indented) line which begins with "BD Address:". The very next
1441"word" on that line is your host's Bluetooth Device Address. It'll be six
1442two-digit hexadecimal numbers separated by colons (:). Examples in this
1443document use the value "01:23:45:67:89:AB".
1444
1445You need to find out your device's Bluetooth Device Address (referred to later
1446in this document as <device-address>). To do this, run the command "hcitool
1447scan". This command can take a while to complete as it gives devices a fair bit
1448of time to respond. Each device which responds creates one two-column output
1449line. The first column is its Bluetooth Device Address (examples in this
1450document use the value "12:34:56:78:9A:BC"), and the second column is its
1451current name. Manufacturers usually set a device's initial name to its product
1452name and model number so that it's easy to spot within the scan output. If your
1453device allows you to change its name, it's okay to do so even after you've
1454paired it.
1455
1456A device needs to be "visible" in order for the scan to find it. Most devices
1457are "invisible" by default, but have a way to be made temporarily visible. You
1458should check your device's manual to find out how to do this. In many cases
1459there's either a button which needs to be pressed or a menu item which needs to
1460be selected. Since both the device's temporary visibility and the host's scan
1461time out, Make your device visible just before you initiate the scan.
1462
1463You need to know what PIN (password) your device is expecting. Your device's
1464documentation should contain this information. Many devices allow you to set
1465the PIN, in which case they'll have a menu which allows you to do this.
1466Examples in this document use the value "1234".
1467
1468Go into the directory "/var/lib/bluetooth/<host-address>. In there (create if
1469necessary) is the file "pincodes". Each line in this file associates a device
1470with its PIN. It has two fields separated by space. The first field is the
1471device's Bluetooth Device Address and the second field is its PIN. The
1472Bluetooth Device Address must be in uppercase. For example:
1473
1474 cat /var/lib/bluetooth/01:23:45:67:89:AB/pincodes
1475 12:34:56:78:9A:BC 1234
1476
1477
1478Using a Bluetooth Device with BRLTTY
1479====================================
1480
1481After your device has been paired with your host, it's ready to be used by
1482BRLTTY. You can tell BRLTTY to use your Bluetooth device either via the -d (or
1483--braille-device=) command line option or via the braille-device line in the
1484file "/etc/brltty.conf". The device should be specified as the word
1485"bluetooth", a colon (:), and the device's Bluetooth Device Address. For
1486example:
1487
1488 brltty -d bluetooth:12:34:56:78:9A:BC
1489or
1490 cat /etc/brltty.conf
1491 braille-device bluetooth:12:34:56:78:9A:BC
1492
1493
1494 brltty for Debian
1495-----------------
1496
1497The ViaVoice and Theta speech modules are intentionally not included in the
1498binary package due to license incompatibilities.
1499
1500I also removed /sbin/brltty-install because I think
1501as soon as we have a .deb package, the reinstall
1502method isn't necessary.
1503(feel free to complain about this if you need it).
1504
1505 -- Mario Lang <mlang@delysid.org>, Wed May 19 09:41:09 2004
1506 This driver allows to use any tty as peripheral for BrlTTY. There are many ways
1507to use it.
1508
1509By ssh-ing from another machine
1510-------------------------------
1511
1512ssh from machB to machA, and give the current tty as device to brltty:
1513
1514samy@machB$ ssh machA
1515samy@machA$ su -
1516Password:
1517root@machA# brltty -b tt -d `tty` -B term=$TERM -n
1518
1519By using an Xterm
1520-----------------
1521
1522Just give the tty used by the xterm to brltty.
1523
1524$ su -
1525Password:
1526# brltty -b tt -d `tty` -B term=$TERM -n
1527
1528By using a real tty
1529-------------------
1530
1531Just give the serial port on which it is connected to brltty:
1532
1533# brltty -b tt -d /dev/ttyS0 -B term=ampex232,baud=19200,charset=IBM850,locale=fr_FR.IBM850
1534
1535I here had to precise the type of terminal (I have an Ampex232, see somewhere
1536like /usr/share/terminfo for your own's.
1537
1538I also had to tell that it uses the IBM850 codepage table. And I hence also
1539had to tell to use a special locale: fr_FR.IBM850, since I want french,
1540with IBM850 charset. I had to generate since by hand by adding
1541fr_FR.IBM850 IBM850
1542to my /etc/locale.gen, and then relaunch locale-gen
1543
1544
1545Notes
1546-----
1547
1548Another machine connected by a null-modem can be used as a tty: just run
1549minicom on it, and use vt100 as type of terminal.
1550
1551If a BrlAPI application writes dots (Gnopernicus for instance) you won't
1552get the text.
1553
1554See help.txt (or press F1) to get help on key bindings
1555Default configuration should be fine, but if not, get sure to use 8-dot text
1556style and not to show attributes in the configuration menu (F4).
1557
1558Note that when the displayed window is not supposed to contain the cursor, the
1559cursor is actually put below the displayed window.
1560 Ceci est le fichier README relatif àla version 0.2 du pilote VisioBraille
1561pour BRLTTY.
1562
1563Ce pilote a été testé avec succès avec les terminaux équipés de PROMs 0.0g et
15645.0q-fr. Il est vraisemblable que toutes les PROMs de version >=4
1565soient supportées par le présent pilote.
1566
1567Auteur et mainteneur actuel:
1568Sébastien Hinderer <Sebastien.Hinderer@ens-lyon.org>
1569
1570Bien que ce pilote soit utilisé de manière intensive, il n'est pas impossible
1571que certaines erreurs subsistent.
1572Si vous en trouvez, ou si vous avez des commentaires/suggestions quant ÃÂ
1573l'évolution de ce pilote, n'hésitez surtout pas àme contacter.
1574
1575Notes pour l'installation et Paramètres
1576=======================================
1577
1578Une table braille compatible avec celle fournie en standard dans le TVB
1579(basée sur la table SAGEM) est disponible, dans le fichier text.visiob.tbl du
1580répertoire ../../BrailleTables
1581
1582Paramètres acceptés par ce pilote :
1583
1584- displaysize : permet de spécifier la taille de la plage tactile.
1585
1586- promversion: permet de spécifier la version de PROM utilisée.
1587Ce paramètre n'est nécessaire que pour des PROMs de version inférieure ou
1588égale à3. Le support de ces PROMs n'étant disponible que pour Linux, et
1589moyennant une modification du noyau, merci de contacter directement l'auteur
1590si vous souhaitez utiliser une telle PROM.
1591
1592- baud: permet de spécifier la vitesse de la communication série.
1593Ce parmètre n'est pas nécessaire pour les terminaux VisioBraille et
1594n'est fourni que pour permettre l'utilisation d'émulateurs de terminaux qui
1595ne pourraient pas communiquer àune vitesse suffisante. Par conséquent,
1596n'utilisez pas ce paramètre, àmoins de savoir ce que vous faites.
1597
1598Pour des informations sur la manière de passer des paramètres au pilote, ou
1599pour toute autre précision concernant l'installation et l'utilisation de
1600brltty, merci de consulter la documentation du répertoire ../../Documents
1601
1602Notes pour l'utilisation.
1603=========================
1604
1605 Voici la description des fonctions attachées aux touches des claviers
1606auxiliaires ainsi qu'aux commandes ploc-ploc.
1607
1608~~a Active l'aide de BRLTTY
1609~~b Active/désactive les bips
1610~~c Menu de configuration BRLTTY (~~c pour le quitter)
1611~~d page down
1612~~e end
1613~~h home
1614~~i Active/désactive le mode info (Cf le manuel BRLTTY pour en savoir plus)
1615~~r Réinitialise les paramètres de BRLTTY
1616~~s Sauvegarde la configuration des paramètres BRLTTY
1617~~u page up
1618
1619Clavier auxiliaire:
1620Sous Linux, les touches A1,A2,A3,A6,A7,A8 permettent d'activer les
16216 premières consoles virtuelles (correspond àalt-f1 àalt-f6).
1622L'action de ces touches n'est pas définie sur les autres systèmes
1623d'exploitation.
1624B6 coin supérieur gauche de l'écran
1625D6 coin inférieur gauche de l'écran
1626A4 fenêtre non vide précédente
1627A5 fenêtre non vide suivante
1628B7 ligne précédente
1629D7 ligne suivante
1630C6 fenêtre précédente
1631C8 fenêtre suivante
1632C7 fenêtre contenant le curseur
1633C1 flèche gauche
1634C3 flèche droite
1635B2 flèche haut
1636D2 flèche bas
1637B3 curseur on/off
1638D1 delete
1639
1640 En outre, les touches backspace, tab, ctrl, alt... sont siulées de la même
1641manière que sous DOS et Windows.
1642
1643Autres liens
1644============
1645
1646Un programme permettant le transfert de visiobases entre PC et TVB est
1647disponible àl'adresse suivante :
1648
1649http://brl.thefreecat.org
1650
1651Ce qu'il reste àfaire
1652======================
1653
1654 Pour les prochaines versions du driver, il serait peut-être souhaitable
1655d'inclure la possibilité de reprohrammer les touches, un peu comme cela se
1656fait sous DOS avec la commande ~~f.
1657
1658
1659--
1660Sébastien Hinderer <Sebastien.Hinderer@ens-lyon.org>
1661 BRLTTY Driver for the Tieman Voyager Braille Display
1662This is the user-space-only version of the driver.
1663Version 0.10 (March 2004)
1664
1665 <HTML>
1666<HEAD>
1667<TITLE> Dnsmasq - a DNS forwarder for NAT firewalls.</TITLE>
1668<link rel="icon"
1669 href="http://www.thekelleys.org.uk/dnsmasq/images/favicon.ico">
1670</HEAD>
1671<BODY BGCOLOR="WHITE">
1672<table width="100%" border="0" cellpadding="0" cellspacing="0">
1673<tr>
1674<td align="left" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td>
1675<td align="middle" valign="middle"><h1>Dnsmasq</h1></td>
1676<td align="right" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td></tr>
1677</table>
1678
1679Dnsmasq is a lightweight, easy to configure DNS forwarder and DHCP
1680 server. It is designed to provide DNS and, optionally, DHCP, to a
1681 small network. It can serve the names of local machines which are
1682 not in the global DNS. The DHCP server integrates with the DNS
1683 server and allows machines with DHCP-allocated addresses
1684 to appear in the DNS with names configured either in each host or
1685 in a central configuration file. Dnsmasq supports static and dynamic
1686 DHCP leases and BOOTP/TFTP/PXE for network booting of diskless machines.
1687<P>
1688 Dnsmasq is targeted at home networks using NAT and
1689connected to the internet via a modem, cable-modem or ADSL
1690connection but would be a good choice for any smallish network (up to
16911000 clients is known to work) where low
1692resource use and ease of configuration are important.
1693<P>
1694Supported platforms include Linux (with glibc and uclibc), *BSD,
1695Solaris and Mac OS X.
1696Dnsmasq is included in at least the following Linux distributions:
1697Gentoo, Debian, Slackware, Suse, Fedora,
1698Smoothwall, IP-Cop, floppyfw, Firebox, LEAF, Freesco, fli4l,
1699CoyoteLinux, Endian Firewall and
1700Clarkconnect. It is also available as FreeBSD, OpenBSD and NetBSD ports and is used in
1701Linksys wireless routers (dd-wrt, openwrt and the stock firmware) and the m0n0wall project.
1702<P>
1703Dnsmasq provides the following features:
1704<DIR>
1705
1706<LI>
1707The DNS configuration of machines behind the firewall is simple and
1708doesn't depend on the details of the ISP's dns servers
1709<LI>
1710Clients which try to do DNS lookups while a modem link to the
1711internet is down will time out immediately.
1712</LI>
1713<LI>
1714Dnsmasq will serve names from the /etc/hosts file on the firewall
1715machine: If the names of local machines are there, then they can all
1716be addressed without having to maintain /etc/hosts on each machine.
1717</LI>
1718<LI>
1719The integrated DHCP server supports static and dynamic DHCP leases and
1720multiple networks and IP ranges. It works across BOOTP relays and
1721supports DHCP options including RFC3397 DNS search lists.
1722Machines which are configured by DHCP have their names automatically
1723included in the DNS and the names can specified by each machine or
1724centrally by associating a name with a MAC address in the dnsmasq
1725config file.
1726</LI>
1727<LI>
1728Dnsmasq caches internet addresses (A records and AAAA records) and address-to-name
1729mappings (PTR records), reducing the load on upstream servers and
1730improving performance (especially on modem connections).
1731</LI>
1732<LI>
1733Dnsmasq can be configured to automatically pick up the addresses of
1734its upstream nameservers from ppp or dhcp configuration. It will
1735automatically reload this information if it changes. This facility
1736will be of particular interest to maintainers of Linux firewall
1737distributions since it allows dns configuration to be made automatic.
1738</LI>
1739<LI>
1740On IPv6-enabled boxes, dnsmasq can both talk to upstream servers via IPv6
1741and offer DNS service via IPv6. On dual-stack (IPv4 and IPv6) boxes it talks
1742both protocols and can even act as IPv6-to-IPv4 or IPv4-to-IPv6 forwarder.
1743</LI>
1744<LI>
1745Dnsmasq can be configured to send queries for certain domains to
1746upstream servers handling only those domains. This makes integration
1747with private DNS systems easy.
1748</LI>
1749<LI>
1750Dnsmasq supports MX and SRV records and can be configured to return MX records
1751for any or all local machines.
1752</LI>
1753</DIR>
1754
1755<H2>Download.</H2>
1756
1757<A HREF="http://www.thekelleys.org.uk/dnsmasq/"> Download</A> dnsmasq here.
1758The tarball includes this documentation, source, and manpage.
1759There is also a <A HREF="CHANGELOG"> CHANGELOG</A> and a <A HREF="FAQ">FAQ</A>.
1760Dnsmasq is part of the Debian distribution, it can be downloaded from
1761<A HREF="http://ftp.debian.org/debian/pool/main/d/dnsmasq/"> here</A> or installed using <TT>apt</TT>.
1762
1763<H2>Links.</H2>
1764Damien Raude-Morvan has an article in French at <A HREF="http://www.drazzib.com/docs-dnsmasq.html">http://www.drazzib.com/docs-dnsmasq.html</A>
1765There is a good article about dnsmasq at <A
1766HREF="http://www.enterprisenetworkingplanet.com/netos/article.php/3377351">http://www.enterprisenetworkingplanet.com/netos/article.php/3377351</A>
1767and another at <A
1768HREF="http://www.linux.com/articles/149040">http://www.linux.com/articles/149040</A>
1769and Ilya Evseev has an article in Russian about dnsmasq to be found at
1770<A HREF="http://ilya-evseev.narod.ru/articles/dnsmasq">
1771http://ilya-evseev.narod.ru/articles/dnsmasq</A>. Ismael Ull has an
1772article about dnsmasq in Spanish at <A HREF="http://www.mey-online.com.ar/blog/index.php/archives/guia-rapida-de-dnsmasq">http://www.mey-online.com.ar/blog/index.php/archives/guia-rapida-de-dnsmasq</A>
1773<H2>License.</H2>
1774Dnsmasq is distributed under the GPL. See the file COPYING in the distribution
1775for details.
1776
1777<H2>Contact.</H2>
1778There is a dnsmasq mailing list at <A
1779HREF="http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss">
1780http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss</A> which should be the
1781first location for queries, bugreports, suggestions etc.
1782Dnsmasq was written by Simon Kelley. You can contact me at <A
1783HREF="mailto:simon@thekelleys.org.uk">simon@thekelleys.org.uk</A>.
1784</BODY>
1785
1786 <HTML>
1787<HEAD>
1788<TITLE> Configuring Dnsmasq.</TITLE>
1789</HEAD>
1790<BODY BGCOLOR="WHITE">
1791<H1 ALIGN=center>Dnsmasq setup</H1>
1792<H2>Installation.</H2>
1793To compile and install dnsmasq, the following command (as root) is enough.
1794
1795<PRE>
1796make install
1797</PRE>
1798
1799You might want to edit config.h. Dnsmasq has
1800been run on (at least) Linux, uCLinux, AIX 4.1.5, FreeBSD 4.4 OpenBSD and Tru64 4.x
1801
1802Dnsmasq is normally run on a firewall machine (the machine with the
1803modem or other connection to your ISP.) but it can run on any machine
1804with access to the ISPs nameservers.
1805
1806Put the binary in <TT>/usr/local/sbin/dnsmasq</TT> (running <TT>make install</TT> will do this) and arrange for it
1807to be started at boot time.
1808
1809Note that dnsmasq needs to run as root, since it binds privileged ports. It will drop root privileges after start-up. Dnsmasq
1810logs problems using the syslog facility as a daemon. It logs debugging
1811information to local0
1812<P>
1813<H2>Configuration.</H2>
1814Configuration for dnsmasq is pretty simple in almost all cases. The
1815program has collected a fair few options as it has developed but most of them
1816are not needed most of the time. A machine which already has a DNS
1817configuration (ie one or more external nameservers in <TT>/etc/resolv.conf</TT>
1818and any local hosts in <TT>/etc/hosts</TT>) can be turned into a nameserver
1819simply by running dnsmasq, with no options or configuration at
1820all. Set the IP address of the machine running dnsmasq as the DNS
1821server in all the other machines on your network, and you're done.
1822<P>
1823With a few option flags, it is possible to make dnsmasq do more clever
1824tricks. Options for dnsmasq can be set either on the command line
1825when starting dnsmasq, or in its configuration file, <TT>/etc/dnsmasq.conf</TT>.
1826
1827<h2>Making the nameserver machine use dnsmasq.</h2>
1828In the simple configuration described above, processes local to the
1829machine will not use dnsmasq, since they get their information about
1830which nameservers to use from /etc/resolv.conf, which is set to the
1831upstream nameservers. To fix this, simply replace the nameserver in
1832<TT>/etc/resolv.conf</TT> with the local address 127.0.0.1 and give the
1833address(es) of the upstream nameserver(s) to dnsmasq directly. You can
1834do this using either the <TT>server</TT> option, or by putting them into
1835another file, and telling dnsmasq about its location with
1836the <TT>resolv-file</TT> option.
1837
1838<h2>Automatic nameserver configuration.</h2>
1839The two protocols most used for automatic IP network configuration
1840(PPP and DHCP) can determine the IP addresses for nameservers automatically.
1841The daemons can be made to write out a file in the resolv.conf format with the
1842nameservers in which is perfect for dnsmasq to use. When the
1843nameservers change, for instance on dialling into a new ISP using PPP,
1844dnsmasq will automatically re-read this file and begin using the new
1845nameserver(s) completely transparently.
1846
1847<h3>Automatic DNS server configuration with PPP.</h3>
1848Later versions of pppd have an option "usepeerdns" which instructs it to write a file containing
1849the address(es) of the DNS severs in <TT>/etc/ppp/resolv.conf</TT>. Configure dnsmasq
1850as above with "nameserver 127.0.0.1" in <TT>/etc/resolv.conf</TT> and run dnsmasq
1851with to option <TT>resolv-file=/etc/ppp/resolv.conf</TT>.
1852<P>
1853On Redhat (at least versions 7.1, 7.2 and 7.3) you can set pppd
1854options by adding "PPPOPTIONS=usepeerdns" to
1855<TT>/etc/sysconfig/network-scripts/ifcfg-ippp0</TT>. In the same file, make sure
1856that "PEERDNS=no" to stop RedHat's network initscripts from copying
1857<TT>/etc/ppp/resolv.conf</TT> into <TT>/etc/resolv.conf</TT>.<BR>
1858
1859On SuSE (at least version 8.1, and 8.2) you should use YaST to activate
1860<TT>[x] Modify DNS when connected</TT> then stop SuSEs network initscripts
1861from copying <TT>/etc/ppp/resolv.conf</TT> into <TT>/etc/resolv.conf</TT>
1862by modifying MODIFY_RESOLV_CONF_DYNAMICALLY="no" in <TT>/etc/sysconfig/network/config</TT>.
1863
1864
1865<h3>Automatic DNS server configuration with DHCP.</h3>
1866You need to get your DHCP client to write the addresse(s) of the DNS
1867servers to a file other than <TT>/etc/resolv.conf</TT>. For dhcpcd, the
1868<TT>dhcpcd.exe</TT> script gets run with the addresses of the nameserver(s) in
1869the shell variable <TT>$DNS</TT>. The following bit of shell script
1870uses that to write a file suitable for dnsmasq.
1871<PRE>
1872
1873echo -n >|/etc/dhcpc/resolv.conf
1874dnsservs=${DNS//,/ }
1875for serv in $dnsservs; do
1876 echo "nameserver $serv" >>/etc/dhcpc/resolv.conf
1877done
1878
1879</PRE>
1880
1881Remember to give dhcpcd the <TT>-R</TT> flag to stop it overwriting
1882<TT>/etc/resolv.conf</TT>.
1883
1884<P>
1885For other DHCP clients it should be possible to achieve the same effect.
1886
1887<h3> DHCP and PPP.</h3>
1888On a laptop which may potentially connect via a modem and PPP or
1889ethernet and DHCP it is possible to combine both of the above
1890configurations. Running dnsmasq with the flags
1891<TT>resolv-file=/etc/ppp/resolv.conf resolv-file=/etc/dhcpc/resolv.conf</TT>
1892makes it poll <B>both</B> files and use whichever was updated
1893last. The result is automatic switching between DNS servers.
1894</H3>
1895
1896<H2> Integration with DHCP.</H2>
1897Dnsmasq reads <TT>/etc/hosts</TT> so that the names of local machines are
1898available in DNS. This is fine when you give all your local machines
1899static IP addresses which can go in <TT>/etc/hosts</TT>, but it doesn't work
1900when local machines are configured via DHCP, since the IP address
1901allocated to machine is not fixed. Dnsmasq comes with an integrated
1902DHCP daemon to solve this problem.
1903<P>
1904The dnsmasq DHCP daemon allocates addresses to hosts on the network and tries
1905to determine their names. If it succeeds it add the name and address
1906pair to the DNS. There are basically two ways to associate a name with
1907a DHCP-configured machine; either the machine knows its name which it
1908gets a DHCP lease, or dnsmasq gives it a name, based on the MAC
1909address of its ethernet card. For the former to work, a machine needs to know its name when it
1910requests a DHCP lease. For dhcpcd, the -h option specifies this. The
1911names may be anything as far as DHCP is concerned, but dnsmasq adds
1912some limitations. By default the names must no have a domain part, ie
1913they must just be a alphanumeric name, without any dots. This is a
1914security feature to stop a machine on your network telling DHCP that
1915its name is "www.microsoft.com" and thereby grabbing traffic which
1916shouldn't go to it. A domain part is only allowed by dnsmasq in DHCP machine names
1917if the <TT>domain-suffix</TT> option is set, the domain part must match the
1918suffix.
1919<P>
1920As an aside, make sure not to tell DHCP to set the hostname when it
1921obtains a lease (in dhcpcd that's the -H flag.)
1922This is not reliable since the DHCP server gets the
1923hostname from DNS which in this case is dnsmasq. There is a race
1924condition because the host's name in the DNS may change as a
1925result of it getting a DHCP lease, but this does not propagate before
1926the name is looked up. The net effect may be that the host believes it
1927is called something different to its name in the DNS. To be safe, set
1928the hostname on a machine locally, and pass the same name to DHCP when
1929requesting a lease.
1930<P>
1931<H2>Setting up a mailhub.</H2>
1932If you generate mail on the machines attached to your private network, you may
1933 be interested in the MX record feature of dnsmasq. This allows you to have all
1934 the machines on your network use your firewall or another machine as a "smarthost" and
1935deliver mail to it. The details of how to set this up are highly dependent on
1936your mailer, system and distribution. The only thing that's relevant to dnsmasq is that the mailer
1937needs to be able to interrogate the DNS and find an MX record for your mailhub.
1938<P>
1939By giving dnsmasq the <TT>mx-host</TT> option
1940you instruct dnsmasq to serve an MX record for the specified address.
1941By default the MX record
1942points to the machine on which dnsmasq is running, so mail delivered to that
1943name will get sent to the mailer on your firewall machine. You can
1944have the MX record point to another machine by using the <TT>mx-target</TT>
1945option.
1946<P>
1947In some cases it's useful for all local machines to see an MX record
1948pointing at themselves: this allows mailers which insist on an MX record and
1949don't fall back to A records to deliver mail within the
1950machine. These MX records are enabled using the <TT>selfmx</TT> option.
1951
1952<H2>Using special servers.</H2>
1953Dnsmasq has the ability to direct DNS queries for certain domains to
1954specific upstream nameservers. This feature was added for use with
1955VPNs but it is fully general. The scenario is this: you have a
1956standard internet connection via an ISP, and dnsmasq is configured to
1957forward queries to the ISP's nameservers, then you make a VPN
1958connection into your companies network, giving access to hosts inside
1959the company firewall. You have access, but since many of the internal hosts
1960aren't visible on the public internet, your company doesn't publish
1961them to the public DNS and you can't get their IP address from the ISP
1962nameservers. The solution is to use the companies nameserver for
1963private domains within the company, and dnsmasq allows this. Assuming
1964that internal company machines are all in the domain internal.myco.com
1965and the companies nameserver is at 192.168.10.1 then the option
1966<TT>server=/internal.myco.com/192.168.10.1</TT> will direct all
1967queries in the internal domain to the correct nameserver. You can
1968specify more than one domain in each server option. If there is
1969more than one nameserver just include as many
1970<TT>server</TT> options as is needed to specify them all.
1971
1972<H2>Local domains.</H2>
1973Sometimes people have local domains which they do not want forwarded
1974to upstream servers. This is accomodated by using server options
1975without the server IP address. To make things clearer <TT>local</TT>
1976is a synonym for <TT>server</TT>. For example the option
1977<TT>local=/localnet/</TT> ensures that any domain name query which ends in
1978<TT>.localnet</TT> will be answered if possible from
1979<TT>/etc/hosts</TT> or DHCP, but never sent to an upstream server.
1980
1981<H2>Defeating wildcards in top level domains.</H2>
1982In September 2003 Verisign installed a wildcard record in the .com and
1983.net top level domains. The effect of this is that queries for
1984unregistered .com and .net names now return the address of Verisign's
1985sitefinder service, rather than a "no such domain" response. To
1986restore the correct behaviour, you can tell dnsmasq the address of the
1987sitefinder host and have it substitute an NXDOMAIN reply when it sees
1988that address. The sitefinder address is currently 64.94.110.11, so
1989giving the option <TT>bogus-nxdomain=64.94.110.11</TT> will enable
1990this facility for Verisign. If other TLDs do that same thing you can
1991add the correct addresses for them too. See the dnsmasq FAQ for more
1992details on the <TT>bogus-nxdomain</TT> option.
1993
1994<H2>Other configuration details.</H2>
1995By default dnsmasq offers DNS service on all the configured interfaces
1996of a host. It's likely that you don't (for instance) want to offer a
1997DNS service to the world via an interface connected to ADSL or
1998cable-modem so dnsmasq allows you to specify which interfaces it will
1999listen on. Use either the <TT>interface</TT> or <TT>address</TT> options to do this.
2000<P>
2001The <TT>filterwin2k</TT> option makes dnsmasq ignore certain DNS requests which
2002are made by Windows boxen every few minutes. The requests generally
2003don't get sensible answers in the global DNS and cause trouble by
2004triggering dial-on-demand internet links.
2005<P>
2006Sending SIGHUP to the dnsmasq process will cause it to empty its cache and
2007then re-load <TT>/etc/hosts</TT> and <TT>/etc/resolv.conf</TT>.
2008<P> Sending SIGUSR1 (killall -10 dnsmasq) to the dnsmasq process will
2009cause to write cache usage statisticss to the log, typically
2010<TT>/var/log/syslog</TT> or <TT>/var/log/messages</TT>.
2011<P> The <TT>log-queries</TT> option tells dnsmasq to verbosely log the queries
2012it is handling and causes SIGUSR1 to trigger a complete dump of the
2013contents of the cache to the syslog.
2014
2015<P>For a complete listing of options please take a look at the manpage
2016dnsmasq(8).
2017
2018This is the Debian doc-base package. It was assembled by
2019Christian Schwarz <schwarz@debian.org>. The next maintainer
2020was Adam Di Carlo <aph@debian.org>. It is currently maintained
2021by Robert Luberda <robert@debian.org>.
2022
2023doc-base Copyright (C) 1997,1998 Christian Schwarz.
2024doc-base Copyright (C) 2006-2009 Robert Luberda.
2025
2026This package is free software; you may redistribute it and/or modify it
2027under the terms of the GNU General Public License as published by the
2028Free Software Foundation; either version 2, or (at your option) any
2029later version.
2030
2031This is distributed in the hope that it will be useful, but without
2032any warranty; without even the implied warranty of merchantability or
2033fitness for a particular purpose. See the GNU General Public License
2034for more details.
2035
2036You should have received a copy of the GNU General Public License with
2037your Debian GNU/Linux system, in /usr/share/common-licenses/GPL-2, or
2038with the dpkg source package as the file COPYING. If not, write to the
2039Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
2040MA 02110-1301 USA
2041
2042
2043Copyright 2004 by Stéphane Doyon <s.doyon@videotron.ca>
2044
2045This is a partial rewrite of the driver which functions entirely from
2046user-space (whereas the previous driver depended on a kernel driver for
2047the USB communication with the Voyager display).
2048
2049This driver supports the Tieman Voyager 44 and 70.
2050
2051The driver works with later 2.4.x kernels and with at least some versions
2052in the 2.6.x series.
2053Note that the kernel brlvger driver used with the old BRLTTY driver does
2054not work properly with 2.6.x kernels.
2055
2056Many thanks to the Tieman people: Corand van Strien, Ivar Illing, Daphne
2057Vogelaar and Ingrid Vogel. They provided us with a Braille display (as
2058well as programming information) so that we could write this driver. They
2059replaced the display when it broke and they answered our technical
2060questions. It is very motivating when companies take an interest in such
2061projects and are so supportive.
2062
2063Thanks to Andor Demarteau <ademarte@students.cs.uu.nl> who got this whole
2064project started and beta-tested all our early buggy attempts.
2065
2066Thanks to Stéphane Dalton who wrote the initial version of the old kernel
2067driver. Without his initiative this project would not have been a success.
2068
2069This rewrite of the driver should allow more flexibility, but is as of yet
2070very young and not thoroughly tested.
2071
2072When BRLTTY will be running, press the leftmost routing key to bring up
2073the help screen so you can read the details of the key bindings.
2074
2075Users of the 2.6.x kernel may experience some difficulties. The old
2076kernel driver, which is included in the official kernels, will actually
2077get in the way of this driver as it will claim the USB interface to the
2078display, and I've seen some hangs occur when BRLTTY asks to disconnect
2079the kernel driver. If you have this problem you should make sure the
2080kernel module called brlvger is not inserted into your kernel. One simple
2081way to prevent that module from auto-loading is to rename the module file
2082so it isn't found.
2083cd /lib/modules/`uname -r`/kernel/drivers/usb/
2084mv brlvger.o brlvger.o.hold
2085If lsmod shows the brlvger module as already loaded then do
2086rmmod brlvger
2087
2088The old kernel driver will soon be pulled out of 2.6.x kernels.
2089
2090BRLTTY currently assumes the default braille device to be a serial port,
2091so you must tell it that it is in fact USB.
2092Either provide the "--with-braille-device=usb:" option when running the
2093BRLTTY top-level ./configure command, or use the braille-device parameter
2094in your BRLTTY configuration file (/etc/brltty.conf):
2095braille-device usb:
2096
2097If you actually have more than one Voyager display connected at the same
2098time, you can also specify the serial number of the device that you want
2099to use.
2100
2101This driver knows a number of driver parameters which you can pass via
2102the braille-parameters clause in your BRLTTY configuration file
2103(/etc/brltty.conf) or via brltty's -B (--braille-parameters=) command
2104line option.
2105
2106InputMode: This parameter specifies whether or not the eight top keys
2107function as a braille keyboard. When set to "no" (the default), top
2108key combinations perform various navigational and operational
2109functions. When set to yes", they function as an 8-dot braille
2110keyboard. If B, C, or B+C is pressed along with any top key
2111combination then it's as if this parameter were set to "no".
2112
2113There are only a handful of BRLTTY users, so if you are trying out this
2114driver, please drop us a note, even if you have no problems!
2115
2116Note to BRLTTY developers: This is my first attempt at combining the key
2117binding definitions with the help file text in one place, through
2118annotations in the braille.c file. If you change the key bindings,
2119currently you need python installed to be able to rebuild the help
2120files.
2121 This package was debianized by Mario Lang <mlang@delysid.org> on
2122Thu, 4 Jan 2001 16:22:12 +0100.
2123
2124It was downloaded from <URL:http://mielke.cc/brltty/releases/>
2125
2126Upstream Authors:
2127 Nicolas Pitre <nico@cam.org>
2128 Current maintainer; author of the drivers for the Alva B.V.
2129 series and for the EuroBraille family of displays.
2130
2131 Stéphane Doyon <s.doyon@videotron.ca>:
2132 Active developer; author of the driver for Telesensory
2133 Systems's PowerBraille and Navigator models.
2134
2135 Nikhil Nair <nn201@cus.cam.ac.uk>:
2136 Original author; author of the drivers for the Tieman B.V.
2137 CombiBraille and Blazie Engineering's BrailleLite.
2138
2139 James Bowden <jrbowden@bcs.org.uk>:
2140 Acted in an advisory capacity; contributed some braille
2141 translation tables.
2142
2143 August Hörandl <hoerandl@elina.htlw1.ac.at>:
2144 Noted contributor of the driver for the Papenmeier Screen 2D
2145 Terminal. Thanks to the members of his team (Tibor Becker,
2146 Michael Burger, Herbert Gruber and Heimo Schön) who worked on
2147 this project at the Technical High School, Department for
2148 electrical engineering, Vienna, Austria.
2149
2150 Oscar Fernandez <ofa@once.es>:
2151 Contributor of the driver for the EcoBraille from La O.N.C.E.
2152
2153 A more complete list of contributors can be found in
2154 `/usr/share/doc/brltty/CONTRIBUTORS'.
2155
2156Copyright:
2157
2158Copyright (C) 1995-2009 by The BRLTTY Team, All rights reserved.
2159
2160BRLTTY comes with ABSOLUTELY NO WARRANTY.
2161
2162This is free software, placed under the terms of the
2163GNU General Public License, as published by the Free Software
2164Foundation; either version 2 of the License, or (at your option) any
2165later version.
2166
2167On Debian GNU/Linux systems, the complete text of the GNU General
2168Public License can be found in `/usr/share/common-licenses/GPL-2'.
2169
2170Text, attribute and contraction tables in /etc/brltty/ are placed under
2171the terms of the GNU Lesser General Public License, as published by the
2172Free Software Foundation; either version 2.1 of the License, or (at your
2173option) any later version.
2174
2175On Debian GNU/Linux systems, the complete text of the GNU Lesser General
2176Public License can be found in `/usr/share/common-licenses/LGPL-2.1'.
2177
2178 This is bsdmainutils, a collection of userland programs from the *BSD source
2179distributions. All of the program except for calendar(1) and lorder(1) come
2180from FreeBSD, while these two come from OpenBSD. The calendars themselves
2181mostly come from FreeBSD though, but not all.
2182
2183These sources were originally pacakged by Austin Donnelly
2184<and1000@debian.org>, and were based heavily on bsdutils, which was
2185originally put together by Ian Murdock <imurdock@gnu.ai.mit.edu>.
2186
2187After that, the package was maintained by Charles Briscoe-Smith
2188<cpbs@debian.org>. He gathered data for the 1999-2001 calendar files from
2189various sources on the Internet. Oliver Elphick, Julian Gilbey, Daniel
2190Martin and Jaldhar H. Vyas provided much useful data on the various religous
2191calendars.
2192
2193After Charles, Marco d'Itri <md@linux.it> maintained the package for almost
2194two years, before Tollef Fog Heen <tfheen@debian.org> took over followed by
2195Graham Wilson <bob@decoy.wox.org> and Daniel Baumann <daniel@debian.org>.
2196The package is now maintained by Giacomo Catenazzi <cate@debian.org> and
2197Michael Meskes <meskes@debian.org>.
2198
2199Graham Wilson replaced the FreeBSD calendar(1) with the calendar from
2200OpenBSD(1), thanks to a suggestion from Matt Zimmerman. Nicolas Évrard provided
2201calendar files for the EU and Belgium, and Martin Schulze provided a calendar
2202with Debian dates.
2203
2204See /usr/share/doc/bsdmainutils/source.data.gz for more information on calendar
2205sources.
2206
2207$Id$
2208 This is a collection of programs from 4.4BSD-Lite that have not (yet)
2209been re-written by FSF as GNU. It was constructed for inclusion in
2210Debian Linux. As programs found here become available from GNU sources,
2211they will be replaced.
2212
2213This package was originally put together by Austin Donnelly
2214<and1000@debian.org>, but is heavily based on bsdutils, originally put
2215together by Ian Murdock <imurdock@gnu.ai.mit.edu>. Please report any
2216problems or suggested additions or changes to Austin Donnelly.
2217
2218Then the package has been maintained by Charles Briscoe-Smith
2219<cpbs@debian.org>. I gathered data for the 1999-2001 calendar files
2220from various sources on the Internet, and I'd also like to thank Oliver
2221Elphick, Julian Gilbey, Daniel Martin and Jaldhar H. Vyas for providing
2222much useful data on the various religous calendars. I have edited the
2223files they provided to fit calendar's requirements, so any errors should
2224be attributed to me.
2225
2226After cpbs@debian.org, Marco d'Itri <md@linux.it> maintained it for
2227almost two years, before Tollef Fog Heen <tfheen@debian.org> took over.
2228The package is now maintained by Graham Wilson <bob@decoy.wox.org>.
2229
2230This package may be redistributed under the terms of the UCB BSD
2231license:
2232
2233Copyright (C) 1980 -1998 The Regents of the University of California.
2234All rights reserved.
2235
2236Redistribution and use in source and binary forms, with or without
2237modification, are permitted provided that the following conditions
2238are met:
22391. Redistributions of source code must retain the above copyright
2240 notice, this list of conditions and the following disclaimer.
22412. Redistributions in binary form must reproduce the above copyright
2242 notice, this list of conditions and the following disclaimer in the
2243 documentation and/or other materials provided with the distribution.
22444. Neither the name of the University nor the names of its contributors
2245 may be used to endorse or promote products derived from this software
2246 without specific prior written permission.
2247
2248THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2249ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2250IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2251ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2252FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2253DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2254OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2255HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2256LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2257OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2258SUCH DAMAGE.
2259 Security hole in `script'
2260-------------------------
2261
2262The BSD `script' utility included in the `bsdutils' package is not
2263installed setuid root, and was not written to be. Sometimes the tty
2264`script' allocates is already owned by the appropriate user, in which
2265case there will be no problem. In other cases, `script' will not be
2266able to set the ownership or mode of the pty/tty pair it allocates,
2267and so it cannot prevent other processes reading or writing to the tty.
2268
2269The result of this is a security hole: during such a `script' session,
2270other users can read keystrokes from your tty, or write to your terminal,
2271without any warning or explicit authorisation. This means that any
2272password(s) or other sensitive data you enter during such a `script'
2273session are not secure against snooping, even if they are (properly)
2274not echoed to the screen.
2275
2276To protect against this, `script' tries to detect whether the tty
2277allocated for it by the C library's openpty() function is secure
2278against snooping. If it detects that there is a problem, `script'
2279issues a warning. If you see this warning, you should not enter any
2280sensitive data during the script session, and you should not trust the
2281output displayed, or that recorded in the `typescript' file, to be free
2282from tampering.
2283
2284This bug is due to a long-standing design flaw in UNIX, and is to be cured
2285shortly by the introduction of the UNIX98-style pty system supported
2286by GLIBC 2.1 and Linux 2.2. The UNIX98-style pty system makes use of
2287kernel support to create slave devices on the fly, with the correct
2288ownership and permissions already in place. This allows unprivileged
2289user programs to allocate pty/tty pairs securely, and eliminates the
2290race conditions currently present in pty allocation.
2291
2292When `script' is used on a system with UNIX98-style pty support in
2293the kernel and in libc, `script' will detect that its tty is secure,
2294and will not display the warning.
2295
2296Charles Briscoe-Smith <cpbs@debian.org> Wed, 9 Dec 1998 13:32:49 +0000
2297 This is the Debian GNU/Linux prepackaged version of util-linux.
2298
2299This package was put together by Guy Maor <maor@debian.org> and later
2300maintained by Sean 'Shaleh' Perry <shaleh@debian.org>, and Adrian Bunk
2301<bunk@stusta.de>.
2302
2303The current maintainer is LaMont Jones <lamont@debian.org>.
2304See also: git://git.debian.org/~lamont/util-linux.git
2305
2306It was downloaded from:
2307 ftp://ftp.us.kernel.org/pub/linux/utils/util-linux-ng/
2308
2309Upstream maintainers include:
2310 Maintainer: Karel Zak <kzak@redhat.com>
2311 Past Maintainer: Adrian Bunk <bunk@fs.tum.de>
2312 Past Maintainer: Andries Brouwer <aeb@cwi.nl>
2313 See also /usr/share/doc/util-linux/AUTHORS
2314
2315Copyright:
2316
2317 A variety of people and entities, as befits the nature of the package.
2318 See the individual sources for exact copyright holder information.
2319
2320License:
2321
2322 The project doesn't use same license for all code. There is code with:
2323
2324 * GPLv2+ (GNU General Public License version 2, or any later version)
2325
2326 * GPLv2 (GNU General Public License version 2)
2327
2328 * BSD with advertising
2329
2330 * Public Domain
2331
2332 Please, check source code for more details. A license is usually at the start
2333 of each source file.
2334
2335 Anything lacking an explicit license may be redistributed under the terms
2336 of the GNU GPL Version 2 or later found on Debian systems in the file
2337 /usr/share/common-licenses/GPL
2338 This package was debianized by Erik Andersen <andersee@debian.org> on
2339Sun, 18 Jun 2000 23:31:02 -0600
2340
2341It was downloaded from ftp://ftp.busybox.net/busybox
2342
2343BusyBox is an aggregate of multiple packages. These packages are copyrighted
2344by their respective authors.
2345
2346Copyright: 1999-2005 Erik Andersen
2347
2348License:
2349
2350 This package is free software; you can redistribute it and/or modify
2351 it under the terms of the GNU General Public License as published by
2352 the Free Software Foundation; version 2 dated June, 1991.
2353
2354 This package is distributed in the hope that it will be useful,
2355 but WITHOUT ANY WARRANTY; without even the implied warranty of
2356 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2357 GNU General Public License for more details.
2358
2359 You should have received a copy of the GNU General Public License
2360 along with this package; if not, write to the Free Software
2361 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
2362 MA 02110-1301, USA.
2363
2364On Debian GNU/Linux systems, the complete text of the GNU General
2365Public License can be found in `/usr/share/common-licenses/GPL-2'.
2366 This package was debianized by Erik Andersen <andersee@debian.org> on
2367Sun, 18 Jun 2000 23:31:02 -0600
2368
2369It was downloaded from ftp://ftp.busybox.net/busybox
2370
2371BusyBox is an aggregate of multiple packages. These packages are copyrighted
2372by their respective authors.
2373
2374Copyright: 1999-2005 Erik Andersen
2375
2376License:
2377
2378 This package is free software; you can redistribute it and/or modify
2379 it under the terms of the GNU General Public License as published by
2380 the Free Software Foundation; version 2 dated June, 1991.
2381
2382 This package is distributed in the hope that it will be useful,
2383 but WITHOUT ANY WARRANTY; without even the implied warranty of
2384 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2385 GNU General Public License for more details.
2386
2387 You should have received a copy of the GNU General Public License
2388 along with this package; if not, write to the Free Software
2389 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
2390 MA 02110-1301, USA.
2391
2392On Debian GNU/Linux systems, the complete text of the GNU General
2393Public License can be found in `/usr/share/common-licenses/GPL-2'.
2394 This package (bzip2) was created by Philippe Troin <phil@fifi.org>.
2395It is currently mantained by Anibal Monsalve Salazar <anibal@debian.org>.
2396This package is Copyright (C) 1999, 2000, 2001, 2002 Philippe Troin
2397<phil@fifi.org> and Copyright (C) 2004-2007 Anibal Monsalve Salazar.
2398It is licensed under the GNU General Public License which can be
2399found in /usr/share/common-licenses/GPL.
2400
2401It was downloaded from
2402 http://www.bzip.org/downloads.html
2403
2404For more information about bzip2, please visit:
2405 http://www.bzip.org/
2406
2407Author:
2408 Julian Seward <jseward@acm.org>
2409
2410Copyright: (from LICENSE)
2411
2412
2413--------------------------------------------------------------------------
2414
2415This program, "bzip2", the associated library "libbzip2", and all
2416documentation, are copyright (C) 1996-2010 Julian R Seward. All
2417rights reserved.
2418
2419Redistribution and use in source and binary forms, with or without
2420modification, are permitted provided that the following conditions
2421are met:
2422
24231. Redistributions of source code must retain the above copyright
2424 notice, this list of conditions and the following disclaimer.
2425
24262. The origin of this software must not be misrepresented; you must
2427 not claim that you wrote the original software. If you use this
2428 software in a product, an acknowledgment in the product
2429 documentation would be appreciated but is not required.
2430
24313. Altered source versions must be plainly marked as such, and must
2432 not be misrepresented as being the original software.
2433
24344. The name of the author may not be used to endorse or promote
2435 products derived from this software without specific prior written
2436 permission.
2437
2438THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
2439OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
2440WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2441ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
2442DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2443DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
2444GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
2445INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
2446WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
2447NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
2448SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2449
2450Julian Seward, jseward@bzip.org
2451bzip2/libbzip2 version 1.0.6 of 6 September 2010
2452
2453--------------------------------------------------------------------------
2454 The Debian Package “ca-certificatesâ€Â
2455----------------------------------
2456
2457This package includes PEM files of CA certificates to allow SSL-based
2458applications to check for the authenticity of SSL connections.
2459
2460Please note that Debian can neither confirm nor deny whether the
2461certificate authorities whose certificates are included in this package
2462have in any way been audited for trustworthiness or RFC 3647 compliance.
2463Full responsibility to assess them belongs to the local system
2464administrator.
2465
2466The CA certificates contained in this package are installed into
2467“/usr/share/ca-certificatesâ€Â.
2468
2469The configuration file “/etc/ca-certificates.conf†is seeded with
2470trust information through Debconf. Just call “dpkg-reconfigure
2471ca-certificates†to adjust the settings.
2472
2473“update-ca-certificates†will then update “/etc/ssl/certs†which may be
2474used by the web browsers in Debian. It will also generate the hash
2475symlinks and generate a single-file version in
2476“/etc/ssl/certs/ca-certificates.crtâ€Â.
2477
2478If you want to install local certificate authorities to be implicitly
2479trusted, please put the certificate files as single files ending with
2480“.crt“ into “/usr/local/share/ca-certificates†and re-run
2481“update-ca-certificatesâ€Â. If you want to prepare a local package
2482of your certificates, you should depend on “ca-certificates“, install
2483the PEM files into “/usr/local/share/ca-certificates†as above and call
2484“update-ca-certificates†in the package's “postinst“.
2485
2486How certificates will be accepted into the ca-certificates package
2487------------------------------------------------------------------
2488
2489 Option 1:
2490 - File a *GPG-signed* bug report against ca-certificates with
2491 *severity normal*. The bug report must include an attached
2492 copy of the PEM certificates of the CA, a link to and a
2493 description of the CA, the licence of the CA certificate
2494 and signed fingerprint and/or hash values of the certificate.
2495 - Get two or three recommendations from other people to the
2496 bug report, GPG-signed (preferably from the strong set).
2497 - CA certificates will not be accepted if requested by only
2498 one person.
2499
2500 Option 2:
2501 - Get it included into Mozilla's trust store.
2502 - File a bug against ca-certificates stating this fact.
2503 ca-certificates was originally written and maintained by Fumitoshi UKAI
2504<ukai@debian.or.jp> on Mon, 7 Jan 2002 21:16:51 +0900.
2505
2506The original source can always be found at:
2507ftp://ftp.debian.org/dists/unstable/main/source/
2508
2509
2510sbin/update-ca-certificates:
2511
2512 Copyright (c) 2003 Fumitoshi UKAI <ukai@debian.or.jp>
2513 Copyright (c) 2009 Philipp Kern <pkern@debian.org>
2514
2515 This program is free software; you can redistribute it and/or modify
2516 it under the terms of the GNU General Public License as published by
2517 the Free Software Foundation; either version 2 of the License, or
2518 (at your option) any later version.
2519
2520 This program is distributed in the hope that it will be useful,
2521 but WITHOUT ANY WARRANTY; without even the implied warranty of
2522 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2523 GNU General Public License for more details.
2524
2525 You should have received a copy of the GNU General Public License
2526 along with this program; if not, write to the Free Software
2527 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,
2528 USA.
2529
2530mozilla/certdata2pem.py:
2531
2532 Copyright (c) 2009 Philipp Kern <pkern@debian.org>
2533 (based on a Ruby script by Fumitoshi UKAI)
2534 Licensed under the same license as sbin/update-ca-certificates.
2535
2536CA certificates from Mozilla as follows:
2537# The contents of this file are subject to the Mozilla Public
2538# License Version 1.1 (the "License"); you may not use this file
2539# except in compliance with the License. You may obtain a copy of
2540# the License at http://www.mozilla.org/MPL/
2541#
2542# Software distributed under the License is distributed on an "AS
2543# IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
2544# implied. See the License for the specific language governing
2545# rights and limitations under the License.
2546#
2547# The Original Code is the Netscape security libraries.
2548#
2549# The Initial Developer of the Original Code is Netscape
2550# Communications Corporation. Portions created by Netscape are
2551# Copyright (C) 1994-2000 Netscape Communications Corporation. All
2552# Rights Reserved.
2553#
2554# Contributor(s):
2555#
2556# Alternatively, the contents of this file may be used under the
2557# terms of the GNU General Public License Version 2 or later (the
2558# "GPL"), in which case the provisions of the GPL are applicable
2559# instead of those above. If you wish to allow use of your
2560# version of this file only under the terms of the GPL and not to
2561# allow others to use your version of this file under the MPL,
2562# indicate your decision by deleting the provisions above and
2563# replace them with the notice and other provisions required by
2564# the GPL. If you do not delete the provisions above, a recipient
2565# may use your version of this file under either the MPL or the
2566# GPL.
2567
2568On Debian GNU/Linux systems, the complete text of the GNU General Public
2569License can be found in '/usr/share/common-licenses/GPL'.
2570
2571 This is Checkbox which provides an extensible interface for system testing.
2572
2573See the following page for documentation:
2574
2575https://wiki.ubuntu.com/Testing/Automation/Checkbox
2576 This package was debianized by Marc Tardif <marc.tardif@canonical.com> Mon,
257717 Sep 2007 17:25:54 -0300.
2578
2579It was downloaded from http://launchpad.net/checkbox
2580
2581Upstream Authors:
2582 Marc Tardif <marc.tardif@canonical.com>
2583 Christian Reis <christian.reis@canonical.com>
2584 David Murphy <david.murphy@canonical.com>
2585 Martin Pitt <martin.pitt@ubuntu.com>
2586 Gustavo Niemeyer <gustavo@niemeyer.net>
2587
2588Copyright:
2589 Copyright 2008 Canonical Ltd.
2590 Copyright 2006 Gustavo Niemeyer
2591
2592License:
2593
2594 This package is free software: you can redistribute it and/or modify
2595 it under the terms of the GNU General Public License as published by
2596 the Free Software Foundation, either version 3 of the License, or
2597 (at your option) any later version.
2598
2599 This program is distributed in the hope that it will be useful,
2600 but WITHOUT ANY WARRANTY; without even the implied warranty of
2601 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2602 GNU General Public License for more details.
2603
2604 You should have received a copy of the GNU General Public License
2605 along with this program. If not, see <http://www.gnu.org/licenses/>.
2606
2607On Debian systems, the complete text of the GNU General
2608Public License can be found in `/usr/share/common-licenses/GPL'.
2609 This package was debianized by Marc Tardif <marc.tardif@canonical.com> Mon,
261017 Sep 2007 17:25:54 -0300.
2611
2612It was downloaded from http://launchpad.net/checkbox
2613
2614Upstream Authors:
2615 Marc Tardif <marc.tardif@canonical.com>
2616 Christian Reis <christian.reis@canonical.com>
2617 David Murphy <david.murphy@canonical.com>
2618 Martin Pitt <martin.pitt@ubuntu.com>
2619 Gustavo Niemeyer <gustavo@niemeyer.net>
2620
2621Copyright:
2622 Copyright 2008 Canonical Ltd.
2623 Copyright 2006 Gustavo Niemeyer
2624
2625License:
2626
2627 This package is free software: you can redistribute it and/or modify
2628 it under the terms of the GNU General Public License as published by
2629 the Free Software Foundation, either version 3 of the License, or
2630 (at your option) any later version.
2631
2632 This program is distributed in the hope that it will be useful,
2633 but WITHOUT ANY WARRANTY; without even the implied warranty of
2634 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2635 GNU General Public License for more details.
2636
2637 You should have received a copy of the GNU General Public License
2638 along with this program. If not, see <http://www.gnu.org/licenses/>.
2639
2640On Debian systems, the complete text of the GNU General
2641Public License can be found in `/usr/share/common-licenses/GPL'.
2642 cmap-adobe-japan2 for Debian
2643----------------------
2644
2645The use of the Adobe-Japan2-0 character collection is now deprecated
2646because the Adobe-Japan1-6 character collection made it
2647obsolete.
2648
2649 -- Kenshi Muto <kmuto@debian.org>, Thu, 1 Oct 2009 21:22:17 +0900
2650
2651 This package was debianized by Yasuhiro Take <take@debian.org> on
2652Fri, 1 Dec 2000 19:26:17 +0900.
2653
2654It was downloaded from http://opensource.adobe.com/wiki/display/cmap/Downloads
2655
2656Upstream Author:
2657
2658 Adobe Systems Incorporated.
2659
2660Copyright:
2661
2662 Copyright (C) 1990-2009 Adobe Systems Incorporated.
2663
2664License:
2665
2666 Copyright 1990-2009 Adobe Systems Incorporated.
2667 All rights reserved.
2668
2669 Redistribution and use in source and binary forms, with or
2670 without modification, are permitted provided that the
2671 following conditions are met:
2672
2673 Redistributions of source code must retain the above
2674 copyright notice, this list of conditions and the following
2675 disclaimer.
2676
2677 Redistributions in binary form must reproduce the above
2678 copyright notice, this list of conditions and the following
2679 disclaimer in the documentation and/or other materials
2680 provided with the distribution.
2681
2682 Neither the name of Adobe Systems Incorporated nor the names
2683 of its contributors may be used to endorse or promote
2684 products derived from this software without specific prior
2685 written permission.
2686
2687 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
2688 CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
2689 INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
2690 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
2691 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
2692 CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
2693 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
2694 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
2695 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2696 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
2697 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
2698 OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
2699 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2700
2701The Debian packaging is (C) 2000-2001 Yasuhiro Take <take@debian.org>,
27022003-2007 Akira TAGOH <tagoh@debian.org>, 2007-2009 Kenshi Muto
2703<kmuto@debian.org> and Masayuki Hatta <mhatta@debian.org>, and
2704is licensed under the GPL, see `/usr/share/common-licenses/GPL'.
2705
2706Note from http://opensource.adobe.com/wiki/display/cmap/License
2707------------------------------------------------------------------------
2708Although the license associated with the CMap resources clearly allows
2709changes to be made, we strongly discourage changes, especially when they
2710affect existing mappings. This is for reasons of compatibility. We do
2711welcome and encourage suggestions for additional mappings.
2712------------------------------------------------------------------------
2713 Format: http://dep.debian.net/deps/dep5
2714Upstream-Name: colord
2715Source: http://www.freedesktop.org/software/colord/
2716
2717Files: *
2718Copyright: © 2009-2011 Richard Hughes <richard@hughsie.com>
2719License: GPL-2+
2720
2721Files: libcolord/*
2722Copyright: © 2010-2011 Richard Huges <richard@hughsie.com>
2723License: LGPL-2.1+
2724
2725Files: libcolord/colord.h
2726Copyright: © 2010-2011 Richard Hughes <richard@hughsie.com>
2727License: GPL-2+
2728
2729Files: libcolord/cd-color.h
2730Copyright: © 2010 Richard Hughes <richard@hughsie.com>
2731License: GPL-2+
2732
2733Files: examples/*
2734Copyright: © 2011 Richard Hughes <richard@hughsie.com>
2735License: LGPL-2.1+
2736
2737Files: doc/api/dbus/spec-to-docbook.xsl
2738Copyright: © 2007 William Jon McCann
2739License: GPL-2+
2740
2741Files: debian/*
2742Copyright: 2011 Christopher James Halse Rogers <raof@ubuntu.com>
2743License: GPL-2+
2744
2745License: GPL-2+
2746 This package is free software; you can redistribute it and/or modify
2747 it under the terms of the GNU General Public License as published by
2748 the Free Software Foundation; either version 2 of the License, or
2749 (at your option) any later version.
2750 .
2751 This package is distributed in the hope that it will be useful,
2752 but WITHOUT ANY WARRANTY; without even the implied warranty of
2753 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2754 GNU General Public License for more details.
2755 .
2756 You should have received a copy of the GNU General Public License
2757 along with this program. If not, see <http://www.gnu.org/licenses/>
2758 .
2759 On Debian systems, the complete text of the GNU General
2760 Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
2761
2762License: LGPL-2.1+
2763 This library is free software; you can redistribute it and/or
2764 modify it under the terms of the GNU Lesser General Public
2765 License as published by the Free Software Foundation; either
2766 version 2.1 of the License, or (at your option) any later version.
2767 .
2768 This library is distributed in the hope that it will be useful,
2769 but WITHOUT ANY WARRANTY; without even the implied warranty of
2770 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
2771 Lesser General Public License for more details.
2772 .
2773 You should have received a copy of the GNU Lesser General Public
2774 License along with this library; if not, write to the Free Software
2775 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
2776 This application implements the command-not-found spec at:
2777https://wiki.ubuntu.com/CommandNotFoundMagic
2778
2779If you want automatic prompts to install the package, set
2780COMMAND_NOT_FOUND_INSTALL_PROMPT in your environment.
2781
2782To use it in bash, please add the following line to your .bashrc file:
2783. /etc/bash_command_not_found
2784
2785To use it in zsh, please add the following line to your .zshrc file:
2786. /etc/zsh_command_not_found
2787Note that it overrides the preexec and precmd functions, in case you have
2788defined your own.
2789 This package was debianized by Michael Vogt <michael.vogt@ubuntu.com> on
2790Fri, 31 May 2005 10:10:41 +0100.
2791
2792It was downloaded via bzr from
2793https://code.launchpad.net/~zkrynicki/command-not-found/main
2794
2795The ubuntu source is at:
2796https://code.edge.launchpad.net/~ubuntu-core-dev/command-not-found/ubuntu
2797
2798Upstream Author: Zygmunt Krynicki <zkrynicki@gmail.com>
2799 Michael Vogt <michael.vogt@ubuntu.com>
2800
2801Copyright: GPL, see /usr/share/common-licenses/GPL
2802
2803 This package was debianized by Michael Vogt <michael.vogt@ubuntu.com> on
2804Fri, 31 May 2005 10:10:41 +0100.
2805
2806It was downloaded via bzr from
2807https://code.launchpad.net/~zkrynicki/command-not-found/main
2808
2809The ubuntu source is at:
2810https://code.edge.launchpad.net/~ubuntu-core-dev/command-not-found/ubuntu
2811
2812Upstream Author: Zygmunt Krynicki <zkrynicki@gmail.com>
2813 Michael Vogt <michael.vogt@ubuntu.com>
2814
2815Copyright: GPL, see /usr/share/common-licenses/GPL
2816
2817 This package was debianized by Thierry Reding <thierry@gilfi.de> on
2818Fri, 18 Aug 2006 09:46:24 +0200.
2819
2820It was downloaded from http://xorg.freedesktop.org/releases/individual/app.
2821
2822Upstream author: David Reveman <davidr@novell.com>
2823Contributors:
2824 Radek Doulik <rodo@novell.com>
2825 Jeremy C. Reed <reed@reedmedia.net>
2826 Dan Winship <danw@novell.com>
2827 Kristian Høgsberg <krh@redhat.com>
2828
2829------------------------------------------------------------------------------
2830
2831The original source tarball was repackaged to remove the following generated
2832and/or unused files:
2833
2834 kde/window-decorator/*.moc.cpp
2835 kde/window-decorator/KWinInterface_skel.cpp
2836 po/*.gmo
2837
2838------------------------------------------------------------------------------
2839
2840Copyright:
2841
2842This software is copyright © 2005, 2006 Novell, Inc.
2843
2844You can redistribute this software and/or modify it under the terms of the GNU
2845General Public License as published by the Free Software Foundation; version 2
2846dated June, 1991.
2847
2848This program is distributed in the hope that it will be useful, but-
2849WITHOUT ANY WARRANTY; without even the implied warranty of
2850MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU-
2851General Public License for more details.
2852
2853------------------------------------------------------------------------------
2854
2855The convertProperty / convert_property and handleSelectionRequest /
2856handle_selection_request functions in 'src/display.c' and
2857'gtk/window-decorator/gtk-window-decorator.c' are taken from the source code
2858of fvwm2 and copyright © Matthias Clasen and Dominik Vogt.
2859
2860Parts of the code in 'src/window.c':
2861
2862 /* Ater gdk_window_constrain_size(), which is partially borrowed from fvwm.
2863 *
2864 * Copyright 1993, Robert Nation
2865 * You may use this code for any purpose, as long as the original
2866 * copyright remains in the source code and all documentation
2867 *
2868 * which in turn borrows parts of the algorithm from uwm
2869 */
2870
2871------------------------------------------------------------------------------
2872-- Plugins: --
2873--------------
2874
2875Skydome support for the 'cube' plugin was written by Mirco Müller
2876<macslow@bangang.de>.
2877
2878For the 'place' plugin:
2879
2880 /*
2881 * Copyright (C) 2001 Havoc Pennington
2882 * Copyright (C) 2002, 2003 Red Hat, Inc.
2883 * Copyright (C) 2003 Rob Adams
2884 * Copyright (C) 2005 Novell, Inc.
2885 *
2886 * This program is free software; you can redistribute it and/or
2887 * modify it under the terms of the GNU General Public License as
2888 * published by the Free Software Foundation; either version 2 of the
2889 * License, or (at your option) any later version.
2890 *
2891 * This program is distributed in the hope that it will be useful, but
2892 * WITHOUT ANY WARRANTY; without even the implied warranty of
2893 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
2894 * General Public License for more details.
2895 *
2896 * You should have received a copy of the GNU General Public License
2897 * along with this program; if not, write to the Free Software
2898 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
2899 * 02110-1301, USA.
2900 */
2901
2902The 'plane' plugin was written by Søren Sandmann <sandmann@redhat.com>:
2903
2904 /*
2905 * Copyright © 2006 Red Hat, Inc.
2906 *
2907 * Permission to use, copy, modify, distribute, and sell this software
2908 * and its documentation for any purpose is hereby granted without
2909 * fee, provided that the above copyright notice appear in all copies
2910 * and that both that copyright notice and this permission notice
2911 * appear in supporting documentation, and that the name of
2912 * Red Hat, Inc. not be used in advertising or publicity pertaining to
2913 * distribution of the software without specific, written prior permission.
2914 * Red Hat, Inc. makes no representations about the suitability of this
2915 * software for any purpose. It is provided "as is" without express or
2916 * implied warranty.
2917 *
2918 * RED HAT, INC. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
2919 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
2920 * NO EVENT SHALL RED HAT, INC. BE LIABLE FOR ANY SPECIAL, INDIRECT OR
2921 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
2922 * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
2923 * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
2924 * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
2925 *
2926 * Author: Søren Sandmann <sandmann@redhat.com>
2927 */
2928
2929------------------------------------------------------------------------------
2930-- Translations: --
2931-------------------
2932
2933The Finnish translation in 'po/fi.po' is copyright © 2003 SuSE Linux AG and ©
29342005 SUSE Linux Products GmbH.
2935
2936The Polish translation in 'po/pl.po' are copyright © 2005 SUSE Linux Products
2937GmbH.
2938
2939The makefile 'po/Makefile.in.in' is copyright © 1995, 1996, 1997 by Ulrich
2940Drepper <drepper@gnu.ai.mit.edu>.
2941
2942------------------------------------------------------------------------------
2943
2944The Debian packaging is copyright © 2006, 2007 by Thierry Reding
2945<thierry@gilfi.de> and is licensed under the GPL, see
2946`/usr/share/common-licenses/GPL'.
2947 compiz - OpenGL window and compositing manager
2948
2949Compiz is an OpenGL compositing manager that use GLX_EXT_texture_from_pixmap
2950for binding redirected top-level windows to texture objects. It has a flexible
2951plug-in system and it is designed to run well on most graphics hardware.
2952
2953David Reveman
2954davidr@novell.com
2955 Xorg Server Configuration
2956=========================
2957
2958In order for compiz to work you need to add the following to you server
2959configuration file (/etc/X11/xorg.conf):
2960
2961 + Enable the composite extension: locate the section named "Extensions" and
2962 add the following line:
2963
2964 Option "Composite" "enable"
2965
2966 If there is no section "Extensions" yet, you should add one that looks
2967 like this:
2968
2969 Section "Extensions"
2970 Option "Composite" "enable"
2971 EndSection
2972
2973 + Make XAA not hold any pixmaps in offscreen memory. This slows down compiz
2974 in many configurations. You can disable this by adding the following line
2975 to your "Device" section:
2976
2977 Option "XAANoOffscreenPixmaps" "true"
2978
2979Now restart your X server and login to your favorite session. After the
2980session has loaded completely, open a terminal window and type the following
2981command:
2982
2983 $ compiz --replace &
2984
2985Which will start compiz, make it replace the current window manager and
2986background the process so you can safely close the terminal again. If all went
2987well, compiz should start up and enable a whole bunch of desktop effects.
2988
2989 -- Thierry Reding <thierry@gilfi.de> Tue, 3 Oct 2006 14:12:26 +0200
2990General:
2991
2992* Session management
2993
2994* Various window management improvements
2995
2996* Window shade mode
2997
2998* Support for multiple desktops
2999
3000* Multi-screen support
3001
3002
3003KDE:
3004
3005* Remove glib dependency from place plugin
3006
3007* QT/KDE configuration plugin similar to the gconf plugin
3008
3009* QT/KDE decoration program
3010Repos Merger <guillaume@segu.in>
3011Repos Merger <reposmerger@opencompositing.org>
3012Sam Spilsbury <SmSpillaz@gmail.com>
3013Sam Spilsbury <sam.spilsbury@canonical.com>
3014Sam Spilsbury <smspillaz@gmail.com>
3015Scott Moreau <oreaus@gmail.com>
3016 This package was debianized by Sean Finney <seanius@debian.org>.
3017
3018It was downloaded from git://anongit.compiz-fusion.org/fusion/plugins-main
3019
3020Upstream Authors (Lead Developers, see AUTHORS for full list):
3021
3022 Danny Baumann <dannybaumann@web.de>
3023 David Reveman <davidr@novell.com>
3024 Dennis Kasprzyk <onestone@opencompositing.org>
3025 Erkin Bahceci <erkinbah@gmail.com>
3026 Guillaume Seguin - iXce <guillaume@segu.in>
3027 Kristian Lyngstøl <kristian@bohemians.org>
3028
3029License:
3030
3031 GPL, see `/usr/share/common-licenses/GPL'
3032
3033The Debian packaging is (C) 2007, sean finney <seanius@debian.org> and
3034is licensed under the GPL, see `/usr/share/common-licenses/GPL'. Christopher Williams <christopherw@verizon.net>
3035Danny Baumann <dannybaumann@web.de>
3036Dennis Kasprzyk <onestone@beryl-project.org>
3037Dennis Kasprzyk <onestone@opencompositing.org>
3038Didier Roche <didrocks@ubuntu.com>
3039Erkin Bahceci <erkinbah@gmail.com>
3040Guido Iribarren <guidoweb@guidoi.com.ar>
3041Guillaume Seguin <guillaume@segu.in>
3042Jigish Gohil <cyberorg@prime.(none)>
3043Kristian Lyngstøl <kristian@albus.(none)>
3044Robert Carr <racarr@gorbie.(none)>
3045Sam Spilsbury <SmSpillaz@gmail.com>
3046Sam Spilsbury <sam.spilsbury@canonical.com>
3047Sam Spilsbury <smspillaz@XPS-FEDORA.(none)>
3048Sam Spilsbury <smspillaz@XPS-UNITY.(none)>
3049Sam Spilsbury <smspillaz@gmail.com>
3050Scott Moreau <oreaus@gmail.com>
3051maniac <maniac>
3052 This package was debianized by Sean Finney <seanius@debian.org>.
3053
3054It was downloaded from git://anongit.compiz-fusion.org/fusion/compizconfig/compizconfig-backend-gconf
3055
3056Upstream Authors (Lead Developers, see AUTHORS for full list):
3057
3058 Danny Baumann <dannybaumann@web.de>
3059 David Reveman <davidr@novell.com>
3060 Dennis Kasprzyk <onestone@opencompositing.org>
3061 Erkin Bahceci <erkinbah@gmail.com>
3062 Guillaume Seguin - iXce <guillaume@segu.in>
3063 Kristian Lyngstøl <kristian@bohemians.org>
3064
3065License:
3066
3067 GPL, see `/usr/share/common-licenses/GPL'
3068
3069The Debian packaging is (C) 2007, sean finney <seanius@debian.org> and
3070is licensed under the GPL, see `/usr/share/common-licenses/GPL'.
3071 Since the installation scripts of this package ask most of the Debconf
3072questions with low or medium priority, you may want to use
3073
3074dpkg-reconfigure console-setup
3075
3076in order to fine-tune your keyboard setup.
3077
3078Please notice that this package does not conflict with other packages
3079that configure the console.
3080
3081If 'kbd' and 'console-setup' are installed, then 'console-setup'
3082configures the font and the keyboard on the console and 'kbd' the rest
3083(i.e. NumLock state, keyboard repeat rate).
3084
3085If 'console-tools' and 'console-setup' are installed, then both
3086packages will try to configure the font and the keyboard. However
3087'console-setup' configures after 'console-tools' so its font and
3088keyboard will be used.
3089
3090If 'console-cyrillic' and 'console-setup' are installed, then both
3091packages will try to configure the font and the keyboard. However
3092'console-cyrillic configures after 'console-setup' so its font and
3093keyboard will be used. It is probably a good idea to uninstall
3094'console-cyrillic' because 'console-setup' provides better support.
3095
3096 -- Anton Zinoviev <zinoviev@debian.org>, Wed, 3 Jun 2009 00:51:02 +0300
3097 All console fonts are public domain by nature. The source BDF-fonts
3098are distributed under many different licenses, see in the file
3099copyright.fonts for details.
3100
3101Everything else in this package is
3102
3103Copyright (c) 1999,2000,2001,2002,2003,2006 Anton Zinoviev, zinoviev@debian.org
3104
3105It is distributed under terms of the GNU General Public License
3106version 2.0 or (at your choice) any later version.
3107
3108It is distributed in the hope that it will be useful, but WITHOUT ANY
3109WARRANTY; without even the implied warranty of MERCHANTABILITY or
3110FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
3111for more details.
3112
3113You should have received a copy of the GNU Lesser General Public
3114License along with this library; if not, write to the Free Software
3115Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
311602110-1301, USA
3117
3118On Debian GNU/Linux systems, the complete text of the GNU General
3119Public License can be found in `/usr/share/common-licenses/GPL'.
3120 William Jon McCann <william.jon.mccann@gmail.com> <?xml version="1.0" encoding="UTF-8"?>
3121<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3122<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ConsoleKit 0.4.5 Documentation</title><link rel="stylesheet" type="text/css" href="docbook.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /></head><body><div class="book" title="ConsoleKit 0.4.5 Documentation"><div class="titlepage"><div><div><h1 class="title"><a id="index"></a>ConsoleKit 0.4.5 Documentation</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">William Jon</span> <span class="surname">McCann</span></h3><div class="affiliation"><div class="address"><p><br />
3123            <code class="email"><<a class="email" href="mailto:william.jon.mccann@gmail.com">william.jon.mccann@gmail.com</a>></code><br />
3124          </p></div></div></div></div></div><div><p class="releaseinfo">Version 0.4.5</p></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="preface"><a href="#idp87576">Introduction</a></span></dt><dt><span class="part"><a href="#idp636872">I. Concepts</a></span></dt><dd><dl><dt><span class="chapter"><a href="#introduction">1. Introduction</a></span></dt><dd><dl><dt><span class="sect1"><a href="#idp637960">About</a></span></dt><dt><span class="sect1"><a href="#idp638824">Defining the Problem</a></span></dt><dt><span class="sect1"><a href="#idp639400">Relevant art</a></span></dt></dl></dd><dt><span class="chapter"><a href="#terms">2. Terminology</a></span></dt><dd><dl><dt><span class="sect1"><a href="#idp2455296">Session</a></span></dt><dt><span class="sect1"><a href="#idp2457568">Session leader</a></span></dt><dt><span class="sect1"><a href="#idp2453496">Seat</a></span></dt></dl></dd><dt><span class="chapter"><a href="#design">3. Design</a></span></dt><dd><dl><dt><span class="sect1"><a href="#idp172304">Session Lifecycle</a></span></dt><dt><span class="sect1"><a href="#idp157128">Expected Usage</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp157720">Text Login Manager</a></span></dt><dt><span class="sect2"><a href="#idp160472">Graphical Login Manager</a></span></dt><dt><span class="sect2"><a href="#idp3014264">System Daemon</a></span></dt><dt><span class="sect2"><a href="#idp3016216">Hardware Abstraction Layer</a></span></dt><dt><span class="sect2"><a href="#idp3019208">Fast User Switching Agent</a></span></dt><dt><span class="sect2"><a href="#idp3023960">Session Daemon (aka Policy Agent)</a></span></dt><dt><span class="sect2"><a href="#idp3025992">Session Application</a></span></dt></dl></dd></dl></dd></dl></dd><dt><span class="part"><a href="#idp72856">II. Reference</a></span></dt><dd><dl><dt><span class="reference"><a href="#dbus-reference">I. D-Bus API Reference</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#Manager">org.freedesktop.ConsoleKit.Manager</a></span><span class="refpurpose">  Manager interface</span></dt><dt><span class="refentrytitle"><a href="#Seat">org.freedesktop.ConsoleKit.Seat</a></span><span class="refpurpose">  Seat interface</span></dt><dt><span class="refentrytitle"><a href="#Session">org.freedesktop.ConsoleKit.Session</a></span><span class="refpurpose">  Session interface</span></dt></dl></dd></dl></dd><dt><span class="index"><a href="#idp3489568">Index</a></span></dt></dl></div><div class="preface" title="Introduction"><div class="titlepage"><div><div><h2 class="title"><a id="idp87576"></a>Introduction</h2></div></div></div><p>
3125 </p></div><div class="part" title="Part I. Concepts"><div class="titlepage"><div><div><h1 class="title"><a id="idp636872"></a>Part I. Concepts</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="chapter"><a href="#introduction">1. Introduction</a></span></dt><dd><dl><dt><span class="sect1"><a href="#idp637960">About</a></span></dt><dt><span class="sect1"><a href="#idp638824">Defining the Problem</a></span></dt><dt><span class="sect1"><a href="#idp639400">Relevant art</a></span></dt></dl></dd><dt><span class="chapter"><a href="#terms">2. Terminology</a></span></dt><dd><dl><dt><span class="sect1"><a href="#idp2455296">Session</a></span></dt><dt><span class="sect1"><a href="#idp2457568">Session leader</a></span></dt><dt><span class="sect1"><a href="#idp2453496">Seat</a></span></dt></dl></dd><dt><span class="chapter"><a href="#design">3. Design</a></span></dt><dd><dl><dt><span class="sect1"><a href="#idp172304">Session Lifecycle</a></span></dt><dt><span class="sect1"><a href="#idp157128">Expected Usage</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp157720">Text Login Manager</a></span></dt><dt><span class="sect2"><a href="#idp160472">Graphical Login Manager</a></span></dt><dt><span class="sect2"><a href="#idp3014264">System Daemon</a></span></dt><dt><span class="sect2"><a href="#idp3016216">Hardware Abstraction Layer</a></span></dt><dt><span class="sect2"><a href="#idp3019208">Fast User Switching Agent</a></span></dt><dt><span class="sect2"><a href="#idp3023960">Session Daemon (aka Policy Agent)</a></span></dt><dt><span class="sect2"><a href="#idp3025992">Session Application</a></span></dt></dl></dd></dl></dd></dl></div><div class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a id="introduction"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="sect1"><a href="#idp637960">About</a></span></dt><dt><span class="sect1"><a href="#idp638824">Defining the Problem</a></span></dt><dt><span class="sect1"><a href="#idp639400">Relevant art</a></span></dt></dl></div><div class="sect1" title="About"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp637960"></a>About</h2></div></div></div><p>
3126 ConsoleKit is a framework for keeping track of the various
3127 users, sessions, and seats present on a system. It
3128 provides a mechanism for software to react to changes of any of
3129 these items or of any of the metadata associated with them.
3130 </p></div><div class="sect1" title="Defining the Problem"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp638824"></a>Defining the Problem</h2></div></div></div><p>
3131 To be written.
3132 </p></div><div class="sect1" title="Relevant art"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp639400"></a>Relevant art</h2></div></div></div><p>
3133 To be written.
3134 </p></div></div><div class="chapter" title="Chapter 2. Terminology"><div class="titlepage"><div><div><h2 class="title"><a id="terms"></a>Chapter 2. Terminology</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="sect1"><a href="#idp2455296">Session</a></span></dt><dt><span class="sect1"><a href="#idp2457568">Session leader</a></span></dt><dt><span class="sect1"><a href="#idp2453496">Seat</a></span></dt></dl></div><div class="sect1" title="Session"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp2455296"></a>Session</h2></div></div></div><p>
3135A session is a collection of all processes that share knowledge of a
3136secret. In the typical (or ideal) case, these processes all originate
3137from a single common ancestor.
3138 </p><p>
3139As an implementation detail, for now, this secret should be stored in
3140the process environment by the session leader under the name
3141XDG_SESSION_COOKIE. When and if we are able to take advantage of a
3142mechanism in the underlying system to store session registration
3143information - we will. However, such a mechanism is not known at the
3144present time.
3145 </p><p>
3146Using an environment variable does have certain advantages. For one,
3147it is quite easy for a process to opt-out of a Session by simply
3148unsetting the XDG_SESSION_COOKIE variable.
3149 </p><p>
3150Limitations of using an environment variable implementation include
3151not being able to strictly limit visibility of the secret to a particular
3152process ancestry. So, it is not possible to enforce session boundaries
3153other than on a per-user basis. For example, we don't yet have a way
3154to prevent a process from moving between sessions owned by the same
3155user.
3156 </p></div><div class="sect1" title="Session leader"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp2457568"></a>Session leader</h2></div></div></div><p>
3157The session leader is the process that requests that a new session be
3158opened. It does this by connecting to the D-Bus system bus and using
3159either org.freedesktop.ConsoleKit.Manager.OpenSession() or
3160org.freedesktop.ConsoleKit.Manager.OpenSessionWithParameters(). The session
3161that it registers will remain open until the connection to the system
3162bus is lost or it calls org.freedesktop.ConsoleKit.Manager.CloseSession().
3163 </p><p>
3164The session leader is the only process for which CloseSession() will
3165be allowed.
3166 </p></div><div class="sect1" title="Seat"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp2453496"></a>Seat</h2></div></div></div><p>
3167A seat is a collection of sessions and a set of hardware (usually at
3168least a keyboard and mouse). Only one session may be active on a
3169seat at a time.
3170 </p><p>
3171At the present time, all Sessions that are considered "local" to
3172a system will be added the the first Seat and every other Session
3173will be added to its own Seat.
3174 </p><p>
3175True, hardware, multi-seat capabilities will be added in a later release.
3176 </p></div></div><div class="chapter" title="Chapter 3. Design"><div class="titlepage"><div><div><h2 class="title"><a id="design"></a>Chapter 3. Design</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="sect1"><a href="#idp172304">Session Lifecycle</a></span></dt><dt><span class="sect1"><a href="#idp157128">Expected Usage</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp157720">Text Login Manager</a></span></dt><dt><span class="sect2"><a href="#idp160472">Graphical Login Manager</a></span></dt><dt><span class="sect2"><a href="#idp3014264">System Daemon</a></span></dt><dt><span class="sect2"><a href="#idp3016216">Hardware Abstraction Layer</a></span></dt><dt><span class="sect2"><a href="#idp3019208">Fast User Switching Agent</a></span></dt><dt><span class="sect2"><a href="#idp3023960">Session Daemon (aka Policy Agent)</a></span></dt><dt><span class="sect2"><a href="#idp3025992">Session Application</a></span></dt></dl></dd></dl></div><div class="sect1" title="Session Lifecycle"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp172304"></a>Session Lifecycle</h2></div></div></div><p>
3177The session leader process is responsible for asking
3178ConsoleKit to open a new session. In this respect, it is
3179similar to the traditional POSIX user login accounting framework.
3180In the typical case, the session leader is either an immediate descendant of
3181a login manager or the login manager itself. The leader makes a connection to the D-Bus system bus and asks ConsoleKit to open a session. There are two methods available for opening a session: org.freedesktop.ConsoleKit.Manager.OpenSession() and org.freedesktop.ConsoleKit.Manager.OpenSessionWithParameters().
3182 </p><p>
3183If the operation succeeds, a secret cookie will be returned to the session leader. The session leader should store this secret in the environment as XDG_SESSION_COOKIE so that it may be shared with its child processes.
3184 </p><p>
3185At this point the session will be registered with ConsoleKit and a particular
3186set of information about the session will be stored along with it.
3187 </p><p>
3188ConsoleKit will decide, based on the information associated with the session, what Seat the session will be added to.
3189 </p><p>
3190It will also be determined, based on the same set of information, whether the Session will control the hardware associated with the Seat. In other words, whether the Session will be active for the Seat it is attached to. The exact mechanism for this determination depends on the type of Seat and the capabilities of the host system.
3191 </p><p>
3192The Session will remain open until the Session Leader disconnects from the D-Bus system bus or calls org.freedesktop.ConsoleKit.Manager.CloseSession(). The session will be removed from its Seat, and deregistered.
3193 </p></div><div class="sect1" title="Expected Usage"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp157128"></a>Expected Usage</h2></div></div></div><p>Use of this service will usually follow one of the following patterns:</p><div class="sect2" title="Text Login Manager"><div class="titlepage"><div><div><h3 class="title"><a id="idp157720"></a>Text Login Manager</h3></div></div></div><p>This pattern operates as the Session Leader for a new Session. This pattern needs:
3194 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">To open a new Session.</li><li class="listitem">To set properties for the Session.</li><li class="listitem">To maintain a connection to the D-Bus system bus.</li><li class="listitem">To close the Session at logout.</li></ol></div></div><div class="sect2" title="Graphical Login Manager"><div class="titlepage"><div><div><h3 class="title"><a id="idp160472"></a>Graphical Login Manager</h3></div></div></div><p>In addition to the requirements for the Text Graphical Login Manager, this pattern is typically used to show information about currently open sessions. It needs:
3195 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">To determine which Seat it is running on.</li><li class="listitem">To know if the current seat supports session switching.</li><li class="listitem">A list of all sessions on the current Seat.</li><li class="listitem">To know which session is active for the current Seat.</li><li class="listitem">To know when the session active state changes.</li><li class="listitem">To know when sessions are added or removed.</li><li class="listitem">Access to the metadata for any open Session.</li></ol></div></div><div class="sect2" title="System Daemon"><div class="titlepage"><div><div><h3 class="title"><a id="idp3014264"></a>System Daemon</h3></div></div></div><p>This is generally a daemon process running outside of a user session as a special user. This pattern needs:
3196 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">To know if any user sessions are open.</li><li class="listitem">To know if the system is currently being used.</li></ol></div></div><div class="sect2" title="Hardware Abstraction Layer"><div class="titlepage"><div><div><h3 class="title"><a id="idp3016216"></a>Hardware Abstraction Layer</h3></div></div></div><p>This is a special case of System Daemon that provides catalogs and control mechanisms for hardware devices. In addition to the requirements of System Daemon, this pattern needs:
3197 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">To determine what hardware is associated with a Seat.</li><li class="listitem">To determine what Session is active and inactive on a particular Seat.</li><li class="listitem">To know when the session active state changes.</li><li class="listitem">To determine what Session a process belongs to.</li></ol></div></div><div class="sect2" title="Fast User Switching Agent"><div class="titlepage"><div><div><h3 class="title"><a id="idp3019208"></a>Fast User Switching Agent</h3></div></div></div><p>This is related to the Graphical Login Manager and provides a shortcut to similar functionality. It is usually a tool available in the user session that allows one to quickly switch to another user session. This pattern needs:
3198 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">To determine which session it is running in.</li><li class="listitem">To determine which Seat it is running on.</li><li class="listitem">To know if the current seat supports session switching.</li><li class="listitem">A list of all sessions on the current Seat.</li><li class="listitem">Which session is active for the current Seat.</li><li class="listitem">To know when the session active state changes.</li><li class="listitem">Access to the metadata for any open Session.</li><li class="listitem">To know when sessions are added or removed.</li></ol></div></div><div class="sect2" title="Session Daemon (aka Policy Agent)"><div class="titlepage"><div><div><h3 class="title"><a id="idp3023960"></a>Session Daemon (aka Policy Agent)</h3></div></div></div><p>This is typically a daemon running in a user session that acts on policy only when the session is active. This pattern needs:
3199 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">To determine which session it is running in.</li><li class="listitem">To know when the session active state changes.</li></ol></div></div><div class="sect2" title="Session Application"><div class="titlepage"><div><div><h3 class="title"><a id="idp3025992"></a>Session Application</h3></div></div></div><p>This is typically an application running in a user session that may alter its behavior when the session active state changes. This pattern needs:
3200 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">To determine which session it is running in.</li><li class="listitem">To know when the session active state changes.</li></ol></div></div></div></div></div><div class="part" title="Part II. Reference"><div class="titlepage"><div><div><h1 class="title"><a id="idp72856"></a>Part II. Reference</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="reference"><a href="#dbus-reference">I. D-Bus API Reference</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#Manager">org.freedesktop.ConsoleKit.Manager</a></span><span class="refpurpose">  Manager interface</span></dt><dt><span class="refentrytitle"><a href="#Seat">org.freedesktop.ConsoleKit.Seat</a></span><span class="refpurpose">  Seat interface</span></dt><dt><span class="refentrytitle"><a href="#Session">org.freedesktop.ConsoleKit.Session</a></span><span class="refpurpose">  Session interface</span></dt></dl></dd></dl></div><div class="reference" title="D-Bus API Reference"><div class="titlepage"><div><div><h1 class="title"><a id="dbus-reference"></a>D-Bus API Reference</h1></div></div><hr /></div><div class="partintro" title="D-Bus API Reference"><div></div><p>
3201 ConsoleKit provides a D-Bus API for programs to obtain information about the
3202 users, sessions, and seats that are present on a system.
3203 </p><p>
3204 Please see the other sections of this manual for an introduction to
3205 these concepts.
3206 </p><p>
3207 This API is not yet stable and is likely to change in the future.
3208 </p><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="refentrytitle"><a href="#Manager">org.freedesktop.ConsoleKit.Manager</a></span><span class="refpurpose">  Manager interface</span></dt><dt><span class="refentrytitle"><a href="#Seat">org.freedesktop.ConsoleKit.Seat</a></span><span class="refpurpose">  Seat interface</span></dt><dt><span class="refentrytitle"><a href="#Session">org.freedesktop.ConsoleKit.Session</a></span><span class="refpurpose">  Session interface</span></dt></dl></div></div><div class="refentry" title="org.freedesktop.ConsoleKit.Manager"><a id="Manager"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>org.freedesktop.ConsoleKit.Manager  Manager interface</p></div><div class="refsynopsisdiv" title="Methods"><h2>Methods</h2><pre class="synopsis"><a class="link" href="#Manager.Restart">Restart</a> ()
3209<a class="link" href="#Manager.CanRestart">CanRestart</a> (out 'b' can_restart)
3210<a class="link" href="#Manager.Stop">Stop</a> ()
3211<a class="link" href="#Manager.CanStop">CanStop</a> (out 'b' can_stop)
3212<a class="link" href="#Manager.OpenSession">OpenSession</a> (out 's' cookie)
3213<a class="link" href="#Manager.OpenSessionWithParameters">OpenSessionWithParameters</a> (in 'a(sv)' parameters,
3214 out 's' cookie)
3215<a class="link" href="#Manager.CloseSession">CloseSession</a> (in 's' cookie,
3216 out 'b' result)
3217<a class="link" href="#Manager.GetSeats">GetSeats</a> (out 'ao' seats)
3218<a class="link" href="#Manager.GetSessions">GetSessions</a> (out 'ao' sessions)
3219<a class="link" href="#Manager.GetSessionForCookie">GetSessionForCookie</a> (in 's' cookie,
3220 out 'o' ssid)
3221<a class="link" href="#Manager.GetSessionForUnixProcess">GetSessionForUnixProcess</a> (in 'u' pid,
3222 out 'o' ssid)
3223<a class="link" href="#Manager.GetCurrentSession">GetCurrentSession</a> (out 'o' ssid)
3224<a class="link" href="#Manager.GetSessionsForUnixUser">GetSessionsForUnixUser</a> (in 'u' uid,
3225 out 'ao' sessions)
3226<a class="link" href="#Manager.GetSessionsForUser">GetSessionsForUser</a> (in 'u' uid,
3227 out 'ao' sessions)
3228<a class="link" href="#Manager.GetSystemIdleHint">GetSystemIdleHint</a> (out 'b' idle_hint)
3229<a class="link" href="#Manager.GetSystemIdleSinceHint">GetSystemIdleSinceHint</a> (out 's' iso8601_datetime)
3230</pre></div><div class="refsect1" title="Signals"><a id="idp3073224"></a><h2>Signals</h2><pre class="synopsis"><a class="link" href="#Manager::SeatAdded">SeatAdded</a> ('o' sid)
3231<a class="link" href="#Manager::SeatRemoved">SeatRemoved</a> ('o' sid)
3232<a class="link" href="#Manager::SystemIdleHintChanged">SystemIdleHintChanged</a> ('b' hint)
3233</pre></div><div class="refsect1" title="Implemented Interfaces"><a id="idp3075152"></a><h2>Implemented Interfaces</h2><p>
3234 Objects implementing org.freedesktop.ConsoleKit.Manager also implements
3235 org.freedesktop.DBus.Introspectable,
3236 org.freedesktop.DBus.Properties
3237 </p></div><div class="refsect1" title="Description"><a id="idp3076136"></a><h2>Description</h2><p></p></div><div class="refsect1" title="Details"><a id="idp3076888"></a><h2>Details</h2><div class="refsect2" title="Restart ()"><a id="idp3077448"></a><h3><a id="Manager.Restart"></a>Restart ()</h3><a id="idp3077944" class="indexterm"></a><pre class="programlisting">Restart ()</pre><p>This method initiates a request to restart (ie. reboot) the computer system.</p></div><div class="refsect2" title="CanRestart ()"><a id="idp3079040"></a><h3><a id="Manager.CanRestart"></a>CanRestart ()</h3><a id="idp3079664" class="indexterm"></a><pre class="programlisting">CanRestart (out 'b' can_restart)</pre><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>can_restart</code></em>:</span></dt><dd></dd></dl></div></div><div class="refsect2" title="Stop ()"><a id="idp3082000"></a><h3><a id="Manager.Stop"></a>Stop ()</h3><a id="idp3082496" class="indexterm"></a><pre class="programlisting">Stop ()</pre><p>This method initiates a request to stop (ie. shutdown) the computer system.</p></div><div class="refsect2" title="CanStop ()"><a id="idp3083584"></a><h3><a id="Manager.CanStop"></a>CanStop ()</h3><a id="idp3084208" class="indexterm"></a><pre class="programlisting">CanStop (out 'b' can_stop)</pre><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>can_stop</code></em>:</span></dt><dd></dd></dl></div></div><div class="refsect2" title="OpenSession ()"><a id="idp3086544"></a><h3><a id="Manager.OpenSession"></a>OpenSession ()</h3><a id="idp3087040" class="indexterm"></a><pre class="programlisting">OpenSession (out 's' cookie)</pre><p>This method requests that a new <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a>
3238 be created for the calling process. The properties of this new Session are set automatically
3239 from information collected about the calling process.
3240 </p><p>This new session exists until the calling process disconnects from the system bus or
3241 calls <a class="link" href="#Manager.CloseSession"><code class="function">CloseSession()</code></a>.
3242 </p><p>It is the responsibility of the calling process to set the environment variable
3243 XDG_SESSION_COOKIE to the value of the returned cookie. This cookie should only
3244 be made available to child processes of the caller so that they may be identified
3245 as members of this session.
3246 </p><p>See this simple example:
3247 </p><div class="informalexample"><pre class="programlisting">
3248 DBusError error;
3249 DBusMessage *message;
3250 DBusMessage *reply;
3251
3252 message = dbus_message_new_method_call ("org.freedesktop.ConsoleKit",
3253 "/org/freedesktop/ConsoleKit/Manager",
3254 "org.freedesktop.ConsoleKit.Manager",
3255 "OpenSession");
3256 if (message == NULL) {
3257 goto out;
3258 }
3259
3260 dbus_error_init (&error);
3261 reply = dbus_connection_send_with_reply_and_block (connector->connection,
3262 message,
3263 -1,
3264 &error);
3265 if (reply == NULL) {
3266 goto out;
3267 }
3268
3269 dbus_error_init (&error);
3270 if (! dbus_message_get_args (reply,
3271 &error,
3272 DBUS_TYPE_STRING, &cookie,
3273 DBUS_TYPE_INVALID)) {
3274 goto out;
3275 }
3276
3277 </pre></div><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cookie</code></em>:</span></dt><dd>The secret cookie that is used to identify the new session</dd></dl></div><p>
3278See also:
3279<a class="link" href="#Manager.OpenSessionWithParameters"><code class="function">OpenSessionWithParameters()</code></a></p></div><div class="refsect2" title="OpenSessionWithParameters ()"><a id="idp3093520"></a><h3><a id="Manager.OpenSessionWithParameters"></a>OpenSessionWithParameters ()</h3><a id="idp3094096" class="indexterm"></a><pre class="programlisting">OpenSessionWithParameters (in 'a(sv)' parameters,
3280 out 's' cookie)</pre><p>This method requests that a new <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a>
3281 be created for the calling process. The properties of this new Session are from the
3282 parameters provided.
3283 </p><p>This new session exists until the calling process disconnects from the system bus or
3284 calls <a class="link" href="#Manager.CloseSession"><code class="function">CloseSession()</code></a>.
3285 </p><p>It is the responsibility of the calling process to set the environment variable
3286 XDG_SESSION_COOKIE to the value of the returned cookie. This cookie should only
3287 be made available to child processes of the caller so that they may be identified
3288 as members of this session.
3289 </p><p>See the <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a> properties for a list of valid parameters.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>parameters</code></em>:</span></dt><dd>An array of sets of property names and values</dd><dt><span class="term"><em class="parameter"><code>cookie</code></em>:</span></dt><dd>The secret cookie that is used to identify the new session</dd></dl></div><div class="note" title="Permissions" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Permissions</h3><p class="permission">This method is restricted to privileged users by D-Bus policy.</p></div><p>
3290See also:
3291<a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">org.freedesktop.ConsoleKit.Session</a></p></div><div class="refsect2" title="CloseSession ()"><a id="idp3100064"></a><h3><a id="Manager.CloseSession"></a>CloseSession ()</h3><a id="idp3100560" class="indexterm"></a><pre class="programlisting">CloseSession (in 's' cookie,
3292 out 'b' result)</pre><p>This method is used to close the session identified by the supplied cookie.
3293 </p><p>The session can only be closed by the same process that opened the session.
3294 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cookie</code></em>:</span></dt><dd>The secret cookie that is used to identify the session</dd><dt><span class="term"><em class="parameter"><code>result</code></em>:</span></dt><dd>Whether the session was successfully closed</dd></dl></div></div><div class="refsect2" title="GetSeats ()"><a id="idp3103576"></a><h3><a id="Manager.GetSeats"></a>GetSeats ()</h3><a id="idp3104072" class="indexterm"></a><pre class="programlisting">GetSeats (out 'ao' seats)</pre><p>This gets a list of all the <a class="link" href="#Seat" title="org.freedesktop.ConsoleKit.Seat">Seats</a>
3295 that are currently present on the system.</p><p>Each Seat ID is an D-Bus object path for the object that implements the
3296 <a class="link" href="#Seat" title="org.freedesktop.ConsoleKit.Seat">Seat</a> interface.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>seats</code></em>:</span></dt><dd>an array of Seat IDs</dd></dl></div><p>
3297See also:
3298<a class="link" href="#Seat" title="org.freedesktop.ConsoleKit.Seat">org.freedesktop.ConsoleKit.Seat</a></p></div><div class="refsect2" title="GetSessions ()"><a id="idp3107320"></a><h3><a id="Manager.GetSessions"></a>GetSessions ()</h3><a id="idp3107816" class="indexterm"></a><pre class="programlisting">GetSessions (out 'ao' sessions)</pre><p>This gets a list of all the <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Sessions</a>
3299 that are currently present on the system.</p><p>Each Session ID is an D-Bus object path for the object that implements the
3300 <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a> interface.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sessions</code></em>:</span></dt><dd>an array of Session IDs</dd></dl></div><p>
3301See also:
3302<a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">org.freedesktop.ConsoleKit.Session</a></p></div><div class="refsect2" title="GetSessionForCookie ()"><a id="idp3111112"></a><h3><a id="Manager.GetSessionForCookie"></a>GetSessionForCookie ()</h3><a id="idp3111608" class="indexterm"></a><pre class="programlisting">GetSessionForCookie (in 's' cookie,
3303 out 'o' ssid)</pre><p>Returns the session ID that is associated with the specified cookie.
3304 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cookie</code></em>:</span></dt><dd>The secret cookie that is used to identify the session</dd><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>The object identifier for the current session</dd></dl></div></div><div class="refsect2" title="GetSessionForUnixProcess ()"><a id="idp3114352"></a><h3><a id="Manager.GetSessionForUnixProcess"></a>GetSessionForUnixProcess ()</h3><a id="idp3114968" class="indexterm"></a><pre class="programlisting">GetSessionForUnixProcess (in 'u' pid,
3305 out 'o' ssid)</pre><p>Attempts to determine the session ID for the specified
3306 POSIX process ID (pid).
3307 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em>:</span></dt><dd>The POSIX process ID</dd><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>The object identifier for the current session</dd></dl></div></div><div class="refsect2" title="GetCurrentSession ()"><a id="idp3117672"></a><h3><a id="Manager.GetCurrentSession"></a>GetCurrentSession ()</h3><a id="idp3118168" class="indexterm"></a><pre class="programlisting">GetCurrentSession (out 'o' ssid)</pre><p>Attempts to determine the session ID that the caller belongs to.
3308 </p><p>See this example of using dbus-send:
3309 </p><div class="informalexample"><pre class="programlisting">
3310 dbus-send --system --dest=org.freedesktop.ConsoleKit \
3311 --type=method_call --print-reply --reply-timeout=2000 \
3312 /org/freedesktop/ConsoleKit/Manager \
3313 org.freedesktop.ConsoleKit.Manager.GetCurrentSession
3314 </pre></div><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>The object identifier for the current session</dd></dl></div></div><div class="refsect2" title="GetSessionsForUnixUser ()"><a id="idp3120920"></a><h3><a id="Manager.GetSessionsForUnixUser"></a>GetSessionsForUnixUser ()</h3><a id="idp3121536" class="indexterm"></a><pre class="programlisting">GetSessionsForUnixUser (in 'u' uid,
3315 out 'ao' sessions)</pre><p>This gets a list of all the <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Sessions</a>
3316 that are currently open for the specified user.</p><p>Each Session ID is an D-Bus object path for the object that implements the
3317 <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a> interface.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>uid</code></em>:</span></dt><dd>POSIX User identification</dd><dt><span class="term"><em class="parameter"><code>sessions</code></em>:</span></dt><dd>an array of Session IDs</dd></dl></div></div><div class="refsect2" title="GetSessionsForUser ()"><a id="idp3125056"></a><h3><a id="Manager.GetSessionsForUser"></a>GetSessionsForUser ()</h3><a id="idp3125552" class="indexterm"></a><pre class="programlisting">GetSessionsForUser (in 'u' uid,
3318 out 'ao' sessions)</pre><p>This gets a list of all the <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Sessions</a>
3319 that are currently open for the specified user.</p><p>Each Session ID is an D-Bus object path for the object that implements the
3320 <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a> interface.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>uid</code></em>:</span></dt><dd>User identification</dd><dt><span class="term"><em class="parameter"><code>sessions</code></em>:</span></dt><dd>an array of Session IDs</dd></dl></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><code class="literal">GetSessionsForUser</code> is deprecated since version 0.1.3 and should not be used in newly-written code. Use
3321
3322 <a class="link" href="#Manager.GetSessionsForUnixUser"><code class="function">GetSessionsForUnixUser</code></a>
3323instead.</p></div></div><div class="refsect2" title="GetSystemIdleHint ()"><a id="idp3130440"></a><h3><a id="Manager.GetSystemIdleHint"></a>GetSystemIdleHint ()</h3><a id="idp3130936" class="indexterm"></a><pre class="programlisting">GetSystemIdleHint (out 'b' idle_hint)</pre><p>Returns TRUE if the <a class="link" href="#Session:idle-hint"><code class="literal">idle-hint</code></a>
3324 property of every open session is TRUE or if there are no open sessions.
3325 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>idle_hint</code></em>:</span></dt><dd>The value of the system-idle-hint</dd></dl></div></div><div class="refsect2" title="GetSystemIdleSinceHint ()"><a id="idp3133408"></a><h3><a id="Manager.GetSystemIdleSinceHint"></a>GetSystemIdleSinceHint ()</h3><a id="idp3134024" class="indexterm"></a><pre class="programlisting">GetSystemIdleSinceHint (out 's' iso8601_datetime)</pre><p>Returns an ISO 8601 date-time string that corresponds to
3326 the time of the last change of the system-idle-hint.
3327 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>iso8601_datetime</code></em>:</span></dt><dd>An ISO 8601 format date-type string</dd></dl></div></div></div><div class="refsect1" title="Signal Details"><a id="idp3136104"></a><h2>Signal Details</h2><div class="refsect2" title="The SeatAdded signal"><a id="idp3136664"></a><h3><a id="Manager::SeatAdded"></a>The SeatAdded signal</h3><a id="idp3137160" class="indexterm"></a><pre class="programlisting">SeatAdded ('o' sid)</pre><p>Emitted when a Seat has been added to the system.
3328 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sid</code></em>:</span></dt><dd>The Seat ID for the added seat</dd></dl></div></div><div class="refsect2" title="The SeatRemoved signal"><a id="idp3139096"></a><h3><a id="Manager::SeatRemoved"></a>The SeatRemoved signal</h3><a id="idp3139592" class="indexterm"></a><pre class="programlisting">SeatRemoved ('o' sid)</pre><p>Emitted when a Seat has been removed from the system.
3329 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sid</code></em>:</span></dt><dd>The Seat ID for the removed seat</dd></dl></div></div><div class="refsect2" title="The SystemIdleHintChanged signal"><a id="idp3141528"></a><h3><a id="Manager::SystemIdleHintChanged"></a>The SystemIdleHintChanged signal</h3><a id="idp3142144" class="indexterm"></a><pre class="programlisting">SystemIdleHintChanged ('b' hint)</pre><p>Emitted when the value of the system-idle-hint has changed.
3330 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>hint</code></em>:</span></dt><dd>The value of the system-idle-hint</dd></dl></div></div></div></div><div class="refentry" title="org.freedesktop.ConsoleKit.Seat"><div class="refentry.separator"><hr /></div><a id="Seat"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>org.freedesktop.ConsoleKit.Seat  Seat interface</p></div><div class="refsynopsisdiv" title="Methods"><h2>Methods</h2><pre class="synopsis"><a class="link" href="#Seat.GetId">GetId</a> (out 'o' sid)
3331<a class="link" href="#Seat.GetSessions">GetSessions</a> (out 'ao' sessions)
3332<a class="link" href="#Seat.GetDevices">GetDevices</a> (out 'a(ss)' devices)
3333<a class="link" href="#Seat.GetActiveSession">GetActiveSession</a> (out 'o' ssid)
3334<a class="link" href="#Seat.CanActivateSessions">CanActivateSessions</a> (out 'b' can_activate)
3335<a class="link" href="#Seat.ActivateSession">ActivateSession</a> (in 'o' ssid)
3336</pre></div><div class="refsect1" title="Signals"><a id="idp3230760"></a><h2>Signals</h2><pre class="synopsis"><a class="link" href="#Seat::ActiveSessionChanged">ActiveSessionChanged</a> ('o' ssid)
3337<a class="link" href="#Seat::SessionAdded">SessionAdded</a> ('o' ssid)
3338<a class="link" href="#Seat::SessionRemoved">SessionRemoved</a> ('o' ssid)
3339<a class="link" href="#Seat::DeviceAdded">DeviceAdded</a> ('(ss)' device)
3340<a class="link" href="#Seat::DeviceRemoved">DeviceRemoved</a> ('(ss)' device)
3341</pre></div><div class="refsect1" title="Implemented Interfaces"><a id="idp3233192"></a><h2>Implemented Interfaces</h2><p>
3342 Objects implementing org.freedesktop.ConsoleKit.Seat also implements
3343 org.freedesktop.DBus.Introspectable,
3344 org.freedesktop.DBus.Properties
3345 </p></div><div class="refsect1" title="Description"><a id="idp3234168"></a><h2>Description</h2><p>A seat is a collection of sessions and a set of hardware (usually at
3346least a keyboard and mouse). Only one session may be active on a
3347seat at a time.</p></div><div class="refsect1" title="Details"><a id="idp3235080"></a><h2>Details</h2><div class="refsect2" title="GetId ()"><a id="idp3235640"></a><h3><a id="Seat.GetId"></a>GetId ()</h3><a id="idp3236136" class="indexterm"></a><pre class="programlisting">GetId (out 'o' sid)</pre><p>Returns the ID for Seat.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sid</code></em>:</span></dt><dd>Seat ID</dd></dl></div></div><div class="refsect2" title="GetSessions ()"><a id="idp3237960"></a><h3><a id="Seat.GetSessions"></a>GetSessions ()</h3><a id="idp3238456" class="indexterm"></a><pre class="programlisting">GetSessions (out 'ao' sessions)</pre><p>This gets a list of all the <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Sessions</a>
3348 that are currently attached to this seat.</p><p>Each Session ID is an D-Bus object path for the object that implements the
3349 <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a> interface.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sessions</code></em>:</span></dt><dd>an array of Session IDs</dd></dl></div></div><div class="refsect2" title="GetDevices ()"><a id="idp3241336"></a><h3><a id="Seat.GetDevices"></a>GetDevices ()</h3><a id="idp3241832" class="indexterm"></a><pre class="programlisting">GetDevices (out 'a(ss)' devices)</pre><p>This gets a list of all the devices
3350 that are currently associated with this seat.</p><p>Each device is an D-Bus structure that represents
3351 the device type and the device id.
3352 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>devices</code></em>:</span></dt><dd>an array of devices</dd></dl></div></div><div class="refsect2" title="GetActiveSession ()"><a id="idp3244096"></a><h3><a id="Seat.GetActiveSession"></a>GetActiveSession ()</h3><a id="idp3244592" class="indexterm"></a><pre class="programlisting">GetActiveSession (out 'o' ssid)</pre><p>Gets the Session ID that is currently active on this Seat.</p><p>Returns NULL if there is no active session.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>Session ID</dd></dl></div></div><div class="refsect2" title="CanActivateSessions ()"><a id="idp3246760"></a><h3><a id="Seat.CanActivateSessions"></a>CanActivateSessions ()</h3><a id="idp3247256" class="indexterm"></a><pre class="programlisting">CanActivateSessions (out 'b' can_activate)</pre><p>Used to determine whether the seat supports session activation.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>can_activate</code></em>:</span></dt><dd>TRUE if seat supports session activation</dd></dl></div></div><div class="refsect2" title="ActivateSession ()"><a id="idp3249184"></a><h3><a id="Seat.ActivateSession"></a>ActivateSession ()</h3><a id="idp3249680" class="indexterm"></a><pre class="programlisting">ActivateSession (in 'o' ssid)</pre><p>Attempt to activate the specified session. In most
3353 cases, if successful, this will cause the session to
3354 become visible and take control of the hardware that is
3355 associated with this seat.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>Session ID</dd></dl></div><p>
3356See also:
3357<a class="link" href="#Session.Activate"><code class="function">Activate()</code></a></p></div></div><div class="refsect1" title="Signal Details"><a id="idp3252392"></a><h2>Signal Details</h2><div class="refsect2" title="The ActiveSessionChanged signal"><a id="idp3252952"></a><h3><a id="Seat::ActiveSessionChanged"></a>The ActiveSessionChanged signal</h3><a id="idp3253488" class="indexterm"></a><pre class="programlisting">ActiveSessionChanged ('o' ssid)</pre><p>Emitted when the active session has changed.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>Session ID</dd></dl></div></div><div class="refsect2" title="The SessionAdded signal"><a id="idp3255408"></a><h3><a id="Seat::SessionAdded"></a>The SessionAdded signal</h3><a id="idp3255904" class="indexterm"></a><pre class="programlisting">SessionAdded ('o' ssid)</pre><p>Emitted when a session has been added to the seat.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>Session ID</dd></dl></div></div><div class="refsect2" title="The SessionRemoved signal"><a id="idp3257784"></a><h3><a id="Seat::SessionRemoved"></a>The SessionRemoved signal</h3><a id="idp3258280" class="indexterm"></a><pre class="programlisting">SessionRemoved ('o' ssid)</pre><p>Emitted when a session has been removed from the seat.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>Session ID</dd></dl></div></div><div class="refsect2" title="The DeviceAdded signal"><a id="idp3260168"></a><h3><a id="Seat::DeviceAdded"></a>The DeviceAdded signal</h3><a id="idp3260664" class="indexterm"></a><pre class="programlisting">DeviceAdded ('(ss)' device)</pre><p>Emitted when a device has been associated with the seat.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>device</code></em>:</span></dt><dd>Device structure</dd></dl></div></div><div class="refsect2" title="The DeviceRemoved signal"><a id="idp3262552"></a><h3><a id="Seat::DeviceRemoved"></a>The DeviceRemoved signal</h3><a id="idp3263048" class="indexterm"></a><pre class="programlisting">DeviceRemoved ('(ss)' device)</pre><p>Emitted when a device has been dissociated from the seat.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>device</code></em>:</span></dt><dd>Device structure</dd></dl></div></div></div></div><div class="refentry" title="org.freedesktop.ConsoleKit.Session"><div class="refentry.separator"><hr /></div><a id="Session"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>org.freedesktop.ConsoleKit.Session  Session interface</p></div><div class="refsynopsisdiv" title="Methods"><h2>Methods</h2><pre class="synopsis"><a class="link" href="#Session.GetId">GetId</a> (out 'o' ssid)
3358<a class="link" href="#Session.GetSeatId">GetSeatId</a> (out 'o' sid)
3359<a class="link" href="#Session.GetSessionType">GetSessionType</a> (out 's' type)
3360<a class="link" href="#Session.GetUser">GetUser</a> (out 'u' uid)
3361<a class="link" href="#Session.GetUnixUser">GetUnixUser</a> (out 'u' uid)
3362<a class="link" href="#Session.GetX11Display">GetX11Display</a> (out 's' display)
3363<a class="link" href="#Session.GetX11DisplayDevice">GetX11DisplayDevice</a> (out 's' x11_display_device)
3364<a class="link" href="#Session.GetDisplayDevice">GetDisplayDevice</a> (out 's' display_device)
3365<a class="link" href="#Session.GetRemoteHostName">GetRemoteHostName</a> (out 's' remote_host_name)
3366<a class="link" href="#Session.GetLoginSessionId">GetLoginSessionId</a> (out 's' login_session_id)
3367<a class="link" href="#Session.IsActive">IsActive</a> (out 'b' active)
3368<a class="link" href="#Session.IsLocal">IsLocal</a> (out 'b' local)
3369<a class="link" href="#Session.GetCreationTime">GetCreationTime</a> (out 's' iso8601_datetime)
3370<a class="link" href="#Session.Activate">Activate</a> ()
3371<a class="link" href="#Session.Lock">Lock</a> ()
3372<a class="link" href="#Session.Unlock">Unlock</a> ()
3373<a class="link" href="#Session.GetIdleHint">GetIdleHint</a> (out 'b' idle_hint)
3374<a class="link" href="#Session.GetIdleSinceHint">GetIdleSinceHint</a> (out 's' iso8601_datetime)
3375<a class="link" href="#Session.SetIdleHint">SetIdleHint</a> (in 'b' idle_hint)
3376</pre></div><div class="refsect1" title="Signals"><a id="idp3316232"></a><h2>Signals</h2><pre class="synopsis"><a class="link" href="#Session::ActiveChanged">ActiveChanged</a> ('b' is_active)
3377<a class="link" href="#Session::IdleHintChanged">IdleHintChanged</a> ('b' hint)
3378<a class="link" href="#Session::Lock">Lock</a> ()
3379<a class="link" href="#Session::Unlock">Unlock</a> ()
3380</pre></div><div class="refsect1" title="Implemented Interfaces"><a id="idp3318352"></a><h2>Implemented Interfaces</h2><p>
3381 Objects implementing org.freedesktop.ConsoleKit.Session also implements
3382 org.freedesktop.DBus.Introspectable,
3383 org.freedesktop.DBus.Properties
3384 </p></div><div class="refsect1" title="Properties"><a id="idp3319336"></a><h2>Properties</h2><pre class="synopsis"><a class="link" href="#Session:unix-user">'unix-user'</a> readwrite 'u'
3385<a class="link" href="#Session:user">'user'</a> readwrite 'u'
3386<a class="link" href="#Session:session-type">'session-type'</a> readwrite 's'
3387<a class="link" href="#Session:remote-host-name">'remote-host-name'</a> readwrite 's'
3388<a class="link" href="#Session:display-device">'display-device'</a> readwrite 's'
3389<a class="link" href="#Session:x11-display">'x11-display'</a> readwrite 's'
3390<a class="link" href="#Session:x11-display-device">'x11-display-device'</a> readwrite 's'
3391<a class="link" href="#Session:active">'active'</a> readwrite 'b'
3392<a class="link" href="#Session:is-local">'is-local'</a> readwrite 'b'
3393<a class="link" href="#Session:idle-hint">'idle-hint'</a> readwrite 'b'
3394</pre></div><div class="refsect1" title="Description"><a id="idp3323368"></a><h2>Description</h2><p>Session objects represent and store information
3395 related to a user session.
3396 </p><p>The properties associated with the Session
3397 specifically refer to the properties of the "session leader".
3398 </p></div><div class="refsect1" title="Details"><a id="idp3324536"></a><h2>Details</h2><div class="refsect2" title="GetId ()"><a id="idp3325096"></a><h3><a id="Session.GetId"></a>GetId ()</h3><a id="idp3325592" class="indexterm"></a><pre class="programlisting">GetId (out 'o' ssid)</pre><p>Returns the ID for Session.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ssid</code></em>:</span></dt><dd>Session ID</dd></dl></div></div><div class="refsect2" title="GetSeatId ()"><a id="idp3327352"></a><h3><a id="Session.GetSeatId"></a>GetSeatId ()</h3><a id="idp3327848" class="indexterm"></a><pre class="programlisting">GetSeatId (out 'o' sid)</pre><p>Returns the ID for the Seat the Session is
3399 attached to.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sid</code></em>:</span></dt><dd>Seat ID</dd></dl></div><p>
3400See also:
3401<a class="link" href="#Seat" title="org.freedesktop.ConsoleKit.Seat">org.freedesktop.ConsoleKit.Seat</a></p></div><div class="refsect2" title="GetSessionType ()"><a id="idp3330096"></a><h3><a id="Session.GetSessionType"></a>GetSessionType ()</h3><a id="idp3330592" class="indexterm"></a><pre class="programlisting">GetSessionType (out 's' type)</pre><p>Returns the type of the session.</p><p>Warning: we haven't yet defined the allowed values for this property.
3402 It is probably best to avoid this until we do.
3403 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>type</code></em>:</span></dt><dd>Session type</dd></dl></div><p>
3404See also:
3405<a class="link" href="#Session:session-type"><code class="literal">session-type</code></a></p></div><div class="refsect2" title="GetUser ()"><a id="idp3333392"></a><h3><a id="Session.GetUser"></a>GetUser ()</h3><a id="idp3333888" class="indexterm"></a><pre class="programlisting">GetUser (out 'u' uid)</pre><p>Returns the user that the session belongs to.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>uid</code></em>:</span></dt><dd>User ID</dd></dl></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><code class="literal">GetUser</code> is deprecated since version 0.1.3 and should not be used in newly-written code. Use
3406
3407 <a class="link" href="#Session.GetUnixUser"><code class="function">GetUnixUser</code></a>
3408instead.</p></div><p>
3409See also:
3410<a class="link" href="#Session:user"><code class="literal">user</code></a></p></div><div class="refsect2" title="GetUnixUser ()"><a id="idp3337480"></a><h3><a id="Session.GetUnixUser"></a>GetUnixUser ()</h3><a id="idp3337976" class="indexterm"></a><pre class="programlisting">GetUnixUser (out 'u' uid)</pre><p>Returns the POSIX user ID that the session belongs to.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>uid</code></em>:</span></dt><dd>POSIX User ID</dd></dl></div><p>
3411See also:
3412<a class="link" href="#Session:unix-user"><code class="literal">unix-user</code></a></p></div><div class="refsect2" title="GetX11Display ()"><a id="idp3340360"></a><h3><a id="Session.GetX11Display"></a>GetX11Display ()</h3><a id="idp3340856" class="indexterm"></a><pre class="programlisting">GetX11Display (out 's' display)</pre><p>Returns the value of the X11 DISPLAY for this session
3413 if one is present.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>display</code></em>:</span></dt><dd>The value of the X11 display</dd></dl></div><p>
3414See also:
3415<a class="link" href="#Session:x11-display"><code class="literal">x11-display</code></a></p></div><div class="refsect2" title="GetX11DisplayDevice ()"><a id="idp3343344"></a><h3><a id="Session.GetX11DisplayDevice"></a>GetX11DisplayDevice ()</h3><a id="idp3343840" class="indexterm"></a><pre class="programlisting">GetX11DisplayDevice (out 's' x11_display_device)</pre><p>Returns the value of the display device (aka TTY) that the
3416 X11 display for the session is connected to. If there is no x11-display set then this value
3417 is undefined.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x11_display_device</code></em>:</span></dt><dd>The value of the X11 display device</dd></dl></div><p>
3418See also:
3419<a class="link" href="#Session:x11-display-device"><code class="literal">x11-display-device</code></a></p></div><div class="refsect2" title="GetDisplayDevice ()"><a id="idp3346448"></a><h3><a id="Session.GetDisplayDevice"></a>GetDisplayDevice ()</h3><a id="idp3346944" class="indexterm"></a><pre class="programlisting">GetDisplayDevice (out 's' display_device)</pre><p>Returns the value of the display device (aka TTY) that the
3420 session is connected to.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>display_device</code></em>:</span></dt><dd>The value of the display device</dd></dl></div><p>
3421See also:
3422<a class="link" href="#Session:display-device"><code class="literal">display-device</code></a></p></div><div class="refsect2" title="GetRemoteHostName ()"><a id="idp3349448"></a><h3><a id="Session.GetRemoteHostName"></a>GetRemoteHostName ()</h3><a id="idp3349944" class="indexterm"></a><pre class="programlisting">GetRemoteHostName (out 's' remote_host_name)</pre><p>Returns the value of the remote host name for the session.
3423 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>remote_host_name</code></em>:</span></dt><dd>The remote host name</dd></dl></div><p>
3424See also:
3425<a class="link" href="#Session:remote-host-name"><code class="literal">remote-host-name</code></a></p></div><div class="refsect2" title="GetLoginSessionId ()"><a id="idp3352392"></a><h3><a id="Session.GetLoginSessionId"></a>GetLoginSessionId ()</h3><a id="idp3352888" class="indexterm"></a><pre class="programlisting">GetLoginSessionId (out 's' login_session_id)</pre><p>Returns the value of the login session ID that the
3426 underlying system uses to enforce session boundaries. If there is no login session ID
3427 set then this value is an empty string.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>login_session_id</code></em>:</span></dt><dd>The value of the native system login session ID</dd></dl></div></div><div class="refsect2" title="IsActive ()"><a id="idp3354960"></a><h3><a id="Session.IsActive"></a>IsActive ()</h3><a id="idp3355456" class="indexterm"></a><pre class="programlisting">IsActive (out 'b' active)</pre><p>Returns whether the session is active on the Seat that
3428 it is attached to.</p><p>If the session is not attached to a seat this value is undefined.
3429 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>active</code></em>:</span></dt><dd>TRUE if the session is active, otherwise FALSE</dd></dl></div><p>
3430See also:
3431<a class="link" href="#Session:active"><code class="literal">active</code></a></p></div><div class="refsect2" title="IsLocal ()"><a id="idp3358192"></a><h3><a id="Session.IsLocal"></a>IsLocal ()</h3><a id="idp3358688" class="indexterm"></a><pre class="programlisting">IsLocal (out 'b' local)</pre><p>Returns whether the session is local</p><p>FIXME: we need to come up with a concrete definition for this value.
3432 It was originally used as a way to identify XDMCP sessions that originate
3433 from a remote system.
3434 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>local</code></em>:</span></dt><dd>TRUE if the session is local, otherwise FALSE</dd></dl></div><p>
3435See also:
3436<a class="link" href="#Session:is-local"><code class="literal">is-local</code></a></p></div><div class="refsect2" title="GetCreationTime ()"><a id="idp3361504"></a><h3><a id="Session.GetCreationTime"></a>GetCreationTime ()</h3><a id="idp3362000" class="indexterm"></a><pre class="programlisting">GetCreationTime (out 's' iso8601_datetime)</pre><p>Returns an ISO 8601 date-time string that corresponds to
3437 the time that the session was opened.
3438 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>iso8601_datetime</code></em>:</span></dt><dd>An ISO 8601 format date-type string</dd></dl></div></div><div class="refsect2" title="Activate ()"><a id="idp3364032"></a><h3><a id="Session.Activate"></a>Activate ()</h3><a id="idp3364528" class="indexterm"></a><pre class="programlisting">Activate ()</pre><p>Attempt to activate the this session. In most
3439 cases, if successful, this will cause the session to
3440 become visible and become active on the seat that it
3441 is attached to.</p><p>
3442See also:
3443<a class="link" href="#Seat.ActivateSession"><code class="function">Seat.ActivateSession()</code></a></p></div><div class="refsect2" title="Lock ()"><a id="idp3366304"></a><h3><a id="Session.Lock"></a>Lock ()</h3><a id="idp3366800" class="indexterm"></a><pre class="programlisting">Lock ()</pre><p>This will cause a <a class="link" href="#Session::Lock"><code class="literal">Lock</code></a>
3444 signal to be emitted for this session.
3445 </p><div class="note" title="Permissions" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Permissions</h3><p class="permission">This method is restricted to privileged users by D-Bus policy.</p></div><p>
3446See also:
3447<a class="link" href="#Session::Lock"><code class="literal">Lock signal</code></a></p></div><div class="refsect2" title="Unlock ()"><a id="idp3369448"></a><h3><a id="Session.Unlock"></a>Unlock ()</h3><a id="idp3369944" class="indexterm"></a><pre class="programlisting">Unlock ()</pre><p>This will cause an <a class="link" href="#Session::Unlock"><code class="literal">Unlock</code></a>
3448 signal to be emitted for this session.
3449 </p><p>This can be used by login managers to unlock a session before it is
3450 re-activated during fast-user-switching.
3451 </p><div class="note" title="Permissions" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Permissions</h3><p class="permission">This method is restricted to privileged users by D-Bus policy.</p></div><p>
3452See also:
3453<a class="link" href="#Session::Unlock"><code class="literal">Unlock signal</code></a></p></div><div class="refsect2" title="GetIdleHint ()"><a id="idp3372920"></a><h3><a id="Session.GetIdleHint"></a>GetIdleHint ()</h3><a id="idp3373416" class="indexterm"></a><pre class="programlisting">GetIdleHint (out 'b' idle_hint)</pre><p>Gets the value of the <a class="link" href="#Session:idle-hint"><code class="literal">idle-hint</code></a>
3454 property.
3455 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>idle_hint</code></em>:</span></dt><dd>The value of the idle-hint</dd></dl></div><p>
3456See also:
3457<a class="link" href="#Session:idle-hint"><code class="literal">idle-hint</code></a></p></div><div class="refsect2" title="GetIdleSinceHint ()"><a id="idp3376376"></a><h3><a id="Session.GetIdleSinceHint"></a>GetIdleSinceHint ()</h3><a id="idp3376872" class="indexterm"></a><pre class="programlisting">GetIdleSinceHint (out 's' iso8601_datetime)</pre><p>Returns an ISO 8601 date-time string that corresponds to
3458 the time of the last change of the idle-hint.
3459 </p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>iso8601_datetime</code></em>:</span></dt><dd>An ISO 8601 format date-type string</dd></dl></div></div><div class="refsect2" title="SetIdleHint ()"><a id="idp3378912"></a><h3><a id="Session.SetIdleHint"></a>SetIdleHint ()</h3><a id="idp3379408" class="indexterm"></a><pre class="programlisting">SetIdleHint (in 'b' idle_hint)</pre><p>This may be used by the session to indicate that
3460 it is idle.
3461 </p><p>Use of this method is restricted to the user
3462 that owns the session.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>idle_hint</code></em>:</span></dt><dd>boolean value to set the idle-hint to</dd></dl></div></div></div><div class="refsect1" title="Signal Details"><a id="idp3381752"></a><h2>Signal Details</h2><div class="refsect2" title="The ActiveChanged signal"><a id="idp3382312"></a><h3><a id="Session::ActiveChanged"></a>The ActiveChanged signal</h3><a id="idp3382808" class="indexterm"></a><pre class="programlisting">ActiveChanged ('b' is_active)</pre><p>Emitted when the active property has changed.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>is_active</code></em>:</span></dt><dd>TRUE if the session is active, otherwise FALSE</dd></dl></div></div><div class="refsect2" title="The IdleHintChanged signal"><a id="idp3384784"></a><h3><a id="Session::IdleHintChanged"></a>The IdleHintChanged signal</h3><a id="idp3385280" class="indexterm"></a><pre class="programlisting">IdleHintChanged ('b' hint)</pre><p>Emitted when the idle-hint property has changed.</p><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>hint</code></em>:</span></dt><dd>the new value of idle-hint</dd></dl></div></div><div class="refsect2" title="The Lock signal"><a id="idp3387160"></a><h3><a id="Session::Lock"></a>The Lock signal</h3><a id="idp3387656" class="indexterm"></a><pre class="programlisting">Lock ()</pre><p>Emitted in response to a call to the <a class="link" href="#Session.Lock"><code class="function">Lock()</code></a> method.</p><p>It is intended that the screensaver for the session should lock the screen in response to this signal.</p></div><div class="refsect2" title="The Unlock signal"><a id="idp3389512"></a><h3><a id="Session::Unlock"></a>The Unlock signal</h3><a id="idp3390008" class="indexterm"></a><pre class="programlisting">Unlock ()</pre><p>Emitted in response to a call to the <a class="link" href="#Session.Unlock"><code class="function">Unlock()</code></a> method.</p><p>It is intended that the screensaver for the session should unlock the screen in response to this signal.</p></div></div><div class="refsect1" title="Property Details"><a id="idp3391928"></a><h2>Property Details</h2><div class="refsect2" title="The "unix-user" property"><a id="idp3392488"></a><h3><a id="Session:unix-user"></a>The "unix-user" property</h3><a id="idp3392984" class="indexterm"></a><pre class="programlisting">'unix-user' readwrite 'u'
3463</pre><p>The user assigned to the session.</p></div><div class="refsect2" title="The "user" property"><a id="idp3394032"></a><h3><a id="Session:user"></a>The "user" property</h3><a id="idp3394528" class="indexterm"></a><pre class="programlisting">'user' readwrite 'u'
3464</pre><p>The user assigned to the session.</p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><code class="literal">user</code> is deprecated since version 0.1.3 and should not be used in newly-written code. Use
3465
3466 <a class="link" href="#Session:unix-user"><code class="literal">unix-user</code></a>
3467instead.</p></div></div><div class="refsect2" title="The "session-type" property"><a id="idp3396792"></a><h3><a id="Session:session-type"></a>The "session-type" property</h3><a id="idp3397288" class="indexterm"></a><pre class="programlisting">'session-type' readwrite 's'
3468</pre><p>The type of the session.</p><p>Warning: we haven't yet defined the allowed values for this property.
3469 It is probably best to avoid this until we do.
3470 </p></div><div class="refsect2" title="The "remote-host-name" property"><a id="idp3398672"></a><h3><a id="Session:remote-host-name"></a>The "remote-host-name" property</h3><a id="idp3399208" class="indexterm"></a><pre class="programlisting">'remote-host-name' readwrite 's'
3471</pre><p>The remote host name for the session.
3472 </p><p>This will be set in situations where the session is
3473 opened and controlled from a remote system.
3474 </p><p>For example, this value will be set when the
3475 session is created from an SSH or XDMCP connection.
3476 </p></div><div class="refsect2" title="The "display-device" property"><a id="idp3400952"></a><h3><a id="Session:display-device"></a>The "display-device" property</h3><a id="idp3401488" class="indexterm"></a><pre class="programlisting">'display-device' readwrite 's'
3477</pre><p>The display device (aka TTY) that the
3478 session is connected to.
3479 </p></div><div class="refsect2" title="The "x11-display" property"><a id="idp3402624"></a><h3><a id="Session:x11-display"></a>The "x11-display" property</h3><a id="idp3403120" class="indexterm"></a><pre class="programlisting">'x11-display' readwrite 's'
3480</pre><p>Value of the X11 DISPLAY for this session
3481 if one is present.
3482 </p></div><div class="refsect2" title="The "x11-display-device" property"><a id="idp3404256"></a><h3><a id="Session:x11-display-device"></a>The "x11-display-device" property</h3><a id="idp3404792" class="indexterm"></a><pre class="programlisting">'x11-display-device' readwrite 's'
3483</pre><p>
3484 The display device (aka TTY) that the X11 display for the
3485 session is connected to. If there is no x11-display set then
3486 this value is undefined.
3487 </p></div><div class="refsect2" title="The "active" property"><a id="idp3406040"></a><h3><a id="Session:active"></a>The "active" property</h3><a id="idp3406536" class="indexterm"></a><pre class="programlisting">'active' readwrite 'b'
3488</pre><p>
3489 Whether the session is active on the Seat that
3490 it is attached to.</p><p>If the session is not attached to a seat this value is undefined.
3491 </p></div><div class="refsect2" title="The "is-local" property"><a id="idp3407920"></a><h3><a id="Session:is-local"></a>The "is-local" property</h3><a id="idp3408416" class="indexterm"></a><pre class="programlisting">'is-local' readwrite 'b'
3492</pre><p>
3493 Whether the session is local</p><p>FIXME: we need to come up with a concrete definition for this value.
3494 It was originally used as a way to identify XDMCP sessions that originate
3495 from a remote system.
3496 </p></div><div class="refsect2" title="The "idle-hint" property"><a id="idp3409864"></a><h3><a id="Session:idle-hint"></a>The "idle-hint" property</h3><a id="idp3410360" class="indexterm"></a><pre class="programlisting">'idle-hint' readwrite 'b'
3497</pre><p>
3498 This is a hint used to indicate that the session may be idle.
3499 </p><p>
3500 For sessions with a <a class="link" href="#Session:x11-display"><code class="literal">x11-display</code></a> set (ie. graphical
3501 sessions), it is up to each session to delegate the
3502 responsibility for updating this value. Typically, the
3503 screensaver will set this.
3504 </p><p>However, for non-graphical sessions with a <a class="link" href="#Session:display-device"><code class="literal">display-device</code></a> set
3505 the Session object itself will periodically update this value based
3506 on the activity detected on the display-device itself.
3507 </p><p>
3508 This should not be considered authoritative.
3509 </p></div></div></div></div></div><div class="index" title="Index"><div class="titlepage"><div><div><h2 class="title"><a id="idp3489568"></a>Index</h2></div></div></div><div class="index"><div class="indexdiv"><h3>A</h3><dl><dt>Activate</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3364032">Activate ()</a></dt></dl></dd><dt>ActivateSession</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3249184">ActivateSession ()</a></dt></dl></dd><dt>active</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3406040">The "active" property</a></dt></dl></dd><dt>ActiveChanged</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3382312">The ActiveChanged signal</a></dt></dl></dd><dt>ActiveSessionChanged</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3252952">The ActiveSessionChanged signal</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>C</h3><dl><dt>CanActivateSessions</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3246760">CanActivateSessions ()</a></dt></dl></dd><dt>CanRestart</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3079040">CanRestart ()</a></dt></dl></dd><dt>CanStop</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3083584">CanStop ()</a></dt></dl></dd><dt>CloseSession</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3100064">CloseSession ()</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>D</h3><dl><dt>DeviceAdded</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3260168">The DeviceAdded signal</a></dt></dl></dd><dt>DeviceRemoved</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3262552">The DeviceRemoved signal</a></dt></dl></dd><dt>display-device</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3400952">The "display-device" property</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>G</h3><dl><dt>GetActiveSession</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3244096">GetActiveSession ()</a></dt></dl></dd><dt>GetCreationTime</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3361504">GetCreationTime ()</a></dt></dl></dd><dt>GetCurrentSession</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3117672">GetCurrentSession ()</a></dt></dl></dd><dt>GetDevices</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3241336">GetDevices ()</a></dt></dl></dd><dt>GetDisplayDevice</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3346448">GetDisplayDevice ()</a></dt></dl></dd><dt>GetId</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3235640">GetId ()</a></dt><dt>Session, <a class="indexterm" href="#idp3325096">GetId ()</a></dt></dl></dd><dt>GetIdleHint</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3372920">GetIdleHint ()</a></dt></dl></dd><dt>GetIdleSinceHint</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3376376">GetIdleSinceHint ()</a></dt></dl></dd><dt>GetLoginSessionId</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3352392">GetLoginSessionId ()</a></dt></dl></dd><dt>GetRemoteHostName</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3349448">GetRemoteHostName ()</a></dt></dl></dd><dt>GetSeatId</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3327352">GetSeatId ()</a></dt></dl></dd><dt>GetSeats</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3103576">GetSeats ()</a></dt></dl></dd><dt>GetSessionForCookie</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3111112">GetSessionForCookie ()</a></dt></dl></dd><dt>GetSessionForUnixProcess</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3114352">GetSessionForUnixProcess ()</a></dt></dl></dd><dt>GetSessions</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3107320">GetSessions ()</a></dt><dt>Seat, <a class="indexterm" href="#idp3237960">GetSessions ()</a></dt></dl></dd><dt>GetSessionsForUnixUser</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3120920">GetSessionsForUnixUser ()</a></dt></dl></dd><dt>GetSessionsForUser</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3125056">GetSessionsForUser ()</a></dt></dl></dd><dt>GetSessionType</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3330096">GetSessionType ()</a></dt></dl></dd><dt>GetSystemIdleHint</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3130440">GetSystemIdleHint ()</a></dt></dl></dd><dt>GetSystemIdleSinceHint</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3133408">GetSystemIdleSinceHint ()</a></dt></dl></dd><dt>GetUnixUser</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3337480">GetUnixUser ()</a></dt></dl></dd><dt>GetUser</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3333392">GetUser ()</a></dt></dl></dd><dt>GetX11Display</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3340360">GetX11Display ()</a></dt></dl></dd><dt>GetX11DisplayDevice</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3343344">GetX11DisplayDevice ()</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>I</h3><dl><dt>idle-hint</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3409864">The "idle-hint" property</a></dt></dl></dd><dt>IdleHintChanged</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3384784">The IdleHintChanged signal</a></dt></dl></dd><dt>is-local</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3407920">The "is-local" property</a></dt></dl></dd><dt>IsActive</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3354960">IsActive ()</a></dt></dl></dd><dt>IsLocal</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3358192">IsLocal ()</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>Lock</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3366304">Lock ()</a>, <a class="indexterm" href="#idp3387160">The Lock signal</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>O</h3><dl><dt>OpenSession</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3086544">OpenSession ()</a></dt></dl></dd><dt>OpenSessionWithParameters</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3093520">OpenSessionWithParameters ()</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>R</h3><dl><dt>remote-host-name</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3398672">The "remote-host-name" property</a></dt></dl></dd><dt>Restart</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3077448">Restart ()</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>SeatAdded</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3136664">The SeatAdded signal</a></dt></dl></dd><dt>SeatRemoved</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3139096">The SeatRemoved signal</a></dt></dl></dd><dt>session-type</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3396792">The "session-type" property</a></dt></dl></dd><dt>SessionAdded</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3255408">The SessionAdded signal</a></dt></dl></dd><dt>SessionRemoved</dt><dd><dl><dt>Seat, <a class="indexterm" href="#idp3257784">The SessionRemoved signal</a></dt></dl></dd><dt>SetIdleHint</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3378912">SetIdleHint ()</a></dt></dl></dd><dt>Stop</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3082000">Stop ()</a></dt></dl></dd><dt>SystemIdleHintChanged</dt><dd><dl><dt>Manager, <a class="indexterm" href="#idp3141528">The SystemIdleHintChanged signal</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>U</h3><dl><dt>unix-user</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3392488">The "unix-user" property</a></dt></dl></dd><dt>Unlock</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3369448">Unlock ()</a>, <a class="indexterm" href="#idp3389512">The Unlock signal</a></dt></dl></dd><dt>user</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3394032">The "user" property</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>X</h3><dl><dt>x11-display</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3402624">The "x11-display" property</a></dt></dl></dd><dt>x11-display-device</dt><dd><dl><dt>Session, <a class="indexterm" href="#idp3404256">The "x11-display-device" property</a></dt></dl></dd></dl></div></div></div></div></body></html>
3510 What is ConsoleKit?
3511===================
3512
3513ConsoleKit is a framework for defining and tracking users, login
3514sessions, and seats.
3515
3516What is a seat?
3517===============
3518
3519A seat is a collection of sessions and a set of hardware (usually at
3520least a keyboard and mouse). Only one session may be active on a
3521seat at a time.
3522
3523What is a session?
3524==================
3525
3526A session is a collection of all processes that originate from a single
3527common ancestor and retain knowledge of a secret. As an implementation
3528detail, this secret may be stored in the process environment by the
3529login manager under the name XDG_SESSION_COOKIE.
3530
3531More Information
3532================
3533
3534http://www.freedesktop.org/wiki/Software/ConsoleKit
3535
3536Discussion takes place on the HAL list.
3537http://lists.freedesktop.org/mailman/listinfo/hal
3538 ConsoleKit for Debian
3539---------------------
3540
3541ConsoleKit allows programs to track seats and sessions. It either needs
3542integration into the login manager, like gdm, or it can go through a pam
3543module. Install the package libpam-ck-connector for that.
3544
3545 -- Michael Biebl <biebl@debian.org> Thu, 29 Mar 2007 01:38:27 +0200
3546 TODO
3547====
3548
3549 - Patch all login managers to open CK sessions
3550
3551 - Make a registration interface for per-session
3552 idle time delegates
3553
3554 - Report idle time per Seat
3555
3556 - Establish what session-types should be
3557
3558 - Improve the ck-list-sessions interface
3559
3560 - Complete the documentation
3561
3562 - Make openssh report sessions correctly
3563 Not as easy as just using the PAM module.
3564
3565 - Figure out how to register activation handlers
3566
3567 - Use a configuration file for defining how to add sessions to seats
3568 This package was debianized by Michael Biebl <biebl@debian.org> on
3569Thu, 29 Mar 2007 01:38:27 +0200.
3570
3571It was downloaded from http://people.freedesktop.org/~mccann/dist/.
3572
3573Upstream Author:
3574 William Jon McCann <mccann@jhu.edu>
3575
3576Copyright:
3577 Copyright (C) 2006 William Jon McCann <mccann@jhu.edu>
3578
3579License: GPL v2 or later
3580
3581 This package is free software; you can redistribute it and/or modify
3582 it under the terms of the GNU General Public License as published by
3583 the Free Software Foundation; either version 2 of the License, or
3584 (at your option) any later version.
3585
3586 This package is distributed in the hope that it will be useful,
3587 but WITHOUT ANY WARRANTY; without even the implied warranty of
3588 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3589 GNU General Public License for more details.
3590
3591 You should have received a copy of the GNU General Public License
3592 along with this package; if not, write to the Free Software
3593 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
3594
3595On Debian systems, the complete text of the GNU General
3596Public License can be found in `/usr/share/common-licenses/GPL-2'.
3597
3598===============================================================================
3599
3600libck-connector/*
3601pam-ck-connector/*
3602
3603Copyright:
3604 Copyright (c) 2007 David Zeuthen <davidz@redhat.com>
3605 Copyright (c) 2007 William Jon McCann <mccann@jhu.edu>
3606
3607License: MIT license
3608
3609 Permission is hereby granted, free of charge, to any person
3610 obtaining a copy of this software and associated documentation
3611 files (the "Software"), to deal in the Software without
3612 restriction, including without limitation the rights to use,
3613 copy, modify, merge, publish, distribute, sublicense, and/or sell
3614 copies of the Software, and to permit persons to whom the
3615 Software is furnished to do so, subject to the following
3616 conditions:
3617
3618 The above copyright notice and this permission notice shall be
3619 included in all copies or substantial portions of the Software.
3620
3621 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
3622 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
3623 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
3624 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
3625 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
3626 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
3627 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
3628 OTHER DEALINGS IN THE SOFTWARE.
3629
3630===============================================================================
3631
3632The Debian packaging is (C) 2007, Michael Biebl <biebl@debian.org> and
3633is licensed under the GPL, see above.
3634
3635 Here are the names of the programs in this package,
3636each followed by the name(s) of its author(s).
3637
3638arch: David MacKenzie, Karel Zak
3639base64: Simon Josefsson
3640basename: David MacKenzie
3641cat: Torbjörn Granlund, Richard M. Stallman
3642chcon: Russell Coker, Jim Meyering
3643chgrp: David MacKenzie, Jim Meyering
3644chmod: David MacKenzie, Jim Meyering
3645chown: David MacKenzie, Jim Meyering
3646chroot: Roland McGrath
3647cksum: Q. Frank Xia
3648comm: Richard M. Stallman, David MacKenzie
3649cp: Torbjörn Granlund, David MacKenzie, Jim Meyering
3650csplit: Stuart Kemp, David MacKenzie
3651cut: David M. Ihnat, David MacKenzie, Jim Meyering
3652date: David MacKenzie
3653dd: Paul Rubin, David MacKenzie, Stuart Kemp
3654df: Torbjörn Granlund, David MacKenzie, Paul Eggert
3655dir: Richard M. Stallman, David MacKenzie
3656dircolors: H. Peter Anvin
3657dirname: David MacKenzie, Jim Meyering
3658du: Torbjörn Granlund, David MacKenzie, Paul Eggert, Jim Meyering
3659echo: Brian Fox, Chet Ramey
3660env: Richard Mlynarik, David MacKenzie
3661expand: David MacKenzie
3662expr: Mike Parker, James Youngman, Paul Eggert
3663factor: Paul Rubin
3664false: Jim Meyering
3665fmt: Ross Paterson
3666fold: David MacKenzie
3667ginstall: David MacKenzie
3668groups: David MacKenzie, James Youngman
3669head: David MacKenzie, Jim Meyering
3670hostid: Jim Meyering
3671hostname: Jim Meyering
3672id: Arnold Robbins, David MacKenzie
3673join: Mike Haertel
3674kill: Paul Eggert
3675link: Michael Stone
3676ln: Mike Parker, David MacKenzie
3677logname: FIXME: unknown
3678ls: Richard M. Stallman, David MacKenzie
3679md5sum: Ulrich Drepper, Scott Miller, David Madore
3680mkdir: David MacKenzie
3681mkfifo: David MacKenzie
3682mknod: David MacKenzie
3683mktemp: Jim Meyering, Eric Blake
3684mv: Mike Parker, David MacKenzie, Jim Meyering
3685nice: David MacKenzie
3686nl: Scott Bartram, David MacKenzie
3687nohup: Jim Meyering
3688nproc: Giuseppe Scrivano
3689od: Jim Meyering
3690paste: David M. Ihnat, David MacKenzie
3691pathchk: Paul Eggert, David MacKenzie, Jim Meyering
3692pinky: Joseph Arceneaux, David MacKenzie, Kaveh Ghazi
3693pr: Pete TerMaat, Roland Huebner
3694printenv: David MacKenzie, Richard Mlynarik
3695printf: David MacKenzie
3696ptx: François Pinard
3697pwd: Jim Meyering
3698readlink: Dmitry V. Levin
3699rm: Paul Rubin, David MacKenzie, Richard M. Stallman, Jim Meyering
3700rmdir: David MacKenzie
3701runcon: Russell Coker
3702seq: Ulrich Drepper
3703sha1sum: Ulrich Drepper, Scott Miller, David Madore
3704sha224sum: Ulrich Drepper, Scott Miller, David Madore
3705sha256sum: Ulrich Drepper, Scott Miller, David Madore
3706sha384sum: Ulrich Drepper, Scott Miller, David Madore
3707sha512sum: Ulrich Drepper, Scott Miller, David Madore
3708shred: Colin Plumb
3709shuf: Paul Eggert
3710sleep: Jim Meyering, Paul Eggert
3711sort: Mike Haertel, Paul Eggert
3712split: Torbjörn Granlund, Richard M. Stallman
3713stat: Michael Meskes
3714stdbuf: Pádraig Brady
3715stty: David MacKenzie
3716su: David MacKenzie
3717sum: Kayvan Aghaiepour, David MacKenzie
3718sync: Jim Meyering
3719tac: Jay Lepreau, David MacKenzie
3720tail: Paul Rubin, David MacKenzie, Ian Lance Taylor, Jim Meyering
3721tee: Mike Parker, Richard M. Stallman, David MacKenzie
3722test: Kevin Braunsdorf, Matthew Bradburn
3723timeout: Pádraig Brady
3724touch: Paul Rubin, Arnold Robbins, Jim Kingdon, David MacKenzie, Randy Smith
3725tr: Jim Meyering
3726true: Jim Meyering
3727truncate: Pádraig Brady
3728tsort: Mark Kettenis
3729tty: David MacKenzie
3730uname: David MacKenzie
3731unexpand: David MacKenzie
3732uniq: Richard M. Stallman, David MacKenzie
3733unlink: Michael Stone
3734uptime: Joseph Arceneaux, David MacKenzie, Kaveh Ghazi
3735users: Joseph Arceneaux, David MacKenzie
3736vdir: Richard M. Stallman, David MacKenzie
3737wc: Paul Rubin, David MacKenzie
3738who: Joseph Arceneaux, David MacKenzie, Michael Stone
3739whoami: Richard Mlynarik
3740yes: David MacKenzie
3741
3742;; Local Variables:
3743;; coding: utf-8
3744;; End:
3745
3746 This is the Debian GNU/Linux packaged version of the GNU core
3747utilities.
3748
3749This package is maintained by Michael Stone <mstone@debian.org> and
3750built from sources obtained from:
3751 ftp://ftp.gnu.org/gnu/coreutils/coreutils-8.13.tar.gz
3752
3753This debian package was first created by Michael Stone <mstone@debian.org>,
3754from coreutils 4.5.1.
3755
3756Changes:
3757 * added Debian GNU/Linux package maintenance system files
3758 * at times, bug fixes awaiting inclusion in the upstream source
3759
3760
3761Authors
3762=======
3763
3764See the file AUTHORS.
3765
3766
3767Copyright Holders and License
3768=============================
3769
3770lib/fts.c
3771---------
3772
3773 Copyright (C) 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
3774
3775 This program is free software: you can redistribute it and/or modify
3776 it under the terms of the GNU General Public License as published by
3777 the Free Software Foundation; either version 3 of the License, or
3778 (at your option) any later version.
3779
3780 This program is distributed in the hope that it will be useful,
3781 but WITHOUT ANY WARRANTY; without even the implied warranty of
3782 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3783 GNU General Public License for more details.
3784
3785 You should have received a copy of the GNU General Public License
3786 along with this program. If not, see <http://www.gnu.org/licenses/>. */
3787
3788/*-
3789 * Copyright (c) 1990, 1993, 1994
3790 * The Regents of the University of California. All rights reserved.
3791 *
3792 * Redistribution and use in source and binary forms, with or without
3793 * modification, are permitted provided that the following conditions
3794 * are met:
3795 * 1. Redistributions of source code must retain the above copyright
3796 * notice, this list of conditions and the following disclaimer.
3797 * 2. Redistributions in binary form must reproduce the above copyright
3798 * notice, this list of conditions and the following disclaimer in the
3799 * documentation and/or other materials provided with the distribution.
3800 * 4. Neither the name of the University nor the names of its contributors
3801 * may be used to endorse or promote products derived from this software
3802 * without specific prior written permission.
3803 *
3804
3805 */
3806
3807
3808lib/fts_.h
3809----------
3810
3811 Copyright (C) 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
3812
3813
3814 You should have received a copy of the GNU General Public License
3815 along with this program. If not, see <http://www.gnu.org/licenses/>. */
3816
3817/*
3818 * Copyright (c) 1989, 1993
3819 * The Regents of the University of California. All rights reserved.
3820 *
3821 * Redistribution and use in source and binary forms, with or without
3822 * modification, are permitted provided that the following conditions
3823 * are met:
3824 * 1. Redistributions of source code must retain the above copyright
3825 * notice, this list of conditions and the following disclaimer.
3826 * 2. Redistributions in binary form must reproduce the above copyright
3827 * notice, this list of conditions and the following disclaimer in the
3828 * documentation and/or other materials provided with the distribution.
3829 * 4. Neither the name of the University nor the names of its contributors
3830 * may be used to endorse or promote products derived from this software
3831 * without specific prior written permission.
3832 *
3833
3834
3835
3836lib/rand-isaac.[ch]
3837-------------------
3838
3839 Copyright (C) 1999-2006 Free Software Foundation, Inc.
3840 Copyright (C) 1997, 1998, 1999 Colin Plumb.
3841
3842
3843
3844
3845lib/inet_ntop.c
3846---------------
3847
3848 Copyright (C) 2005, 2006 Free Software Foundation, Inc.
3849
3850
3851
3852/*
3853 * Copyright (c) 1996-1999 by Internet Software Consortium.
3854 *
3855
3856 */
3857
3858
3859m4/autobuild.m4
3860---------------
3861dnl Copyright (C) 2004, 2006, 2007 Free Software Foundation, Inc.
3862dnl This file is free software; the Free Software Foundation
3863dnl gives unlimited permission to copy and/or distribute it,
3864dnl with or without modifications, as long as this notice is preserved.
3865
3866dnl From Simon Josefsson
3867
3868
3869src/cut.c
3870---------
3871
3872 Copyright (C) 1997-2007 Free Software Foundation, Inc.
3873 Copyright (C) 1984 David M. Ihnat
3874
3875
3876
3877
3878src/dircolors.c
3879---------------
3880
3881 Copyright (C) 1996-2007 Free Software Foundation, Inc.
3882 Copyright (C) 1994, 1995, 1997, 1998, 1999, 2000 H. Peter Anvin
3883
3884
3885
3886
3887src/paste.c
3888-----------
3889
3890 Copyright (C) 1997-2005 Free Software Foundation, Inc.
3891 Copyright (C) 1984 David M. Ihnat
3892
3893
3894src/shred.c
3895-----------
3896
3897 Copyright (C) 1999-2007 Free Software Foundation, Inc.
3898 Copyright (C) 1997, 1998, 1999 Colin Plumb.
3899
3900 This program is free software: you can redistribute it and/or modify
3901 it under the terms of the GNU General Public License as published by
3902 the Free Software Foundation, either version 3 of the License, or
3903 (at your option) any later version.
3904
3905 This program is distributed in the hope that it will be useful,
3906 but WITHOUT ANY WARRANTY; without even the implied warranty of
3907 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3908 GNU General Public License for more details.
3909
3910 You should have received a copy of the GNU General Public License
3911 along with this program. If not, see <http://www.gnu.org/licenses/>.
3912
3913
3914doc/coreutils.texi (The GNU Coreutils Manual)
3915---------------------------------------------
3916
3917Copyright @copyright{} 1994-1996, 2000-2008 Free Software Foundation, Inc.
3918
3919
3920
3921all other files
3922---------------
3923 This is the Debian GNU/Linux prepackaged version of GNU cpio
3924(including mt).
3925
3926This package was put together by Clint Adams <schizo@debian.org>,
3927from sources obtained from ftp://ftp.gnu.org:/gnu/cpio
3928
3929GNU cpio is Copyright (C) 1990, 1991, 1992, 2001, 2003, 2004, 2005,
39302006, 2007 Free Software Foundation, Inc.
3931
3932This program is free software; you can redistribute it and/or modify
3933it under the terms of the GNU General Public License as published by
3934the Free Software Foundation; either version 3, or (at your option)
3935any later version.
3936
3937The text of the GPL can be found on Debian systems in
3938/usr/share/common-licenses/GPL-3 .
3939 The Debian GNU Compiler Collection Setup
3940 ========================================
3941
3942Abstract
3943--------
3944
3945Debian uses a default version of GCC for most packages; however, some
3946packages require another version. So, Debian allows several versions
3947of GCC to coexist on the same system, and selects the default version
3948by means of the gcc-defaults package, which creates symbolic links as
3949appropriate.
3950
3951Versions of GCC present in Debian Squeeze
3952-----------------------------------------
3953
3954- GCC 4.3 is the default compiler for C, C++, Objective-C, Objective-C++,
3955 Ada, Fortran 95, and Java on all architectures. This package also
3956 provides libgcc1, libgcc2 (m68k) and libgcc4 (hppa) which contain the
3957 GCC intrinsics, and libstdc++6.
3958
3959- GCC 4.1 is the default compiler for D and Pascal.
3960
3961- GCC 3.4 is provided for the C, but is not the default for any language.
3962
3963- GCC 3.3 is not provided anymore; it is used to build libstdc++5 on
3964 the amd64 and i386 architectures. It is expected that libstdc++5 is
3965 not available anymore for the release following Lenny.
3966
3967- GCC 2.95 and GCC 2.7.2.3 were removed for the release of Lenny.
3968
3969How are the default compilers selected?
3970---------------------------------------
3971
3972Starting in Debian 3.0, there is now a gcc-defaults package set. This
3973creates the actual packages for gcc, gnat, g++, gobjc, chill, gcj, gij,
3974gdc and gpc. These packages will depend on the corresponding default
3975compiler for that architecture. For Debian 4.0 for example, "gcc"
3976depends on "gcc-4.1", which means that the "gcc-4.1" package will
3977install a binary called "gcc-4.1", which is symlinked to in the "gcc"
3978package as "gcc".
3979
3980This may seem confusing, but what it allows you do to is install more
3981than one version of the GCC compiler collection at the same time,
3982making sure you are always using the one preferred for that
3983architecture. To use the other compiler, simply set CC=gcc-4.1, or
3984similar.
3985
3986The default compiler versions for Debian GNU/Linux on i386 are
3987(minor version numbers omitted):
3988
3989 cpp : cpp-4.6
3990 gcc : gcc-4.6
3991 g++ : g++-4.6
3992 gfortran : gfortran-4.6
3993 gcj : gcj-4.6
3994 gij : gij-4.6
3995 gobjc : gobjc-4.6
3996 gobjc++ : gobjc++-4.6
3997 gdc : gdc-4.6
3998
3999Documentation for the default compilers can be found in
4000
4001 /usr/share/doc/<compiler>-<package version>.
4002
4003Thanks to gcc-defaults, each architecture can choose its own preferred
4004compiler for each language, and that preference can change without
4005requiring a complete rebuild of both compiler packages for all
4006architectures.
4007
4008Practical implications
4009----------------------
4010
4011The most important practical implications are in the merging/linking
4012of object files built with different compilers; If you use the 4.1
4013C compiler, you should use the gcc-4.1 compiler driver for all your
4014work. When configuring sources, use
4015
4016 CC=gcc-4.1 ./configure <configure options> # bash
4017 setenv CC gcc-4.1; ./configure <options> # csh
4018
4019When calling make, use make CC=gcc-4.1.
4020
4021C Application Binary Interface
4022------------------------------
4023
4024Starting with Debian 4.0 (lenny), gcc-4.1 and newer compilers do
4025support the long double datatype with 128bit on the alpha, powerpc,
4026s390 and sparc architectures. Libraries and applications using this
4027datatype have to be rebuilt using the compiler versions in Lenny
4028unless these depend on libc6/libc6.1 and libstdc++6, which still have
4029compatibility with a 64bit long double datatype.
4030
4031gcc/g++/... are not handled using alternatives
4032----------------------------------------------
4033
4034The symlinks in /usr/bin (gcc, g++, ...) are not handled using the Debian
4035alternative mechanism. There are differences in the architecture specific
4036ABI on some architectures and the C++ ABI differs as well. Having the
4037symlinks managed by alternatives doesn't allow reliable builds with the
4038same major/minor version of the compiler. To use another compiler version,
4039set the appropriate environment variables as described above in the section
4040"Practical implications".
4041
4042C++ libraries
4043-------------
4044
4045To use the libstdc++ library for debugging (found in the
4046libstd++6-<GCC version>-dbg package), add /usr/lib/debug to your
4047LD_LIBRARY_PATH. For gdb to display the source you need to get the
4048correspondig gcc-X.Y source package, unpack the source and point gdb
4049to the location of the source (dir directive).
4050
4051C++ Application Binary Interface
4052--------------------------------
4053
4054Sometimes, the C++ ABI of GCC changes. It is impossible to link
4055object files that obey different ABIs into an executable. When the
4056ABI changes, Debian provides a new version of libstdc++ with a new
4057soname.
4058
4059Version 4 of the ABI was used by GCC 3.0 and 3.1; it is no longer
4060supported.
4061
4062Version 5 of the ABI is common to GCC 3.2 and 3.3; GCC 3.3
4063provides libstdc++5. It is only supported as a runtime library.
4064
4065Version 6 of the ABI is common to GCC 3.4 and later; GCC 4.3 provides
4066libstdc++6.
4067
4068Bugs
4069----
4070
4071Before submitting a bug, please read README.Bugs in this directory.
4072
4073Feedback appreciated
4074--------------------
4075
4076Feedback about this document is appreciated; preferably as a Severity:
4077wishlist bug against Package: gcc . For general discussions and
4078questions, subscribe and/or email the debian-gcc@lists.debian.org mailing
4079list.
4080
4081Maintainers of these packages
4082-----------------------------
4083
4084Matthias Klose <doko@debian.org>
4085Ray Dassen <jdassen@debian.org>
4086Philip Blundell <pb@debian.org> (arm-linux)
4087Jeff Bailey <jbailey@nisa.net> (hurd-i386)
4088Joel Baker <fenton@debian.org> (netbsd-i386)
4089Ben Collins <bcollins@debian.org> (sparc-linux)
4090Falk Hueffner <falk@debian.org> (alpha-linux)
4091Randolph Chung <tausq@debian.org> (ia64-linux, hppa-linux)
4092Thiemo Seufer <ths@networkno.de> (mips*-linux)
4093Dan Jacobowitz <dan@debian.org> (powerpc-linux)
4094Gerhard Tonn <GerhardTonn@swol.de> (s390-linux)
4095Roman Zippel <zippel@linux-m68k.org> (m68k-linux)
4096Ludovic Brenta <ludovic.brenta@insalien.org> (gnat)
4097Arthur Loiret <arthur.loiret@gmail.com> (gdc)
4098
4099===============================================================================
4100 gcc-defaults is Copyright (C) 2000, 2001, 2006, 2009 Debian.
4101
4102These scripts are free software; you can redistribute it and/or modify it
4103under the terms of the GNU General Public License as published by the
4104Free Software Foundation; either version 2, or (at your option) any
4105later version.
4106
4107On Debian GNU/Linux systems, the complete text of the GNU General
4108Public License can be found in `/usr/share/common-licenses/GPL'.
4109
4110The c89 and c99 man pages are taken from netbsd:
4111
4112Copyright (c) 1999 The NetBSD Foundation, Inc.
4113All rights reserved.
4114
4115Redistribution and use in source and binary forms, with or without
4116modification, are permitted provided that the following conditions
4117are met:
41181. Redistributions of source code must retain the above copyright
4119 notice, this list of conditions and the following disclaimer.
41202. Redistributions in binary form must reproduce the above copyright
4121 notice, this list of conditions and the following disclaimer in the
4122 documentation and/or other materials provided with the distribution.
41233. All advertising materials mentioning features or use of this software
4124 must display the following acknowledgement:
4125 This product includes software developed by the NetBSD
4126 Foundation, Inc. and its contributors.
41274. Neither the name of The NetBSD Foundation nor the names of its
4128 contributors may be used to endorse or promote products derived
4129 from this software without specific prior written permission.
4130
4131
4132 Format-Specification: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=166
4133Upstream-Name: crda
4134Upstream-Contact: Luis R. Rodriguez <mcgrof@gmail.com>
4135Source: git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/crda.git
4136
4137Files: *
4138Copyright: 2008, Luis R. Rodriguez <mcgrof@gmail.com>
4139 2008, Johannes Berg <johannes@sipsolutions.net>
4140 2008, Michael Green <Michael.Green@Atheros.com>
4141License: ISC
4142
4143Files: nl80211.h
4144Copyright: 2006-2008 Johannes Berg <johannes@sipsolutions.net>
4145 2008 Michael Wu <flamingice@sourmilk.net>
4146 2008 Luis Carlos Cobo <luisca@cozybit.com>
4147 2008 Michael Buesch <mb@bu3sch.de>
4148 2008 Luis R. Rodriguez <lrodriguez@atheros.com>
4149 2008 Jouni Malinen <jouni.malinen@atheros.com>
4150 2008 Colin McCabe <colin@cozybit.com>
4151License: ISC
4152
4153Files: debian/*
4154Copyright: 2009, Kel Modderman <kel@otaku42.de>
4155 2011, Stefan Lippers-Hollmann <s.l-h@gmx.de>
4156License: ISC
4157
4158License: ISC
4159 Permission to use, copy, modify, and/or distribute this software for any
4160 purpose with or without fee is hereby granted, provided that the above
4161 copyright notice and this permission notice appear in all copies.
4162 $Id: FEATURES,v 2.1 1993/12/28 08:34:43 vixie Exp $
4163
4164Features of Vixie's cron relative to BSD 4.[23] and SysV crons:
4165
4166-- Environment variables can be set in each crontab. SHELL, USER,
4167 LOGNAME, and HOME are set from the user's passwd entry; all except
4168 USER can be changed in the crontab. PATH is especially useful to
4169 set there. TZ can be set, but cron ignores it other than passing
4170 it on through to the commands it runs. Format is
4171
4172 variable=value
4173
4174 Blanks surrounding the '=' will be eaten; other blanks in value are
4175 okay. Leading or trailing blanks can be preserved by quoting, single
4176 or double quotes are okay, just so they match.
4177
4178 PATH=.:/bin:/usr/bin
4179 SHELL=/bin/sh
4180 FOOBAR = this is a long blanky example
4181
4182 Above, FOOBAR would get "this is a long blanky example" as its value.
4183
4184 SHELL and HOME will be used when it's time to run a command; if
4185 you don't set them, HOME defaults to your /etc/passwd entry
4186 and SHELL defaults to /bin/sh.
4187
4188 MAILTO, if set to the login name of a user on your system, will be the
4189 person that cron mails the output of commands in that crontab. This is
4190 useful if you decide on BINMAIL when configuring cron.h, since binmail
4191 doesn't know anything about aliasing.
4192
4193-- Weekdays can be specified by name. Case is not significant, but only
4194 the first three letters should be specified.
4195
4196-- Months can likewise be specified by name. Three letters only.
4197
4198-- Ranges and lists can be mixed. Standard crons won't allow '1,3-5'.
4199
4200-- Ranges can specify 'step' values. '10-16/2' is like '10,12,14,16'.
4201
4202-- Sunday is both day 0 and day 7 -- apparently BSD and ATT disagree
4203 about this.
4204
4205-- Each user gets their own crontab file. This is a win over BSD 4.2,
4206 where only root has one, and over BSD 4.3, where they made the crontab
4207 format incompatible and although the commands can be run by non-root
4208 uid's, root is still the only one who can edit the crontab file. This
4209 feature mimics the SysV cron.
4210
4211-- The 'crontab' command is loosely compatible with SysV, but has more
4212 options which just generally make more sense. Running crontab with
4213 no arguments will print a cute little summary of the command syntax.
4214
4215-- Comments and blank lines are allowed in the crontab file. Comments
4216 must be on a line by themselves; leading whitespace is ignored, and
4217 a '#' introduces the comment.
4218
4219-- (big win) If the `crontab' command changes anything in any crontab,
4220 the 'cron' daemon will reload all the tables before running the
4221 next iteration. In some crons, you have to kill and restart the
4222 daemon whenever you change a crontab. In other crons, the crontab
4223 file is reread and reparsed every minute even if it didn't change.
4224
4225-- In order to support the automatic reload, the crontab files are not
4226 readable or writable except by 'crontab' or 'cron'. This is not a
4227 problem, since 'crontab' will let you do pretty much whatever you
4228 want to your own crontab, or if you are root, to anybody's crontab.
4229
4230-- If any output is generated by a command (on stdout OR stderr), it will
4231 be mailed to the owner of the crontab that contained the command (or
4232 MAILTO, see discussion of environment variables, above). The headers
4233 of the mail message will include the command that was run, and a
4234 complete list of the environment that was passed to it, which will
4235 contain (at least) the USER (LOGNAME on SysV), HOME, and SHELL.
4236
4237-- the dom/dow situation is odd. '* * 1,15 * Sun' will run on the
4238 first and fifteenth AND every Sunday; '* * * * Sun' will run *only*
4239 on Sundays; '* * 1,15 * *' will run *only* the 1st and 15th. this
4240 is why we keep 'e->dow_star' and 'e->dom_star'. I didn't think up
4241 this behaviour; it's how cron has always worked but the documentation
4242 hasn't been very clear. I have been told that some AT&T crons do not
4243 act this way and do the more reasonable thing, which is (IMHO) to "or"
4244 the various field-matches together. In that sense this cron may not
4245 be completely similar to some AT&T crons.
4246 #/* Copyright 1988,1990,1993 by Paul Vixie
4247# * All rights reserved
4248# *
4249# * Distribute freely, except: don't remove my name from the source or
4250# * documentation (don't take credit for my work), mark your changes (don't
4251# * get me blamed for your possible bugs), don't alter or remove this
4252# * notice. May be sold if buildable source is provided to buyer. No
4253# * warrantee of any kind, express or implied, is included with this
4254# * software; use at your own risk, responsibility for damages (if any) to
4255# * anyone resulting from the use of this software rests entirely with the
4256# * user.
4257# *
4258# * Send bug reports, bug fixes, enhancements, requests, flames, etc., and
4259# * I'll try to keep a version up to date. I can be reached as follows:
4260# * Paul Vixie <paul@vix.com> uunet!decwrl!vixie!paul
4261# */
4262
4263Vixie Cron V3.0
4264December 27, 1993
4265[V2.2 was some time in 1992]
4266[V2.1 was May 29, 1991]
4267[V2.0 was July 5, 1990]
4268[V2.0-beta was December 9, 1988]
4269[V1.0 was May 6, 1987]
4270Paul Vixie
4271
4272[Note from Debian cron maintainer: This is the original README from
4273the the vixie-cron package. The location of many cron files has been
4274changed in order to comply with Debian policy and common sense -- look
4275in the cron(8), crontab(1) and crontab(5) man pages for more info, as
4276well as the README.Debian file in this directory.]
4277
4278This is a version of 'cron' that is known to run on BSD 4.[23] systems. It
4279is functionally based on the SysV cron, which means that each user can have
4280their own crontab file (all crontab files are stored in a read-protected
4281directory, usually /var/cron/tabs). No direct support is provided for
4282'at'; you can continue to run 'atrun' from the crontab as you have been
4283doing. If you don't have atrun (i.e., System V) you are in trouble.
4284
4285A messages is logged each time a command is executed; also, the files
4286"allow" and "deny" in /var/cron can be used to control access to the
4287"crontab" command (which installs crontabs). It hasn't been tested on
4288SysV, although some effort has gone into making the port an easy one.
4289
4290This is more or less the copyright that USENET contributed software usually
4291has. Since ATT couldn't use this version if they had to freely distribute
4292source, and since I'd love to see them use it, I'll offer some rediculously
4293low license fee just to have them take it. In the unlikely event that they
4294do this, I will continue to support and distribute the pseudo-PD version, so
4295please, don't flame me for wanting my work to see a wider distribution.
4296
4297To use this: Sorry, folks, there is no cutesy 'Configure' script. You'll
4298have to go edit a couple of files... So, here's the checklist:
4299
4300 Read all the FEATURES, INSTALL, and CONVERSION files
4301 Edit config.h
4302 Edit Makefile
4303 (both of these files have instructions inside; note that
4304 some things in config.h are definable in Makefile and are
4305 therefore surrounded by #ifndef...#endif)
4306 'make'
4307 'su' and 'make install'
4308 (you may have to install the man pages by hand)
4309 kill your existing cron process
4310 (actually you can run your existing cron if you want, but why?)
4311 build new crontabs using /usr/lib/{crontab,crontab.local}
4312 (either put them all in "root"'s crontab, or divide it up
4313 and rip out all the 'su' commands, collapse the lengthy
4314 lists into ranges with steps -- basically, this step is
4315 as much work as you want to make it)
4316 start up the new cron
4317 (must be done as root)
4318 watch it. test it with 'crontab -r' and watch the daemon track your
4319 changes.
4320 if you like it, change your /etc/{rc,rc.local} to use it instead of
4321 the old one.
4322
4323$Id: README,v 2.3 1993/12/28 08:34:43 vixie Exp $
4324 cron for DEBIAN
4325----------------------
4326
4327This is the Debian GNU/Linux prepackaged and heavily modified version
4328of Paul Vixie's cron subsystem.
4329
4330Debian's cron development is being done on Alioth:
4331http://anonscm.debian.org/gitweb/?p=pkg-cron/cron.git
4332
4333This package was put together by Ian Jackson <iwj10@cus.cam.ac.uk>,
4334from the standard sources to 3.0pl1, as posted to comp.sources.unix.
4335Ian obtained them from
4336src.doc.ic.ac.uk:/usenet/comp.sources.unix/volume27/vixie-cron.
4337
4338Debian's cron version introduces a significant number of changes:
4339 * Support for /etc/cron.d (drop-in dir for package crontabs)
4340 * Debian-specific file locations and commands
4341 * PAM support
4342 * SELinux support
4343 * auditlog support
4344 * DST and other time-related changes/fixes
4345 * SGID crontab(1) instead of SUID root
4346 * numerous other smaller features and fixes.
4347
4348Users are STRONGLY advised to carefully check the man pages crontab(1)
4349and crontab(5). System administrators should also read cron(8).
4350
4351File locations that are different than that indicated in
4352the cron distributions README:
4353
4354user crontabs: /var/spool/cron/crontabs/*
4355log file: Check your syslog settings, facility "cron"
4356allow file: /etc/cron.allow
4357deny file: /etc/cron.deny
4358
4359This package is now maintained by Javier Fernández-Sanguino Peña
4360<jfs@computer.org> and Christian Kastner <debian@kvr.at>.
4361
4362Historical note: The old subversion repository from before the
4363migration to git can be found here:
4364 http://svn.debian.org/wsvn/pkg-cron
4365 To ease coordination with anacron, the invocation of the run-parts for
4366the /etc/cron.daily, /etc/cron.weekly, and /etc/cron.monthly directories
4367was changed to the form
4368
4369 test -e /usr/sbin/anacron || run-parts --report /etc/cron.daily
4370
4371What this means is that if anacron has been installed, it will
4372be responsible for running those scripts. This is the standard
4373configuration of anacron: if you simply install both cron and anacron,
4374things will work as expected.
4375
4376However, if you have modified your anacron configuration
4377(/etc/anacrontab), you may need to re-adjust it in order to accommodate
4378this change. Format: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=173
4379Upstream-Name: vixie-cron
4380Ustream-Contact: Paul Vixie <paul@vix.com>
4381Source:
4382 The original source for this package could be obtained from
4383 ftp://ftp.vix.com/pub/vixie/cron-3.0, although that link appears to have gone
4384 down.
4385
4386Files: *
4387Copyright: 1988, 1990, 1993, 1994, Paul Vixie <paul@vix.com>
4388 1994, Ian Jackson <ian@davenant.greenend.org.uk>
4389 1996-2005, Steve Greenland <stevegr@debian.org>
4390 2005-2006, 2008-2010, Javier Fernández-Sanguino Peña <jfs@debian.org>
4391 2010-2011, Christian Kastner <debian@kvr.at>
4392 Numerous contributions via the Debian BTS copyright their respective authors
4393License: Paul Vixie's license
4394
4395Files: database.c
4396Copyright: 1988, 1990, 1993, 1994 Paul Vixie <paul@vix.com>
4397 1996-2005, Steve Greenland <stevegr@debian.org>
4398 2003, Clint Adams <schizo@debian.org>
4399 2010-2011, Christian Kastner <debian@kvr.at>
4400 2011, Red Hat, Inc.
4401License: Paul Vixie's license and GPL-2+ and ISC
4402
4403Files: debian/examples/cron-stats.pl
4404Copyright: 2006, Javier Fernández-Sanguino Peña <jfs@debian.org>
4405License: GPL-2+
4406
4407Files: debian/examples/cron-tasks-review.sh
4408Copyright: 2011, Javier Fernández-Sanguino Peña <jfs@debian.org>
4409License: GPL-2+
4410
4411Files: debian/examples/crontab2english.pl
4412Copyright: 2001, Sean M. Burke
4413License: Artistic
4414
4415License: Paul Vixie's license
4416
4417License: GPL-2+
4418 This package is free software; you can redistribute it and/or modify
4419 it under the terms of the GNU General Public License as published by
4420 the Free Software Foundation; either version 2 of the License, or
4421 (at your option) any later version.
4422 .
4423 This package is distributed in the hope that it will be useful,
4424 but WITHOUT ANY WARRANTY; without even the implied warranty of
4425 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4426 GNU General Public License for more details.
4427 .
4428 You should have received a copy of the GNU General Public License
4429 along with this program. If not, see <http://www.gnu.org/licenses/>
4430 .
4431 On Debian systems, the complete text of the GNU General
4432 Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
4433
4434License: Artistic
4435 This program is free software; you can redistribute it and/or modify it
4436 under the terms of the "Artistic License" which comes with Debian.
4437 .
4438 On Debian systems, the complete text of the Artistic License
4439 can be found in "/usr/share/common-licenses/Artistic".
4440
4441License: ISC
4442
4443 9,136 DEBUG: Could not instantiate Handler subclass __builtin__.DvbUsbFirmwareHandler from name DvbUsbFirmwareHandler
4444Traceback (most recent call last):
4445 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4446 desc = inst.name()
4447 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4448 self._package_defaults()
4449 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4450 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4451 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4452 raise ValueError('package %s does not exist' % package)
4453ValueError: package linux-firmware-nonfree does not exist
44542013-04-09 19:57:29,153 DEBUG: loading custom handler /usr/share/jockey/handlers/pvr-omap4.py
44552013-04-09 19:57:29,215 WARNING: modinfo for module omapdrm_pvr failed: ERROR: modinfo: could not find module omapdrm_pvr
4456
44572013-04-09 19:57:29,265 DEBUG: Instantiated Handler subclass __builtin__.PVROmap4Driver from name PVROmap4Driver
44582013-04-09 19:57:31,063 DEBUG: XorgDriverHandler(omapdrm_pvr, pvr-omap4, None): Disabling as package is not compatible with Q-LTS X.org
44592013-04-09 19:57:31,064 DEBUG: PowerVR SGX proprietary graphics driver for OMAP 4 not available
44602013-04-09 19:57:31,065 DEBUG: loading custom handler /usr/share/jockey/handlers/cdv.py
44612013-04-09 19:57:31,124 WARNING: modinfo for module cedarview_gfx failed: ERROR: modinfo: could not find module cedarview_gfx
4462
44632013-04-09 19:57:31,125 DEBUG: Instantiated Handler subclass __builtin__.CdvDriver from name CdvDriver
44642013-04-09 19:57:31,126 DEBUG: cdv.available: falling back to default
44652013-04-09 19:57:32,669 DEBUG: XorgDriverHandler(cedarview_gfx, cedarview-graphics-drivers, None): Disabling as package is not compatible with Q-LTS X.org
44662013-04-09 19:57:32,670 DEBUG: Intel Cedarview graphics driver not available
44672013-04-09 19:57:32,670 DEBUG: loading custom handler /usr/share/jockey/handlers/madwifi.py
44682013-04-09 19:57:32,712 WARNING: modinfo for module ath_pci failed: ERROR: modinfo: could not find module ath_pci
4469
44702013-04-09 19:57:32,714 DEBUG: Instantiated Handler subclass __builtin__.MadwifiHandler from name MadwifiHandler
44712013-04-09 19:57:32,714 DEBUG: Alternate Atheros "madwifi" driver availability undetermined, adding to pool
44722013-04-09 19:57:32,715 DEBUG: loading custom handler /usr/share/jockey/handlers/nvidia.py
44732013-04-09 19:57:32,792 WARNING: modinfo for module nvidia_96 failed: ERROR: modinfo: could not find module nvidia_96
4474
44752013-04-09 19:57:32,828 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver96 from name NvidiaDriver96
44762013-04-09 19:57:32,837 DEBUG: nvidia.available: falling back to default
44772013-04-09 19:57:34,435 DEBUG: XorgDriverHandler(nvidia_96, nvidia-96, None): Disabling as package is not compatible with Q-LTS X.org
44782013-04-09 19:57:34,436 DEBUG: NVIDIA accelerated graphics driver not available
44792013-04-09 19:57:34,470 WARNING: modinfo for module nvidia_current failed: ERROR: modinfo: could not find module nvidia_current
4480
44812013-04-09 19:57:34,520 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriverCurrent from name NvidiaDriverCurrent
44822013-04-09 19:57:34,522 DEBUG: nvidia.available: falling back to default
44832013-04-09 19:57:36,224 DEBUG: XorgDriverHandler(nvidia_current, nvidia-current, None): Disabling as package is not compatible with Q-LTS X.org
44842013-04-09 19:57:36,226 DEBUG: NVIDIA accelerated graphics driver not available
44852013-04-09 19:57:36,260 WARNING: modinfo for module nvidia_current_updates failed: ERROR: modinfo: could not find module nvidia_current_updates
4486
44872013-04-09 19:57:36,296 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriverCurrentUpdates from name NvidiaDriverCurrentUpdates
44882013-04-09 19:57:36,303 DEBUG: nvidia.available: falling back to default
44892013-04-09 19:57:37,877 DEBUG: XorgDriverHandler(nvidia_current_updates, nvidia-current-updates, None): Disabling as package is not compatible with Q-LTS X.org
44902013-04-09 19:57:37,878 DEBUG: NVIDIA accelerated graphics driver (post-release updates) not available
44912013-04-09 19:57:37,915 WARNING: modinfo for module nvidia_96_updates failed: ERROR: modinfo: could not find module nvidia_96_updates
4492
44932013-04-09 19:57:37,952 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver96Updates from name NvidiaDriver96Updates
44942013-04-09 19:57:37,954 DEBUG: nvidia.available: falling back to default
44952013-04-09 19:57:39,616 DEBUG: XorgDriverHandler(nvidia_96_updates, nvidia-96-updates, None): Disabling as package is not compatible with Q-LTS X.org
44962013-04-09 19:57:39,617 DEBUG: NVIDIA accelerated graphics driver (post-release updates) not available
44972013-04-09 19:57:39,671 WARNING: modinfo for module nvidia_173_updates failed: ERROR: modinfo: could not find module nvidia_173_updates
4498
44992013-04-09 19:57:39,724 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver173Updates from name NvidiaDriver173Updates
45002013-04-09 19:57:39,733 DEBUG: nvidia.available: falling back to default
45012013-04-09 19:57:41,463 DEBUG: XorgDriverHandler(nvidia_173_updates, nvidia-173-updates, None): Disabling as package is not compatible with Q-LTS X.org
45022013-04-09 19:57:41,466 DEBUG: NVIDIA accelerated graphics driver (post-release updates) not available
45032013-04-09 19:57:41,507 WARNING: modinfo for module nvidia_173 failed: ERROR: modinfo: could not find module nvidia_173
4504
45052013-04-09 19:57:41,569 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver173 from name NvidiaDriver173
45062013-04-09 19:57:41,584 DEBUG: nvidia.available: falling back to default
45072013-04-09 19:57:43,666 DEBUG: XorgDriverHandler(nvidia_173, nvidia-173, None): Disabling as package is not compatible with Q-LTS X.org
45082013-04-09 19:57:43,667 DEBUG: NVIDIA accelerated graphics driver not available
45092013-04-09 19:57:43,722 WARNING: modinfo for module nvidia_experimental_310 failed: ERROR: modinfo: could not find module nvidia_experimental_310
4510
45112013-04-09 19:57:43,968 DEBUG: Could not instantiate Handler subclass __builtin__.NvidiaDriverExperimental310 from name NvidiaDriverExperimental310
4512Traceback (most recent call last):
4513 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4514 desc = inst.name()
4515 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4516 self._package_defaults()
4517 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4518 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4519 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4520 raise ValueError('package %s does not exist' % package)
4521ValueError: package nvidia-experimental-310 does not exist
45222013-04-09 19:57:44,020 WARNING: modinfo for module nvidia_experimental_304 failed: ERROR: modinfo: could not find module nvidia_experimental_304
4523
45242013-04-09 19:57:44,200 DEBUG: Could not instantiate Handler subclass __builtin__.NvidiaDriverExperimental304 from name NvidiaDriverExperimental304
4525Traceback (most recent call last):
4526 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4527 desc = inst.name()
4528 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4529 self._package_defaults()
4530 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4531 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4532 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4533 raise ValueError('package %s does not exist' % package)
4534ValueError: package nvidia-experimental-304 does not exist
45352013-04-09 19:57:44,201 DEBUG: loading custom handler /usr/share/jockey/handlers/sl_modem.py
45362013-04-09 19:57:44,360 DEBUG: Instantiated Handler subclass __builtin__.SlModem from name SlModem
45372013-04-09 19:57:44,767 DEBUG: Software modem not available
45382013-04-09 19:57:44,768 DEBUG: loading custom handler /usr/share/jockey/handlers/fglrx.py
45392013-04-09 19:57:44,824 WARNING: modinfo for module fglrx_updates failed: ERROR: modinfo: could not find module fglrx_updates
4540
45412013-04-09 19:57:44,865 DEBUG: Instantiated Handler subclass __builtin__.FglrxDriverUpdate from name FglrxDriverUpdate
45422013-04-09 19:57:44,866 DEBUG: fglrx.available: falling back to default
45432013-04-09 19:57:46,399 DEBUG: XorgDriverHandler(fglrx_updates, fglrx-updates, None): Disabling as package is not compatible with Q-LTS X.org
45442013-04-09 19:57:46,400 DEBUG: ATI/AMD proprietary FGLRX graphics driver (post-release updates) not available
45452013-04-09 19:57:46,441 WARNING: modinfo for module fglrx_experimental_9 failed: ERROR: modinfo: could not find module fglrx_experimental_9
4546
45472013-04-09 19:57:46,634 DEBUG: Could not instantiate Handler subclass __builtin__.FglrxDriverExperimental9 from name FglrxDriverExperimental9
4548Traceback (most recent call last):
4549 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4550 desc = inst.name()
4551 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4552 self._package_defaults()
4553 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4554 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4555 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4556 raise ValueError('package %s does not exist' % package)
4557ValueError: package fglrx-experimental-9 does not exist
45582013-04-09 19:57:46,679 WARNING: modinfo for module fglrx failed: ERROR: modinfo: could not find module fglrx
4559
45602013-04-09 19:57:46,720 DEBUG: Instantiated Handler subclass __builtin__.FglrxDriver from name FglrxDriver
45612013-04-09 19:57:46,721 DEBUG: fglrx.available: falling back to default
45622013-04-09 19:57:48,530 DEBUG: XorgDriverHandler(fglrx, fglrx, None): Disabling as package is not compatible with Q-LTS X.org
45632013-04-09 19:57:48,531 DEBUG: ATI/AMD proprietary FGLRX graphics driver not available
45642013-04-09 19:57:48,532 DEBUG: loading custom handler /usr/share/jockey/handlers/vmware-client.py
45652013-04-09 19:57:48,607 WARNING: modinfo for module vmxnet failed: ERROR: modinfo: could not find module vmxnet
4566
45672013-04-09 19:57:48,612 DEBUG: Instantiated Handler subclass __builtin__.VmwareClientHandler from name VmwareClientHandler
45682013-04-09 19:57:48,774 DEBUG: VMWare Client Tools not available
45692013-04-09 19:57:48,778 DEBUG: all custom handlers loaded
45702013-04-09 19:57:48,779 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007110sv00000000sd00000000bc06sc80i00')
45712013-04-09 19:57:53,682 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0019v0000p0005e0000-e0,5,kramlsfw0,')
45722013-04-09 19:57:53,764 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
45732013-04-09 19:57:54,630 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
45742013-04-09 19:57:54,635 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0800:')
45752013-04-09 19:57:54,636 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007113sv00000000sd00000000bc06sc80i00')
45762013-04-09 19:57:54,684 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'i2c_piix4'}
45772013-04-09 19:57:54,685 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'i2c_piix4', 'jockey_handler': 'KernelModuleHandler'}
45782013-04-09 19:57:54,685 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v0000104Cd0000AC51sv00001028sd000000B1bc06sc07i00')
45792013-04-09 19:57:54,843 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket'}
45802013-04-09 19:57:54,844 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket', 'jockey_handler': 'KernelModuleHandler'}
45812013-04-09 19:57:54,844 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket'}
45822013-04-09 19:57:54,845 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket', 'jockey_handler': 'KernelModuleHandler'}
45832013-04-09 19:57:54,845 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:dell-laptop')
45842013-04-09 19:57:54,853 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0019v0000p0003e0000-e0,1,k8E,ramlsfw')
45852013-04-09 19:57:54,854 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
45862013-04-09 19:57:54,855 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
45872013-04-09 19:57:54,859 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
45882013-04-09 19:57:54,860 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
45892013-04-09 19:57:54,860 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:eisa')
45902013-04-09 19:57:54,865 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'usb:v1D6Bp0001d0305dc09dsc00dp00ic09isc00ip00')
45912013-04-09 19:57:55,029 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0011v0001p0001eAB41-e0,1,4,11,14,k71,72,73,74,75,76,77,79,7A,7B,7C,7D,7E,7F,80,8C,8D,8E,8F,94,98,9B,9C,9D,9E,9F,A2,A3,A4,A5,A6,AC,AD,B7,B8,B9,BF,C1,CD,D4,D7,D9,E0,E1,E2,E3,EC,F0,ram4,l0,1,2,sfw')
45922013-04-09 19:57:55,030 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
45932013-04-09 19:57:55,031 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
45942013-04-09 19:57:55,043 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
45952013-04-09 19:57:55,044 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
45962013-04-09 19:57:55,044 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:regulatory')
45972013-04-09 19:57:55,056 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:LNXSYSTM:')
45982013-04-09 19:57:55,056 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:pcspkr')
45992013-04-09 19:57:55,065 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'pcspkr'}
46002013-04-09 19:57:55,066 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'pcspkr', 'jockey_handler': 'KernelModuleHandler'}
46012013-04-09 19:57:55,066 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'snd_pcsp'}
46022013-04-09 19:57:55,070 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'snd_pcsp', 'jockey_handler': 'KernelModuleHandler'}
46032013-04-09 19:57:55,070 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:dock')
46042013-04-09 19:57:55,078 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007111sv00000000sd00000000bc01sc01i80')
46052013-04-09 19:57:55,124 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0C04:')
46062013-04-09 19:57:55,125 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0401:')
46072013-04-09 19:57:55,126 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v000010ECd00008180sv00001737sd00000019bc02sc00i00')
46082013-04-09 19:57:55,221 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'rtl8180'}
46092013-04-09 19:57:55,222 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'rtl8180', 'jockey_handler': 'KernelModuleHandler'}
46102013-04-09 19:57:55,222 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0501:')
46112013-04-09 19:57:55,223 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0F13:')
46122013-04-09 19:57:55,227 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0B00:')
46132013-04-09 19:57:55,228 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00001002d00004C46sv00001028sd000000B1bc03sc00i00')
46142013-04-09 19:57:59,415 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'aty128fb'}
46152013-04-09 19:57:59,420 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'aty128fb', 'jockey_handler': 'KernelModuleHandler'}
46162013-04-09 19:57:59,420 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0100:')
46172013-04-09 19:57:59,421 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'serio:ty05pr00id00ex00')
46182013-04-09 19:57:59,515 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'psmouse'}
46192013-04-09 19:57:59,524 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'psmouse', 'jockey_handler': 'KernelModuleHandler'}
46202013-04-09 19:57:59,524 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0019v0000p0006e0000-e0,1,kE0,E1,E3,F1,F2,F3,F4,F5,ramlsfw')
46212013-04-09 19:57:59,525 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
46222013-04-09 19:57:59,526 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
46232013-04-09 19:57:59,526 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
46242013-04-09 19:57:59,527 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
46252013-04-09 19:57:59,531 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0011v0002p0007e9BB1-e0,1,3,k110,111,145,14A,14D,14E,ra0,1,18,1C,mlsfw')
46262013-04-09 19:57:59,535 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
46272013-04-09 19:57:59,536 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
46282013-04-09 19:57:59,536 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'joydev'}
46292013-04-09 19:57:59,537 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'joydev', 'jockey_handler': 'KernelModuleHandler'}
46302013-04-09 19:57:59,537 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'joydev'}
46312013-04-09 19:57:59,538 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'joydev', 'jockey_handler': 'KernelModuleHandler'}
46322013-04-09 19:57:59,538 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
46332013-04-09 19:57:59,543 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
46342013-04-09 19:57:59,544 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0000:')
46352013-04-09 19:57:59,544 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'dmi:bvnDellComputerCorporation:bvrA23:bd07/08/2003:svnDellComputerCorporation:pnLatitudeC600:pvr:rvnDellComputerCorporation:rnLatitudeC600:rvr:cvnDellComputerCorporation:ct8:cvr:')
46362013-04-09 19:57:59,721 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v0000125Dd00001998sv00001028sd000000B1bc04sc01i00')
46372013-04-09 19:57:59,767 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'snd_maestro3'}
46382013-04-09 19:57:59,767 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'snd_maestro3', 'jockey_handler': 'KernelModuleHandler'}
46392013-04-09 19:57:59,768 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0019v0000p0001e0000-e0,1,k74,ramlsfw')
46402013-04-09 19:57:59,769 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
46412013-04-09 19:57:59,769 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
46422013-04-09 19:57:59,770 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
46432013-04-09 19:57:59,770 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
46442013-04-09 19:57:59,771 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0C01:')
46452013-04-09 19:57:59,776 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007112sv00000000sd00000000bc0Csc03i00')
46462013-04-09 19:57:59,831 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00004220sv0000103Csd000012F5bc02sc80i00')
46472013-04-09 19:57:59,890 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'ipw2200'}
46482013-04-09 19:57:59,895 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'ipw2200', 'jockey_handler': 'KernelModuleHandler'}
46492013-04-09 19:57:59,895 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0200:')
46502013-04-09 19:57:59,896 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:Fixed MDIO bus')
46512013-04-09 19:57:59,903 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007191sv00000000sd00000000bc06sc04i00')
46522013-04-09 19:57:59,950 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'shpchp'}
46532013-04-09 19:57:59,955 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'shpchp', 'jockey_handler': 'KernelModuleHandler'}
46542013-04-09 19:57:59,956 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0700:')
46552013-04-09 19:57:59,956 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:dcdbas')
46562013-04-09 19:57:59,963 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:microcode')
46572013-04-09 19:57:59,967 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'x86cpu:vendor:0000:family:0006:model:0008:feature:,0000,0001,0002,0003,0004,0005,0006,0007,0008,000B,000C,000D,000E,000F,0011,0017,0018,0019,0066,0069')
46582013-04-09 19:58:00,064 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'microcode'}
46592013-04-09 19:58:00,065 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'microcode', 'jockey_handler': 'KernelModuleHandler'}
46602013-04-09 19:58:00,066 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'serio:ty01pr00id00ex00')
46612013-04-09 19:58:00,072 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'serio_raw'}
46622013-04-09 19:58:00,073 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'serio_raw', 'jockey_handler': 'KernelModuleHandler'}
46632013-04-09 19:58:00,073 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'psmouse'}
46642013-04-09 19:58:00,074 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'psmouse', 'jockey_handler': 'KernelModuleHandler'}
46652013-04-09 19:58:00,074 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0011v0002p000Ae0000-e0,1,2,k110,111,112,r0,1,amlsfw')
46662013-04-09 19:58:00,079 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
46672013-04-09 19:58:00,080 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
46682013-04-09 19:58:00,080 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
46692013-04-09 19:58:00,081 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
46702013-04-09 19:58:00,081 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0303:')
46712013-04-09 19:58:00,082 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007110sv00000000sd00000000bc06sc80i00')
46722013-04-09 19:58:00,082 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0019v0000p0005e0000-e0,5,kramlsfw0,')
46732013-04-09 19:58:00,083 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0800:')
46742013-04-09 19:58:00,087 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007113sv00000000sd00000000bc06sc80i00')
46752013-04-09 19:58:00,088 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v0000104Cd0000AC51sv00001028sd000000B1bc06sc07i00')
46762013-04-09 19:58:00,088 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:dell-laptop')
46772013-04-09 19:58:00,089 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0019v0000p0003e0000-e0,1,k8E,ramlsfw')
46782013-04-09 19:58:00,089 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:eisa')
46792013-04-09 19:58:00,090 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'usb:v1D6Bp0001d0305dc09dsc00dp00ic09isc00ip00')
46802013-04-09 19:58:00,090 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0011v0001p0001eAB41-e0,1,4,11,14,k71,72,73,74,75,76,77,79,7A,7B,7C,7D,7E,7F,80,8C,8D,8E,8F,94,98,9B,9C,9D,9E,9F,A2,A3,A4,A5,A6,AC,AD,B7,B8,B9,BF,C1,CD,D4,D7,D9,E0,E1,E2,E3,EC,F0,ram4,l0,1,2,sfw')
46812013-04-09 19:58:00,090 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:regulatory')
46822013-04-09 19:58:00,091 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:LNXSYSTM:')
46832013-04-09 19:58:00,096 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:pcspkr')
46842013-04-09 19:58:00,096 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:dock')
46852013-04-09 19:58:00,096 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007111sv00000000sd00000000bc01sc01i80')
46862013-04-09 19:58:00,097 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0C04:')
46872013-04-09 19:58:00,097 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0401:')
46882013-04-09 19:58:00,098 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v000010ECd00008180sv00001737sd00000019bc02sc00i00')
46892013-04-09 19:58:00,098 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0501:')
46902013-04-09 19:58:00,098 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0F13:')
46912013-04-09 19:58:00,103 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0B00:')
46922013-04-09 19:58:00,104 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00001002d00004C46sv00001028sd000000B1bc03sc00i00')
46932013-04-09 19:58:00,104 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0100:')
46942013-04-09 19:58:00,104 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'serio:ty05pr00id00ex00')
46952013-04-09 19:58:00,105 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0019v0000p0006e0000-e0,1,kE0,E1,E3,F1,F2,F3,F4,F5,ramlsfw')
46962013-04-09 19:58:00,105 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0011v0002p0007e9BB1-e0,1,3,k110,111,145,14A,14D,14E,ra0,1,18,1C,mlsfw')
46972013-04-09 19:58:00,106 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0000:')
46982013-04-09 19:58:00,106 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'dmi:bvnDellComputerCorporation:bvrA23:bd07/08/2003:svnDellComputerCorporation:pnLatitudeC600:pvr:rvnDellComputerCorporation:rnLatitudeC600:rvr:cvnDellComputerCorporation:ct8:cvr:')
46992013-04-09 19:58:00,106 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v0000125Dd00001998sv00001028sd000000B1bc04sc01i00')
47002013-04-09 19:58:00,117 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0019v0000p0001e0000-e0,1,k74,ramlsfw')
47012013-04-09 19:58:00,117 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0C01:')
47022013-04-09 19:58:00,118 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007112sv00000000sd00000000bc0Csc03i00')
47032013-04-09 19:58:00,118 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00004220sv0000103Csd000012F5bc02sc80i00')
47042013-04-09 19:58:00,119 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0200:')
47052013-04-09 19:58:00,123 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:Fixed MDIO bus')
47062013-04-09 19:58:00,124 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007191sv00000000sd00000000bc06sc04i00')
47072013-04-09 19:58:00,124 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0700:')
47082013-04-09 19:58:00,124 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:dcdbas')
47092013-04-09 19:58:00,125 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:microcode')
47102013-04-09 19:58:00,125 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'x86cpu:vendor:0000:family:0006:model:0008:feature:,0000,0001,0002,0003,0004,0005,0006,0007,0008,000B,000C,000D,000E,000F,0011,0017,0018,0019,0066,0069')
47112013-04-09 19:58:00,126 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'serio:ty01pr00id00ex00')
47122013-04-09 19:58:00,126 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0011v0002p000Ae0000-e0,1,2,k110,111,112,r0,1,amlsfw')
47132013-04-09 19:58:00,126 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0303:')
47142013-04-09 19:58:24,976 DEBUG: Shutting down
47152013-04-09 19:58:35,331 DEBUG: updating <jockey.detection.LocalKernelModulesDriverDB instance at 0x910bb6c>
47162013-04-09 19:58:42,531 DEBUG: reading modalias file /lib/modules/3.5.0-23-generic/modules.alias
47172013-04-09 19:58:43,513 DEBUG: reading modalias file /usr/share/jockey/modaliases/b43
47182013-04-09 19:58:43,521 DEBUG: reading modalias file /usr/share/jockey/modaliases/disable-upstream-nvidia
47192013-04-09 19:58:44,179 DEBUG: loading custom handler /usr/share/jockey/handlers/broadcom_wl.py
47202013-04-09 19:58:44,288 WARNING: modinfo for module wl failed: ERROR: modinfo: could not find module wl
4721
47222013-04-09 19:58:44,476 DEBUG: Instantiated Handler subclass __builtin__.BroadcomWLHandler from name BroadcomWLHandler
47232013-04-09 19:58:44,478 DEBUG: Broadcom STA wireless driver availability undetermined, adding to pool
47242013-04-09 19:58:44,479 DEBUG: loading custom handler /usr/share/jockey/handlers/dvb_usb_firmware.py
47252013-04-09 19:58:44,730 DEBUG: Could not instantiate Handler subclass __builtin__.DvbUsbFirmwareHandler from name DvbUsbFirmwareHandler
4726Traceback (most recent call last):
4727 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4728 desc = inst.name()
4729 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4730 self._package_defaults()
4731 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4732 (distro_name, distro_desc) = Ousing GnuPG keys for LUKS dm-crypt devices in Debian
4733----------------------------------------------------
4734
4735The Debian cryptsetup package provides the keyscript decrypt_gnupg for setups
4736with a GnuPG encrypted LUKS keyfile.
4737
4738The following example assumes that you store the encrypted keyfile in
4739/etc/keys/cryptkey.gpg. LUKS device is /dev/<luks_device>.
4740
4741First, you'll have to create the encrypted keyfile:
4742
4743# dd if=/dev/random bs=1 count=256 | gpg --no-options --no-random-seed-file \
4744 --no-default-keyring --keyring /dev/null --secret-keyring /dev/null \
4745 --trustdb-name /dev/null --symmetric --output /etc/keys/cryptkey.gpg
4746
4747Next the LUKS device needs to be formated with the key. For that, the
4748decrypt_gnupg keyscript can be used:
4749
4750# /lib/cryptsetup/scripts/decrypt_gnupg /etc/keys/crytpkey.gpg | \
4751 cryptsetup --key-file=- luksFormat /dev/<luks_device>
4752
4753In order to unlock the encrypted LUKS device automatically during boot process,
4754add the following to /etc/crypttab:
4755
4756cdev1 /dev/<luks_device> /etc/keys/cryptkey.gpg luks,keyscript=decrypt_gnupg
4757
4758encrypted root filesystem with GnuPG key
4759----------------------------------------
4760
4761In case that you want to encrypt the root filesystem with a GnuPG encrypted key,
4762the provided initramfs hooks should do all additionally required work for you
4763when the initramfs is created or updated.
4764
4765Be warned though, that the GnuPG key for encrypted root is copied to the
4766initramfs by the initramfs cryptgnupg hook. If you don't want your GnuPG key
4767inside the initramfs, you should take a look at the initramfs cryptgnupg hook,
4768which is located at /usr/share/initramfs-tools/hooks/cryptgnupg.
4769 decrypt_keyctl
4770==============
4771
4772A passphrase caching script to be used in /etc/crypttab on Debian and Ubuntu.
4773When there are multiple cryptsetup (either plain or LUKS) volumes with the same
4774passphrase, it is an unnecessary task to input the passphrase more than once.
4775
4776Just add this script as keyscript to your /etc/crypttab and it will cache the
4777passphrase of all cryptab entries with the same identifier.
4778
4779Either copy decrypt_keyctl into the default search path for keyscripts from
4780cryptsetup /lib/cryptdisks/scripts/. So you can just write keyscript=decrypt_keyctl
4781in /etc/crypttab, or use a random path of your choice and give the full path
4782e.g keyscript=/sbin/decrypt_keyctl.
4783
4784
4785Requirements
4786------------
4787
4788 - Debian cryptsetup package with /etc/crypttab handling and keyscript option
4789 - Tested with Debian Lenny, Squeeze and Sid
4790 - Installed and working keyutils package (keyctl)
4791 - Needs CONFIG_KEYS=y in your kernel configuration
4792
4793
4794What For?
4795---------
4796
4797The current state for dm-crypt in Linux is that it is single threaded, thus
4798every dm-crypt mapping only uses a single core for crypto operations.
4799To use the full power of your many-core processor it is thus necessary to split
4800the dm-crypt device. For Linux software raid arrays the easiest segmentation is to
4801just put the dm-crypt layer below the software raid layer.
4802
4803But with a 5 disk raid5 it is a rather daunting task to input the passphrase five
4804times.
4805This is what this keyscripts solve for you.
4806
4807
4808Usage
4809-----
4810
4811Best shown by example:
4812 - 5 disks
4813 - Linux software raid5
4814
4815Layer:
4816 sda sdb sdc ... sde
4817 +-----------+ +-----------+
4818 | LUKS | | LUKS |
4819 | +-------+ | | +-------+ |
4820 | | RAID5 | | | | RAID5 | |
4821 | | ... | | | | ... | |
4822
4823Crypttab Entries:
4824
4825<target> <source> <keyfile> <options>
4826sda_crypt /dev/sda2 main_data_raid luks,keyscript=decrypt_keyctl
4827sdb_crypt /dev/sdb2 main_data_raid luks,keyscript=decrypt_keyctl
4828...
4829sde_crypt /dev/sde2 main_data_raid luks,keyscript=decrypt_keyctl
4830
4831
4832How does it work
4833----------------
4834
4835Crypttab Interface:
4836A keyscript is added to options including a keyfile definition as third
4837parameter in the crypttab file. The keyscript is called with the keyfile as the
4838first and only parameter. Additionally there are a few environment variables
4839set but currently are not used by this keyscript (man 5 crypttab for exact
4840description).
4841
4842Keyscript:
4843Keyctl_keyscript uses the Linux kernel keyring facility to securly cache
4844passphrases between multiple invocations.
4845The keyfile parameter from cryptab is used to find the same passphrase between
4846multiple invocations.
4847
4848Currently the cache timeout is 60 seconds and not configurable (please report a
4849bug if it is too low for you).
4850
4851
4852Problems
4853--------
4854
4855 - Passphrase is piped between processes and could end up in unsecured
4856 memory, thus later swapped to disk!
4857 => Use of cryptoswap recommend!
4858
4859
4860Hints
4861-----
4862
4863To remove all traces of this keyscript you may want to cleanup the keyring
4864completely with the following command afterwards:
4865 sudo keyctl clear @u
4866 Format: http://dep.debian.net/deps/dep5/
4867Upstream-Contact: Milan Broz <mbroz@redhat.com>
4868Source: http://code.google.com/p/cryptsetup
4869
4870Files: *
4871Copyright: © 2004 Christophe Saout <christophe@saout.de>
4872 © 2004-2008 Clemens Fruhwirth <clemens@endorphin.org>
4873 © 2008-2010 Milan Broz <mbroz@redhat.com>
4874License: GPL-2+
4875
4876Files: debian/*
4877Copyright: © 2004-2005 Wesley W. Terpstra <terpstra@debian.org>
4878 © 2005-2006 Michael Gebetsroither <michael.geb@gmx.at>
4879 © 2006-2008 David Härdeman <david@hardeman.nu>
4880 © 2005-2010 Jonas Meurer <jonas@freesources.org>
4881License: GPL-2+
4882
4883Files: debian/askpass.c debian/passdev.c
4884Copyright: © 2008 David Härdeman <david@hardeman.nu>
4885License: GPL-2+
4886
4887Files: debian/README.openct
4888Copyright: © 2008 Daniel Baumann <baumann@swiss-it.ch>
4889License: GPL-2+
4890
4891Files: debian/README.opensc
4892Copyright: © 2008 Benjamin Kiessling <benjaminkiessling@bttec.org>
4893License: GPL-2+
4894
4895Files: debian/README.remote
4896Copyright: © 2009 <debian@x.ray.net>
4897License: GPL-2+
4898
4899Files: debian/scripts/cryptdisks_start
4900Copyright: © 2007 Jon Dowland <jon@alcopop.org>
4901License: GPL-2+
4902
4903Files: debian/scripts/luksformat
4904Copyright: © 2005 Canonical Ltd.
4905License: GPL-2+
4906 This package is free software; you can redistribute it and/or modify
4907 it under the terms of the GNU General Public License as published by
4908 the Free Software Foundation; either version 2 of the License, or
4909 (at your option) any later version.
4910 .
4911 This package is distributed in the hope that it will be useful,
4912 but WITHOUT ANY WARRANTY; without even the implied warranty of
4913 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4914 GNU General Public License for more details.
4915 .
4916 You should have received a copy of the GNU General Public License
4917 along with this package; if not, write to the Free Software
4918 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
4919 .
4920 On Debian systems, the complete text of the GNU General Public
4921 License v2 can be found in `/usr/share/common-licenses/GPL-2'.
4922 Format: http://dep.debian.net/deps/dep5/
4923Upstream-Contact: Milan Broz <mbroz@redhat.com>
4924Source: http://code.google.com/p/cryptsetup
4925
4926Files: *
4927Copyright: © 2004 Christophe Saout <christophe@saout.de>
4928 © 2004-2008 Clemens Fruhwirth <clemens@endorphin.org>
4929 © 2008-2010 Milan Broz <mbroz@redhat.com>
4930License: GPL-2+
4931
4932Files: debian/*
4933Copyright: © 2004-2005 Wesley W. Terpstra <terpstra@debian.org>
4934 © 2005-2006 Michael Gebetsroither <michael.geb@gmx.at>
4935 © 2006-2008 David Härdeman <david@hardeman.nu>
4936 © 2005-2010 Jonas Meurer <jonas@freesources.org>
4937License: GPL-2+
4938
4939Files: debian/askpass.c debian/passdev.c
4940Copyright: © 2008 David Härdeman <david@hardeman.nu>
4941License: GPL-2+
4942
4943Files: debian/README.openct
4944Copyright: © 2008 Daniel Baumann <baumann@swiss-it.ch>
4945License: GPL-2+
4946
4947Files: debian/README.opensc
4948Copyright: © 2008 Benjamin Kiessling <benjaminkiessling@bttec.org>
4949License: GPL-2+
4950
4951Files: debian/README.remote
4952Copyright: © 2009 <debian@x.ray.net>
4953License: GPL-2+
4954
4955Files: debian/scripts/cryptdisks_start
4956Copyright: © 2007 Jon Dowland <jon@alcopop.org>
4957License: GPL-2+
4958
4959Files: debian/scripts/luksformat
4960Copyright: © 2005 Canonical Ltd.
4961License: GPL-2+
4962 This package is free software; you can redistribute it and/or modify
4963 it under the terms of the GNU General Public License as published by
4964 the Free Software Foundation; either version 2 of the License, or
4965 (at your option) any later version.
4966 .
4967 This package is distributed in the hope that it will be useful,
4968 but WITHOUT ANY WARRANTY; without even the implied warranty of
4969 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4970 GNU General Public License for more details.
4971 .
4972 You should have received a copy of the GNU General Public License
4973 along with this package; if not, write to the Free Software
4974 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
4975 .
4976 On Debian systems, the complete text of the GNU General Public
4977 License v2 can be found in `/usr/share/common-licenses/GPL-2'.
4978 CREDITS.txt - 2010-03-13
4979------------------------
4980
4981Few projects are completed by one person, and CUPS is no exception. We'd
4982like to thank the following individuals for their contributions:
4983
4984 Nathaniel Barbour - Lots of testing and feedback.
4985 N. Becker - setsid().
4986 Philippe Combes - French localization and buttons script.
4987 Jean-Eric Cuendet - GhostScript filters for CUPS.
4988 Van Dang - HTTP and IPP policeman.
4989 L. Peter Deutsch - MD5 code.
4990 Dr. ZP Han - setgid()/setuid().
4991 Guy Harris - *BSD shared libraries and lots of other
4992 fixes.
4993 Bjoern Jacke - I18N stuff.
4994 Wang Jian - CUPS RPM corrections.
4995 Roderick Johnstone - Beta tester of the millenium.
4996 Till Kamppeter - Bug fixes, beta testing, evangelism.
4997 I–aki Larra–aga - Basque localization.
4998 Kenshi Muto - Japanese localization, patches, and
4999 testing.
5000 Tomohiro Kato - Japanese localization.
5001 Kiko - Bug fixes.
5002 Sergey V. Kovalyov - ESP Print Pro and CUPS beta tester.
5003 Marek Laane - Estonian translation.
5004 Mark Lawrence - Microsoft interoperability testing.
5005 Jeff Licquia - Bug fixes, beta testing, evangelism.
5006 Jason McMullan - Original CUPS RPM distributions.
5007 Wes Morgan - *BSD fixes.
5008 Daniel Nylander - Swedish localization.
5009 Niklas 'Nille' ÂkerstrÅ¡m - Swedish localization.
5010 Giulio Orsero - Bug fixes and testing.
5011 Michal Osowiecki - Polish localization.
5012 Citra Paska - Indonesian localization.
5013 Kurt Pfeifle - Bug fixes, beta testing, evangelism.
5014 Vincenzo Reale - Italian localization.
5015 Petter Reinholdtsen - HP-UX compiler stuff.
5016 Juan Pablo Gonz‡lez Riopedre - Spanish localization.
5017 Opher Shachar - Hebrew localization.
5018 Stuart Stevens - HP JetDirect IPP information.
5019 Andrea Suatoni - IRIX desktop integration and testing.
5020 Teppo Turliainen - Finnish localization.
5021 Tim Waugh - Lots of patches, testing, and Linux
5022 integration.
5023 Yugami - LDAP browsing support.
5024
5025If I've missed someone, please let me know by sending an email to
5026"msweet@apple.com".
5027 Debian users,
5028
5029For making clear your printing problem, I need some information.
5030
50311. Please describe your CUPS version/revision. This will be written
5032 automatically if you use Debian bug system tools.
50332. Please describe Your printer vendor and model, and how to connect (usb,
5034 parallel, serial, lpd, ipp, http, socket, smb).
50353. Please attach your /etc/cups/printers.conf (only about problematic printer)
50364. Set LogLeveld as "debug" in your /etc/cups/cupsd.conf and reload by
5037 /etc/init.d/cups reload. After you do something causes a problem,
5038 please attach gzippped your /var/log/cups/error_log.
50395. Please attach gzipped PPD file in /etc/cups/ppd/.
5040
5041Before you report...
50421. If you use gs as filter, please check /usr/bin/gs indicates gs-esp.
5043 gs-gnu doesn't support some drivers. If gs indicates gs-gnu, please
5044 change by 'update-alternatives --config gs'.
50452. Please don't set severity to 'grave' or 'critical' if you couldn't success
5046 to print out. I usually test by my printer, then upload. (it means at
5047 least I can success to print out)
5048 I promise to look over your report. Please use 'important' for
5049 "I can't print out by my printer!".
5050
5051Thanks,
5052--
5053Kenshi Muto
5054kmuto@debian.org
5055
5056
5057
5058
5059
5060
5061 Sent when a successful AVRCP connection has been made
5062 to the remote device.
5063
5064 Disconnected() {deprecated}
5065
5066 Sent when the AVRCP connection to the remote device
5067 has been disconnected.
5068
5069Properties
5070
5071 boolean Connected [readonly]
5072 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5073Upstream-Name: CUPS
5074Upstream-Contact: Michael Sweet <msweet@apple.com>
5075Source: ftp://ftp.easysw.com/pub/cups/
5076
5077Files: *
5078Copyright: Copyright 2007-2011 by Apple Inc.
5079License: GPL-2 with exceptions
5080 This program is free software; you can redistribute it and/or modify
5081 it under the terms of the GNU General Public License as published by
5082 the Free Software Foundation, version 2 of the License.
5083 .
5084 The full text of the GPL is distributed as in
5085 /usr/share/common-licenses/GPL-2 on Debian systems.
5086 .
5087 In addition, as the copyright holder of CUPS, Apple Inc. grants
5088 the following special exceptions:
5089 .
5090 1. Apple Operating System Development License Exception;
5091 .
5092 a. Software that is developed by any person or entity
5093 for an Apple Operating System ("Apple OS-Developed
5094 Software"), including but not limited to Apple and
5095 third party printer drivers, filters, and backends
5096 for an Apple Operating System, that is linked to the
5097 CUPS imaging library or based on any sample filters
5098 or backends provided with CUPS shall not be
5099 considered to be a derivative work or collective work
5100 based on the CUPS program and is exempt from the
5101 mandatory source code release clauses of the GNU GPL.
5102 You may therefore distribute linked combinations of
5103 the CUPS imaging library with Apple OS-Developed
5104 Software without releasing the source code of the
5105 Apple OS-Developed Software. You may also use sample
5106 filters and backends provided with CUPS to develop
5107 Apple OS-Developed Software without releasing the
5108 source code of the Apple OS-Developed Software.
5109 .
5110 b. An Apple Operating System means any operating system
5111 software developed and/or marketed by Apple Computer,
5112 Inc., including but not limited to all existing
5113 releases and versions of Apple's Darwin, Mac OS X,
5114 and Mac OS X Server products and all follow-on
5115 releases and future versions thereof.
5116 .
5117 c. This exception is only available for Apple
5118 OS-Developed Software and does not apply to software
5119 that is distributed for use on other operating
5120 systems.
5121 .
5122 d. All CUPS software that falls under this license
5123 exception have the following text at the top of each
5124 source file:
5125 .
5126 This file is subject to the Apple OS-Developed
5127 Software exception.
5128 .
5129 2. OpenSSL Toolkit License Exception;
5130 .
5131 a. Apple Inc. explicitly allows the compilation and
5132 distribution of the CUPS software with the OpenSSL
5133 Toolkit.
5134 .
5135 No developer is required to provide these exceptions in a
5136 derived work.
5137
5138Files: cups/* filters/*
5139Copyright: Copyright 2007-2011 by Apple Inc.
5140License: LGPL-2 with exceptions
5141 This program is free software; you can redistribute it and/or modify it
5142 under the terms of the GNU Library General Public License as published
5143 by the Free Software Foundation, version 2 of the License.
5144 .
5145 The full text of the GPL is distributed as in
5146 /usr/share/common-licenses/GPL-2 on Debian systems.
5147 .
5148 The same exceptions as above apply.
5149 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5150Upstream-Name: CUPS
5151Upstream-Contact: Michael Sweet <msweet@apple.com>
5152Source: ftp://ftp.easysw.com/pub/cups/
5153
5154Files: *
5155Copyright: Copyright 2007-2011 by Apple Inc.
5156License: GPL-2 with exceptions
5157 This program is free software; you can redistribute it and/or modify
5158 it under the terms of the GNU General Public License as published by
5159 the Free Software Foundation, version 2 of the License.
5160 .
5161 The full text of the GPL is distributed as in
5162 /usr/share/common-licenses/GPL-2 on Debian systems.
5163 .
5164 In addition, as the copyright holder of CUPS, Apple Inc. grants
5165 the following special exceptions:
5166 .
5167 1. Apple Operating System Development License Exception;
5168 .
5169 a. Software that is developed by any person or entity
5170 for an Apple Operating System ("Apple OS-Developed
5171 Software"), including but not limited to Apple and
5172 third party printer drivers, filters, and backends
5173 for an Apple Operating System, that is linked to the
5174 CUPS imaging library or based on any sample filters
5175 or backends provided with CUPS shall not be
5176 considered to be a derivative work or collective work
5177 based on the CUPS program and is exempt from the
5178 mandatory source code release clauses of the GNU GPL.
5179 You may therefore distribute linked combinations of
5180 the CUPS imaging library with Apple OS-Developed
5181 Software without releasing the source code of the
5182 Apple OS-Developed Software. You may also use sample
5183 filters and backends provided with CUPS to develop
5184 Apple OS-Developed Software without releasing the
5185 source code of the Apple OS-Developed Software.
5186 .
5187 b. An Apple Operating System means any operating system
5188 software developed and/or marketed by Apple Computer,
5189 Inc., including but not limited to all existing
5190 releases and versions of Apple's Darwin, Mac OS X,
5191 and Mac OS X Server products and all follow-on
5192 releases and future versions thereof.
5193 .
5194 c. This exception is only available for Apple
5195 OS-Developed Software and does not apply to software
5196 that is distributed for use on other operating
5197 systems.
5198 .
5199 d. All CUPS software that falls under this license
5200 exception have the following text at the top of each
5201 source file:
5202 .
5203 This file is subject to the Apple OS-Developed
5204 Software exception.
5205 .
5206 2. OpenSSL Toolkit License Exception;
5207 .
5208 a. Apple Inc. explicitly allows the compilation and
5209 distribution of the CUPS software with the OpenSSL
5210 Toolkit.
5211 .
5212 No developer is required to provide these exceptions in a
5213 derived work.
5214
5215Files: cups/* filters/*
5216Copyright: Copyright 2007-2011 by Apple Inc.
5217License: LGPL-2 with exceptions
5218 This program is free software; you can redistribute it and/or modify it
5219 under the terms of the GNU Library General Public License as published
5220 by the Free Software Foundation, version 2 of the License.
5221 .
5222 The full text of the GPL is distributed as in
5223 /usr/share/common-licenses/GPL-2 on Debian systems.
5224 .
5225 The same exceptions as above apply.
5226 Till Kamppeter, OpenPrinting/Canonical (till.kamppeter@gmail.com)
5227Michael Sweet, Apple (msweet@apple.com)
5228Koji Otani, BBR Inc. (sho@bbr.jp)
5229Tobias Hoffmann (th55@gmx.de)
5230Lars Uebernickel, Canonical (lars@uebernic.de)
5231Robert Sander (robert.sander@epigenomics.com)
5232Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5233Upstream-Name: CUPS
5234Upstream-Contact: Michael Sweet <msweet@apple.com>
5235Source: ftp://ftp.easysw.com/pub/cups/
5236
5237Files: *
5238Copyright: Copyright 2007-2011 by Apple Inc.
5239License: GPL-2 with exceptions
5240 This program is free software; you can redistribute it and/or modify
5241 it under the terms of the GNU General Public License as published by
5242 the Free Software Foundation, version 2 of the License.
5243 .
5244 The full text of the GPL is distributed as in
5245 /usr/share/common-licenses/GPL-2 on Debian systems.
5246 .
5247 In addition, as the copyright holder of CUPS, Apple Inc. grants
5248 the following special exceptions:
5249 .
5250 1. Apple Operating System Development License Exception;
5251 .
5252 a. Software that is developed by any person or entity
5253 for an Apple Operating System ("Apple OS-Developed
5254 Software"), including but not limited to Apple and
5255 third party printer drivers, filters, and backends
5256 for an Apple Operating System, that is linked to the
5257 CUPS imaging library or based on any sample filters
5258 or backends provided with CUPS shall not be
5259 considered to be a derivative work or collective work
5260 based on the CUPS program and is exempt from the
5261 mandatory source code release clauses of the GNU GPL.
5262 You may therefore distribute linked combinations of
5263 the CUPS imaging library with Apple OS-Developed
5264 Software without releasing the source code of the
5265 Apple OS-Developed Software. You may also use sample
5266 filters and backends provided with CUPS to develop
5267 Apple OS-Developed Software without releasing the
5268 source code of the Apple OS-Developed Software.
5269 .
5270 b. An Apple Operating System means any operating system
5271 software developed and/or marketed by Apple Computer,
5272 Inc., including but not limited to all existing
5273 releases and versions of Apple's Darwin, Mac OS X,
5274 and Mac OS X Server products and all follow-on
5275 releases and future versions thereof.
5276 .
5277 c. This exception is only available for Apple
5278 OS-Developed Software and does not apply to software
5279 that is distributed for use on other operating
5280 systems.
5281 .
5282 d. All CUPS software that falls under this license
5283 exception have the following text at the top of each
5284 source file:
5285 .
5286 This file is subject to the Apple OS-Developed
5287 Software exception.
5288 .
5289 2. OpenSSL Toolkit License Exception;
5290 .
5291 a. Apple Inc. explicitly allows the compilation and
5292 distribution of the CUPS software with the OpenSSL
5293 Toolkit.
5294 .
5295 No developer is required to provide these exceptions in a
5296 derived work.
5297
5298Files: cups/* filters/*
5299Copyright: Copyright 2007-2011 by Apple Inc.
5300License: LGPL-2 with exceptions
5301 This program is free software; you can redistribute it and/or modify it
5302 under the terms of the GNU Library General Public License as published
5303 by the Free Software Foundation, version 2 of the License.
5304 .
5305 The full text of the GPL is distributed as in
5306 /usr/share/common-licenses/GPL-2 on Debian systems.
5307 .
5308 The same exceptions as above apply.
5309 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5310Upstream-Name: cups-filters
5311Upstream-Contact: OpenPrinting <printing-architecture@lists.linux-foundation.org>
5312Source: http://www.openprinting.org/download/cups-filters/
5313
5314Files: AUTHORS.txt
5315 CHANGES.txt
5316 acloacl.m4
5317 configure
5318 install-sh
5319 debian/*
5320Copyright: 2012, Till Kamppeter <till.kamppeter@gmail.com>
5321License: GPL-2+
5322
5323Files: debian/local/textonly* debian/local/text.convs
5324Copyright: 2003-2006 Red Hat, Inc.
5325 2003-2006 Tim Waugh <twaugh@redhat.com>
5326License: GPL-2
5327
5328Files: config.h.in
5329 configure.in
5330 INSTALL.txt
5331 LICENSE.txt
5332 README.txt
5333 Makedefs.in
5334 Makefile
5335 backend/*
5336 config-scripts/*
5337 scripting/*
5338 filter/commandtoescpx.c
5339 filter/commandtopclx.c
5340 filter/common.c
5341 filter/common.h
5342 filter/cupsfilters.convs
5343 filter/cupsfilters.types
5344 filter/Dependencies
5345 filter/escp.h
5346 filter/imagetoraster.c
5347 filter/Makefile
5348 filter/pcl-common.c
5349 filter/pcl-common.h
5350 filter/pcl.h
5351 filter/pdftops.c
5352 filter/pdfutils.c
5353 filter/pdfutils.h
5354 filter/rastertoescpx.c
5355 filter/rastertopclx.c
5356 filter/textcommon.c
5357 filter/textcommon.h
5358Copyright: 2007-2011, Apple Inc.
5359 1997-2007, Easy Software Products.
5360License: GPL-2
5361
5362Files: cupsfilters/*
5363Copyright: 2007-2011, Apple Inc.
5364 1997-2007, Easy Software Products.
5365License: LGPL-2
5366
5367Files: filter/fontembed/*
5368 filter/pdf.utf-8.heavy
5369 filter/pdf.utf-8.simple
5370 filter/pdfutils.c
5371 filter/pdfutils.h
5372 filter/test_pdf1.c
5373 filter/test_pdf2.c
5374 filter/texttopdf.c
5375Copyright: 2008, Tobias Hoffmann.
5376 2007, Apple Inc.
5377 1993-2007, Easy Software Products.
5378License: GPL-2
5379
5380Files: filter/pstopdf.in
5381Copyright: 2003, Robert Sander <robert.sander@epigenomics.com>
5382 2008-2012, Till Kamppeter <till.kamppeter@gmail.com>
5383License: GPL-2
5384
5385Files: filter/imagetopdf.c
5386Copyright: 1993-2006, Easy Software Products.
5387 2006-2007, BBR Inc.
5388License: GPL-2
5389
5390Files: filter/banner.c
5391 filter/banner.h
5392 filter/bannertopdf.c
5393 filter/classified
5394 filter/confidential
5395 filter/default.pdf
5396 filter/default-testpage.pdf
5397 filter/pdf.cxx
5398 filter/pdf.h
5399 filter/secret
5400 filter/standard
5401 filter/testprint
5402 filter/topsecret
5403 filter/unclassified
5404Copyright: 2012, Canonical Ltd.
5405License: GPL-3
5406
5407Files: pdftoopvp/*
5408 pdftopdf/*
5409 filter/pdftoraster.cxx
5410 ppd/HP-PhotoSmart_Pro_B8300-hpijs-pdftoijs.ppd
5411Copyright: Copyright 2006-2011, BBR Inc. All rights reserved.
5412License: Expat
5413
5414Files: filter/pdftoijs.cxx
5415Copyright: 2008, BBR Inc. All rights reserved.
5416 2008, Tobias Hoffmann
5417License: Expat
5418
5419License: GPL-2
5420 This program may be distributed and/or modified under the terms of the
5421 version 2 of the GNU General Public License as published by the Free
5422 Software Foundation (the "GPL").
5423 .
5424 When distributed under the terms of the GPL, this program is
5425 distributed in the hope that it will be useful, but WITHOUT ANY
5426 WARRANTY; without even the implied warranty of MERCHANTABILITY or
5427 FITNESS FOR A PARTICULAR PURPOSE. See the GPL for more details.
5428 .
5429 On Debian systems the GNU General Public License (GPL) version 2 is
5430 located in '/usr/share/common-licenses/GPL-2'.
5431 .
5432 You should have received a copy of the GNU General Public License along
5433 with this program. If not, see <http://www.gnu.org/licenses/>.
5434
5435License: GPL-2+
5436 This program may be distributed and/or modified under the terms of the
5437 GNU General Public License as published by the Free Software Foundation
5438 (the "GPL"); either version 2 of the GPL, or (at your option) any later
5439 version.
5440 .
5441 When distributed under the terms of the GPL, this program is
5442 distributed in the hope that it will be useful, but WITHOUT ANY
5443 WARRANTY; without even the implied warranty of MERCHANTABILITY or
5444 FITNESS FOR A PARTICULAR PURPOSE. See the GPL for more details.
5445 .
5446 On Debian systems the GNU General Public License (GPL) version 2 is
5447 located in '/usr/share/common-licenses/GPL-2'.
5448 .
5449 You should have received a copy of the GNU General Public License along
5450 with this program. If not, see <http://www.gnu.org/licenses/>.
5451
5452License: GPL-3
5453 This program may be distributed and/or modified under the terms of the
5454 version 3 of the GNU General Public License as published by the Free
5455 Software Foundation (the "GPL").
5456 .
5457 When distributed under the terms of the GPL, this program is
5458 distributed in the hope that it will be useful, but WITHOUT ANY
5459 WARRANTY; without even the implied warranty of MERCHANTABILITY or
5460 FITNESS FOR A PARTICULAR PURPOSE. See the GPL for more details.
5461 .
5462 On Debian systems the GNU General Public License (GPL) version 2 is
5463 located in '/usr/share/common-licenses/GPL-3'.
5464 .
5465 You should have received a copy of the GNU General Public License along
5466 with this program. If not, see <http://www.gnu.org/licenses/>.
5467
5468License: LGPL-2
5469 The libcupsfilters library is provided under the terms of version 2 of
5470 the GNU Library General Public License. This program is distributed in
5471 the hope that it will be useful, but WITHOUT ANY WARRANTY; without
5472 even the implied warranty of MERCHANTABILITY or FITNESS FOR A
5473 PARTICULAR PURPOSE.
5474 .
5475 On Debian systems the GNU Library General Public License (GPL) version 2 is
5476 located in '/usr/share/common-licenses/LGPL-2'.
5477 .
5478 You should have received a copy of the GNU Library General Public License along
5479 with this program. If not, see <http://www.gnu.org/licenses/>.
5480
5481License: Expat
5482 Permission is hereby granted, free of charge, to any person obtaining
5483 a copy of this software and associated documentation files (the
5484 "Software"), to deal in the Software without restriction, including
5485 without limitation the rights to use, copy, modify, merge, publish,
5486 distribute, sublicense, and/or sell copies of the Software, and to
5487 permit persons to whom the Software is furnished to do so, subject to
5488 the following conditions:
5489 .
5490 The above copyright notice and this permission notice shall be
5491 included in all copies or substantial portions of the Software.
5492 .
5493 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
5494 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
5495 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
5496 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
5497 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
5498 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
5499 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
5500 Building with the diet libc
5501---------------------------
5502
5503This package optionally can be built with the diet libc instead of the
5504glibc to provide small statically linked programs. The resulting package
5505has no dependency on any other package.
5506
5507To use the diet libc, make sure the latest versions of the dietlibc-dev
5508package is installed, and set DEB_BUILD_OPTIONS=diet in the environment
5509when building the package, e.g.:
5510
5511 # apt-get install dietlibc-dev
5512 $ DEB_BUILD_OPTIONS=diet fakeroot apt-get source -b dash
5513
5514 -- Gerrit Pape <pape@smarden.org>, Wed, 23 Jun 2004 05:11:20 +0000
5515 Dash sources for Debian
5516-----------------------
5517
5518The dash Debian package sources are available through git, and
5519through 'apt-get source dash'. Getting the sources through git
5520should be preferred:
5521
5522 # apt-get install git # if not yet done
5523
5524 $ git clone http://smarden.org/git/dash.git/
5525 $ cd dash
5526
5527After cloning the repository, you have checked out the debian-sid
5528branch, ready to be used by dpkg-buildpackage, e.g.
5529
5530 $ dpkg-buildpackage -i -rfakeroot -uc -us
5531
5532If you want to make changes in the ./debian/ subdirectory, this is the
5533correct branch to work on. After making changes, document them in
5534debian/changelog, and commit through 'git add' and 'git commit', or 'git
5535commit -a', or similar. If you think the changes should be incorporated
5536into the standard Debian package, create the patch[es] through 'git
5537format-patch', and send them to the Debian Bug Tracking System, e.g.
5538
5539 $ vi debian/rules
5540 $ debchange -pi
5541 $ git commit -a
5542 $ git format-patch HEAD^
5543
5544
5545If you want to make changes to the upstream dash sources, first checkout
5546the release+patches branch
5547
5548 $ git checkout -b release+patches origin/release+patches
5549
5550The release+patches branch holds patches on top of the current release
5551version that is packaged for Debian/unstable. The current release
5552version is available in the release branch. If you are interested, you
5553can checkout this branch too
5554
5555 $ git checkout -b release origin/release
5556
5557When releasing a new Debian package based on a new upstream release, the
5558release branch will be fastforwarded, and the release+patches branch is
5559rewound and rebased onto the new HEAD of the release branch. This is
5560done by, e.g.
5561
5562 $ git checkout release
5563 $ git merge v0.5.5
5564 $ git checkout release+patches
5565 $ git rebase release
5566
5567You generally don't need to do that, but beware that the release+patches
5568branch is rewound occasionally.
5569
5570After checking out the release+patches branch, make the desired changes
5571to the upstream sources, and commit them. To integrate the changes into
5572the Debian package, extract these changes, and change to the debian-sid
5573branch (Note: the file extension for the patches is '.diff', use 'git
5574config --add format.suffix .diff' to make that the default)
5575
5576 $ git format-patch release..release+patches
5577 $ git checkout debian-sid
5578
5579Now move the extracted patches into the debian/diff/ directory, add a
5580meaningful message to debian/changelog, and commit the changes to the
5581debian-sid branch
5582
5583 $ mv ????-*.diff debian/diff/
5584 $ git add debian/diff
5585 $ debchange -pi
5586 $ git add debian/changelog
5587 $ git commit
5588
5589Again, if you think the changes should be incorporated into the standard
5590Debian package, create the patch[es] from the debian-sid branch through
5591'git format-patch', send them to the Debian Bug Tracking System.
5592
5593There's a mailing list to coordinate work on the dash packages, if
5594you're interested in helping please subscribe to the
5595<debian-package-dash> mailing list by sending an email to
5596<debian-package-dash-subscribe@list.smarden.org>.
5597
5598 -- Gerrit Pape <pape@smarden.org> Fri, 04 Jun 2010 00:22:12 +0000
5599
5600 This package was debianized by Mark W. Eichin eichin@kitten.gen.ma.us on
5601Mon, 24 Feb 1997 16:00:16 -0500.
5602
5603This package was re-ported from NetBSD and debianized by
5604Herbert Xu herbert@debian.org on Thu, 19 Jun 1997 19:29:16 +1000.
5605
5606This package was adopted by Gerrit Pape <pape@smarden.org> on
5607Fri, 28 May 2004 18:38:18 +0000.
5608
5609It was downloaded from http://gondor.apana.org.au/~herbert/dash/files/
5610
5611Copyright:
5612
5613Copyright (c) 1989-1994
5614 The Regents of the University of California. All rights reserved.
5615Copyright (c) 1997 Christos Zoulas. All rights reserved.
5616Copyright (c) 1997-2005
5617 Herbert Xu <herbert@gondor.apana.org.au>. All rights reserved.
5618
5619This code is derived from software contributed to Berkeley by Kenneth Almquist.
5620
5621
5622Redistribution and use in source and binary forms, with or without
5623modification, are permitted provided that the following conditions
5624are met:
56251. Redistributions of source code must retain the above copyright
5626 notice, this list of conditions and the following disclaimer.
56272. Redistributions in binary form must reproduce the above copyright
5628 notice, this list of conditions and the following disclaimer in the
5629 documentation and/or other materials provided with the distribution.
56303. Neither the name of the University nor the names of its contributors
5631 may be used to endorse or promote products derived from this software
5632 without specific prior written permission.
5633
5634THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
5635ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
5636IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
5637ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
5638FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
5639DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
5640OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
5641HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
5642LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
5643OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
5644SUCH DAMAGE.
5645
5646mksignames.c:
5647
5648This file is not directly linked with dash. However, its output is.
5649
5650Copyright (C) 1992 Free Software Foundation, Inc.
5651
5652This file is part of GNU Bash, the Bourne Again SHell.
5653
5654Bash is free software; you can redistribute it and/or modify it under
5655the terms of the GNU General Public License as published by the Free
5656Software Foundation; either version 2, or (at your option) any later
5657version.
5658
5659Bash is distributed in the hope that it will be useful, but WITHOUT ANY
5660WARRANTY; without even the implied warranty of MERCHANTABILITY or
5661FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
5662for more details.
5663
5664You should have received a copy of the GNU General Public License with
5665your Debian GNU/Linux system, in /usr/share/common-licenses/GPL, or with the
5666Debian GNU/Linux hello source package as the file COPYING. If not,
5667write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
5668Boston, MA 02111 USA.
5669
5670 This package was debianized by Colin Walters <walters@debian.org> on
5671Thu, 6 Mar 2003 18:01:37 -0500
5672
5673It was downloaded from http://www.freedesktop.org/software/dbus
5674
5675This package is dual-licensed under the Academic Free License version 2.1,
5676and the GPL version 2. For a description of the GPL, see
5677/usr/share/common-licenses/GPL-2 on your Debian system.
5678
5679Portions of the package are only licensed under the GPL (notably
5680tools/dbus-cleanup-sockets.c and test/decode-gcov.c ).
5681
5682The Academic Free License follows:
5683
5684The Academic Free License
5685v. 2.1
5686
5687This Academic Free License (the "License") applies to any original
5688work of authorship (the "Original Work") whose owner (the "Licensor")
5689has placed the following notice immediately following the copyright
5690notice for the Original Work:
5691
5692Licensed under the Academic Free License version 2.1
5693
56941) Grant of Copyright License. Licensor hereby grants You a
5695world-wide, royalty-free, non-exclusive, perpetual, sublicenseable
5696license to do the following:
5697
5698a) to reproduce the Original Work in copies;
5699
5700b) to prepare derivative works ("Derivative Works") based upon the Original Work;
5701
5702c) to distribute copies of the Original Work and Derivative Works to the public;
5703
5704d) to perform the Original Work publicly; and
5705
5706e) to display the Original Work publicly.
5707
57082) Grant of Patent License. Licensor hereby grants You a world-wide,
5709royalty-free, non-exclusive, perpetual, sublicenseable license, under
5710patent claims owned or controlled by the Licensor that are embodied in
5711the Original Work as furnished by the Licensor, to make, use, sell and
5712offer for sale the Original Work and Derivative Works.
5713
57143) Grant of Source Code License. The term "Source Code" means the
5715preferred form of the Original Work for making modifications to it and
5716all available documentation describing how to modify the Original
5717Work. Licensor hereby agrees to provide a machine-readable copy of the
5718Source Code of the Original Work along with each copy of the Original
5719Work that Licensor distributes. Licensor reserves the right to satisfy
5720this obligation by placing a machine-readable copy of the Source Code
5721in an information repository reasonably calculated to permit
5722inexpensive and convenient access by You for as long as Licensor
5723continues to distribute the Original Work, and by publishing the
5724address of that information repository in a notice immediately
5725following the copyright notice that applies to the Original Work.
5726
57274) Exclusions From License Grant. Neither the names of Licensor, nor
5728the names of any contributors to the Original Work, nor any of their
5729trademarks or service marks, may be used to endorse or promote
5730products derived from this Original Work without express prior written
5731permission of the Licensor. Nothing in this License shall be deemed to
5732grant any rights to trademarks, copyrights, patents, trade secrets or
5733any other intellectual property of Licensor except as expressly stated
5734herein. No patent license is granted to make, use, sell or offer to
5735sell embodiments of any patent claims other than the licensed claims
5736defined in Section 2. No right is granted to the trademarks of
5737Licensor even if such marks are included in the Original Work. Nothing
5738in this License shall be interpreted to prohibit Licensor from
5739licensing under different terms from this License any Original Work
5740that Licensor otherwise would have a right to license.
5741
57425) This section intentionally omitted.
5743
57446) Attribution Rights. You must retain, in the Source Code of any
5745Derivative Works that You create, all copyright, patent or trademark
5746notices from the Source Code of the Original Work, as well as any
5747notices of licensing and any descriptive text identified therein as an
5748"Attribution Notice." You must cause the Source Code for any
5749Derivative Works that You create to carry a prominent Attribution
5750Notice reasonably calculated to inform recipients that You have
5751modified the Original Work.
5752
57537) Warranty of Provenance and Disclaimer of Warranty. Licensor
5754warrants that the copyright in and to the Original Work and the patent
5755rights granted herein by Licensor are owned by the Licensor or are
5756sublicensed to You under the terms of this License with the permission
5757of the contributor(s) of those copyrights and patent rights. Except as
5758expressly stated in the immediately proceeding sentence, the Original
5759Work is provided under this License on an "AS IS" BASIS and WITHOUT
5760WARRANTY, either express or implied, including, without limitation,
5761the warranties of NON-INFRINGEMENT, MERCHANTABILITY or FITNESS FOR A
5762PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY OF THE ORIGINAL
5763WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an essential
5764part of this License. No license to Original Work is granted hereunder
5765except under this disclaimer.
5766
57678) Limitation of Liability. Under no circumstances and under no legal
5768theory, whether in tort (including negligence), contract, or
5769otherwise, shall the Licensor be liable to any person for any direct,
5770indirect, special, incidental, or consequential damages of any
5771character arising as a result of this License or the use of the
5772Original Work including, without limitation, damages for loss of
5773goodwill, work stoppage, computer failure or malfunction, or any and
5774all other commercial damages or losses. This limitation of liability
5775shall not apply to liability for death or personal injury resulting
5776from Licensor's negligence to the extent applicable law prohibits such
5777limitation. Some jurisdictions do not allow the exclusion or
5778limitation of incidental or consequential damages, so this exclusion
5779and limitation may not apply to You.
5780
57819) Acceptance and Termination. If You distribute copies of the
5782Original Work or a Derivative Work, You must make a reasonable effort
5783under the circumstances to obtain the express assent of recipients to
5784the terms of this License. Nothing else but this License (or another
5785written agreement between Licensor and You) grants You permission to
5786create Derivative Works based upon the Original Work or to exercise
5787any of the rights granted in Section 1 herein, and any attempt to do
5788so except under the terms of this License (or another written
5789agreement between Licensor and You) is expressly prohibited by
5790U.S. copyright law, the equivalent laws of other countries, and by
5791international treaty. Therefore, by exercising any of the rights
5792granted to You in Section 1 herein, You indicate Your acceptance of
5793this License and all of its terms and conditions.
5794
579510) Termination for Patent Action. This License shall terminate
5796automatically and You may no longer exercise any of the rights granted
5797to You by this License as of the date You commence an action,
5798including a cross-claim or counterclaim, against Licensor or any
5799licensee alleging that the Original Work infringes a patent. This
5800termination provision shall not apply for an action alleging patent
5801infringement by combinations of the Original Work with other software
5802or hardware.
5803
580411) Jurisdiction, Venue and Governing Law. Any action or suit relating
5805to this License may be brought only in the courts of a jurisdiction
5806wherein the Licensor resides or in which Licensor conducts its primary
5807business, and under the laws of that jurisdiction excluding its
5808conflict-of-law provisions. The application of the United Nations
5809Convention on Contracts for the International Sale of Goods is
5810expressly excluded. Any use of the Original Work outside the scope of
5811this License or after its termination shall be subject to the
5812requirements and penalties of the U.S. Copyright Act, 17 U.S.C. § 101
5813et seq., the equivalent laws of other countries, and international
5814treaty. This section shall survive the termination of this License.
5815
581612) Attorneys Fees. In any action to enforce the terms of this License
5817or seeking damages relating thereto, the prevailing party shall be
5818entitled to recover its costs and expenses, including, without
5819limitation, reasonable attorneys' fees and costs incurred in
5820connection with such action, including any appeal of such action. This
5821section shall survive the termination of this License.
5822
582313) Miscellaneous. This License represents the complete agreement
5824concerning the subject matter hereof. If any provision of this License
5825is held to be unenforceable, such provision shall be reformed only to
5826the extent necessary to make it enforceable.
5827
582814) Definition of "You" in This License. "You" throughout this
5829License, whether in upper or lower case, means an individual or a
5830legal entity exercising rights under, and complying with all of the
5831terms of, this License. For legal entities, "You" includes any entity
5832that controls, is controlled by, or is under common control with
5833you. For purposes of this definition, "control" means (i) the power,
5834direct or indirect, to cause the direction or management of such
5835entity, whether by contract or otherwise, or (ii) ownership of fifty
5836percent (50%) or more of the outstanding shares, or (iii) beneficial
5837ownership of such entity.
5838
583915) Right to Use. You may use the Original Work in all ways not
5840otherwise restricted or conditioned by this License or by law, and
5841Licensor promises not to interfere with or be responsible for such
5842uses by You.
5843
5844This license is Copyright (C) 2003-2004 Lawrence E. Rosen. All rights
5845reserved. Permission is hereby granted to copy and distribute this
5846license without modification. This license may not be modified without
5847the express written permission of its copyright owner.
5848
5849
5850--
5851END OF ACADEMIC FREE LICENSE. The following is intended to describe the essential
5852differences between the Academic Free License (AFL) version 1.0 and other
5853open source licenses:
5854
5855The Academic Free License is similar to the BSD, MIT, UoI/NCSA and Apache
5856licenses in many respects but it is intended to solve a few problems with
5857those licenses.
5858
5859* The AFL is written so as to make it clear what software is being
5860licensed (by the inclusion of a statement following the copyright notice
5861in the software). This way, the license functions better than a template
5862license. The BSD, MIT and UoI/NCSA licenses apply to unidentified software.
5863
5864* The AFL contains a complete copyright grant to the software. The BSD
5865and Apache licenses are vague and incomplete in that respect.
5866
5867* The AFL contains a complete patent grant to the software. The BSD, MIT,
5868UoI/NCSA and Apache licenses rely on an implied patent license and contain
5869no explicit patent grant.
5870
5871* The AFL makes it clear that no trademark rights are granted to the
5872licensor's trademarks. The Apache license contains such a provision, but the
5873BSD, MIT and UoI/NCSA licenses do not.
5874
5875* The AFL includes the warranty by the licensor that it either owns the
5876copyright or that it is distributing the software under a license. None of
5877the other licenses contain that warranty. All other warranties are disclaimed,
5878as is the case for the other licenses.
5879
5880* The AFL is itself copyrighted (with the right granted to copy and distribute
5881without modification). This ensures that the owner of the copyright to the
5882license will control changes. The Apache license contains a copyright notice,
5883but the BSD, MIT and UoI/NCSA licenses do not.
5884 This package was debianized by Colin Walters <walters@debian.org> on
5885Thu, 6 Mar 2003 18:01:37 -0500
5886
5887It was downloaded from http://www.freedesktop.org/software/dbus
5888
5889This package is dual-licensed under the Academic Free License version 2.1,
5890and the GPL version 2. For a description of the GPL, see
5891/usr/share/common-licenses/GPL-2 on your Debian system.
5892
5893Portions of the package are only licensed under the GPL (notably
5894tools/dbus-cleanup-sockets.c and test/decode-gcov.c ).
5895
5896The Academic Free License follows:
5897
5898The Academic Free License
5899v. 2.1
5900
5901This Academic Free License (the "License") applies to any original
5902work of authorship (the "Original Work") whose owner (the "Licensor")
5903has placed the following notice immediately following the copyright
5904notice for the Original Work:
5905
5906Licensed under the Academic Free License version 2.1
5907
59081) Grant of Copyright License. Licensor hereby grants You a
5909world-wide, royalty-free, non-exclusive, perpetual, sublicenseable
5910license to do the following:
5911
5912a) to reproduce the Original Work in copies;
5913
5914b) to prepare derivative works ("Derivative Works") based upon the Original Work;
5915
5916c) to distribute copies of the Original Work and Derivative Works to the public;
5917
5918d) to perform the Original Work publicly; and
5919
5920e) to display the Original Work publicly.
5921
59222) Grant of Patent License. Licensor hereby grants You a world-wide,
5923royalty-free, non-exclusive, perpetual, sublicenseable license, under
5924patent claims owned or controlled by the Licensor that are embodied in
5925the Original Work as furnished by the Licensor, to make, use, sell and
5926offer for sale the Original Work and Derivative Works.
5927
59283) Grant of Source Code License. The term "Source Code" means the
5929preferred form of the Original Work for making modifications to it and
5930all available documentation describing how to modify the Original
5931Work. Licensor hereby agrees to provide a machine-readable copy of the
5932Source Code of the Original Work along with each copy of the Original
5933Work that Licensor distributes. Licensor reserves the right to satisfy
5934this obligation by placing a machine-readable copy of the Source Code
5935in an information repository reasonably calculated to permit
5936inexpensive and convenient access by You for as long as Licensor
5937continues to distribute the Original Work, and by publishing the
5938address of that information repository in a notice immediately
5939following the copyright notice that applies to the Original Work.
5940
59414) Exclusions From License Grant. Neither the names of Licensor, nor
5942the names of any contributors to the Original Work, nor any of their
5943trademarks or service marks, may be used to endorse or promote
5944products derived from this Original Work without express prior written
5945permission of the Licensor. Nothing in this License shall be deemed to
5946grant any rights to trademarks, copyrights, patents, trade secrets or
5947any other intellectual property of Licensor except as expressly stated
5948herein. No patent license is granted to make, use, sell or offer to
5949sell embodiments of any patent claims other than the licensed claims
5950defined in Section 2. No right is granted to the trademarks of
5951Licensor even if such marks are included in the Original Work. Nothing
5952in this License shall be interpreted to prohibit Licensor from
5953licensing under different terms from this License any Original Work
5954that Licensor otherwise would have a right to license.
5955
59565) This section intentionally omitted.
5957
59586) Attribution Rights. You must retain, in the Source Code of any
5959Derivative Works that You create, all copyright, patent or trademark
5960notices from the Source Code of the Original Work, as well as any
5961notices of licensing and any descriptive text identified therein as an
5962"Attribution Notice." You must cause the Source Code for any
5963Derivative Works that You create to carry a prominent Attribution
5964Notice reasonably calculated to inform recipients that You have
5965modified the Original Work.
5966
59677) Warranty of Provenance and Disclaimer of Warranty. Licensor
5968warrants that the copyright in and to the Original Work and the patent
5969rights granted herein by Licensor are owned by the Licensor or are
5970sublicensed to You under the terms of this License with the permission
5971of the contributor(s) of those copyrights and patent rights. Except as
5972expressly stated in the immediately proceeding sentence, the Original
5973Work is provided under this License on an "AS IS" BASIS and WITHOUT
5974WARRANTY, either express or implied, including, without limitation,
5975the warranties of NON-INFRINGEMENT, MERCHANTABILITY or FITNESS FOR A
5976PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY OF THE ORIGINAL
5977WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an essential
5978part of this License. No license to Original Work is granted hereunder
5979except under this disclaimer.
5980
59818) Limitation of Liability. Under no circumstances and under no legal
5982theory, whether in tort (including negligence), contract, or
5983otherwise, shall the Licensor be liable to any person for any direct,
5984indirect, special, incidental, or consequential damages of any
5985character arising as a result of this License or the use of the
5986Original Work including, without limitation, damages for loss of
5987goodwill, work stoppage, computer failure or malfunction, or any and
5988all other commercial damages or losses. This limitation of liability
5989shall not apply to liability for death or personal injury resulting
5990from Licensor's negligence to the extent applicable law prohibits such
5991limitation. Some jurisdictions do not allow the exclusion or
5992limitation of incidental or consequential damages, so this exclusion
5993and limitation may not apply to You.
5994
59959) Acceptance and Termination. If You distribute copies of the
5996Original Work or a Derivative Work, You must make a reasonable effort
5997under the circumstances to obtain the express assent of recipients to
5998the terms of this License. Nothing else but this License (or another
5999written agreement between Licensor and You) grants You permission to
6000create Derivative Works based upon the Original Work or to exercise
6001any of the rights granted in Section 1 herein, and any attempt to do
6002so except under the terms of this License (or another written
6003agreement between Licensor and You) is expressly prohibited by
6004U.S. copyright law, the equivalent laws of other countries, and by
6005international treaty. Therefore, by exercising any of the rights
6006granted to You in Section 1 herein, You indicate Your acceptance of
6007this License and all of its terms and conditions.
6008
600910) Termination for Patent Action. This License shall terminate
6010automatically and You may no longer exercise any of the rights granted
6011to You by this License as of the date You commence an action,
6012including a cross-claim or counterclaim, against Licensor or any
6013licensee alleging that the Original Work infringes a patent. This
6014termination provision shall not apply for an action alleging patent
6015infringement by combinations of the Original Work with other software
6016or hardware.
6017
601811) Jurisdiction, Venue and Governing Law. Any action or suit relating
6019to this License may be brought only in the courts of a jurisdiction
6020wherein the Licensor resides or in which Licensor conducts its primary
6021business, and under the laws of that jurisdiction excluding its
6022conflict-of-law provisions. The application of the United Nations
6023Convention on Contracts for the International Sale of Goods is
6024expressly excluded. Any use of the Original Work outside the scope of
6025this License or after its termination shall be subject to the
6026requirements and penalties of the U.S. Copyright Act, 17 U.S.C. § 101
6027et seq., the equivalent laws of other countries, and international
6028treaty. This section shall survive the termination of this License.
6029
603012) Attorneys Fees. In any action to enforce the terms of this License
6031or seeking damages relating thereto, the prevailing party shall be
6032entitled to recover its costs and expenses, including, without
6033limitation, reasonable attorneys' fees and costs incurred in
6034connection with such action, including any appeal of such action. This
6035section shall survive the termination of this License.
6036
603713) Miscellaneous. This License represents the complete agreement
6038concerning the subject matter hereof. If any provision of this License
6039is held to be unenforceable, such provision shall be reformed only to
6040the extent necessary to make it enforceable.
6041
604214) Definition of "You" in This License. "You" throughout this
6043License, whether in upper or lower case, means an individual or a
6044legal entity exercising rights under, and complying with all of the
6045terms of, this License. For legal entities, "You" includes any entity
6046that controls, is controlled by, or is under common control with
6047you. For purposes of this definition, "control" means (i) the power,
6048direct or indirect, to cause the direction or management of such
6049entity, whether by contract or otherwise, or (ii) ownership of fifty
6050percent (50%) or more of the outstanding shares, or (iii) beneficial
6051ownership of such entity.
6052
605315) Right to Use. You may use the Original Work in all ways not
6054otherwise restricted or conditioned by this License or by law, and
6055Licensor promises not to interfere with or be responsible for such
6056uses by You.
6057
6058This license is Copyright (C) 2003-2004 Lawrence E. Rosen. All rights
6059reserved. Permission is hereby granted to copy and distribute this
6060license without modification. This license may not be modified without
6061the express written permission of its copyright owner.
6062
6063
6064--
6065END OF ACADEMIC FREE LICENSE. The following is intended to describe the essential
6066differences between the Academic Free License (AFL) version 1.0 and other
6067open source licenses:
6068
6069The Academic Free License is similar to the BSD, MIT, UoI/NCSA and Apache
6070licenses in many respects but it is intended to solve a few problems with
6071those licenses.
6072
6073* The AFL is written so as to make it clear what software is being
6074licensed (by the inclusion of a statement following the copyright notice
6075in the software). This way, the license functions better than a template
6076license. The BSD, MIT and UoI/NCSA licenses apply to unidentified software.
6077
6078* The AFL contains a complete copyright grant to the software. The BSD
6079and Apache licenses are vague and incomplete in that respect.
6080
6081* The AFL contains a complete patent grant to the software. The BSD, MIT,
6082UoI/NCSA and Apache licenses rely on an implied patent license and contain
6083no explicit patent grant.
6084
6085* The AFL makes it clear that no trademark rights are granted to the
6086licensor's trademarks. The Apache license contains such a provision, but the
6087BSD, MIT and UoI/NCSA licenses do not.
6088
6089* The AFL includes the warranty by the licensor that it either owns the
6090copyright or that it is distributing the software under a license. None of
6091the other licenses contain that warranty. All other warranties are disclaimed,
6092as is the case for the other licenses.
6093
6094* The AFL is itself copyrighted (with the right granted to copy and distribute
6095without modification). This ensures that the owner of the copyright to the
6096license will control changes. The Apache license contains a copyright notice,
6097but the BSD, MIT and UoI/NCSA licenses do not.
6098 Phil Nelson <philnelson@acm.org> wrote bc, including the number.c
6099source in the "lib" directory.
6100
6101Ken Pizzini <ken@gnu.org> wrote dc, making use of the lib/number.c
6102code that Phil Nelson wrote to handle the actual multiprecision
6103arithmetic.
6104 GNU bc version 1.06:
6105
6106Extra configuration options:
6107
6108 --with-readline tells bc to use the readline package that allows
6109 for editing input lines when run interactive.
6110
6111 --with-editline tells bc to use the BSD editline package that
6112 allows for editing input lines when run interactive.
6113
6114Extra make steps:
6115
6116 The simple make compiles a version of bc with fixed parameters
6117 for the recursive multiplication algorithm. The fixed parameter
6118 is the number of digits where a sequential algorithm is used
6119 instead of the recursive algorithm. It is set to a value that
6120 is known good on a couple of machines. (Sparc Ultra 10, Pentium
6121 II, 450.) I'm calling this point the crossover point.
6122
6123 To make a version of bc with a custom crossover point for your
6124 machine, do the following steps:
6125
6126 make timetest
6127 make
6128
6129 The timetest step takes a minimum of 10 minutes to complete.
6130
6131
6132-------- Original comp.sources.reviewed README --------
6133
6134Program: GNU bc
6135Author: Philip A. Nelson
6136E-mail: phil@cs.wwu.edu
6137OS: UNIX (BSD, System V, MINIX, POSIX)
6138Copying: GNU GPL version 2
6139Copyright holder: Free Software Foundation, Inc.
6140Version: bc version 1.01
6141Required: vsprintf and vfprintf routines.
6142Machines: It has been compiled and run on the following environments:
6143 BSD4.3 (VAX 11)
6144 MINIX 1.5 (IBM PC, both K&R and ANSI compilers)
6145 MINIX 1.5 (pc532)
6146 SUN-OS 4.1 (SUN 3 and SUN 4)
6147 SVR3V5 (Motorola 68K)
6148 SVR3.2 (3B2)
6149 SVR4.0.2 (a 386 box)
6150 ULTRIX 4.1 (DEC 5000)
6151 UTS (Amdahl)
6152
6153bc is an arbitrary precision numeric processing language. Syntax is
6154similar to C, but differs in many substantial areas. It supports
6155interactive execution of statements. bc is a utility included in the
6156POSIX P1003.2/D11 draft standard.
6157
6158This version was written to be a POSIX compliant bc processor with
6159several extensions to the draft standard. Option flags are available
6160to cause warning or rejection of the extensions to the POSIX standard.
6161For those who want only POSIX bc with no extensions, a grammar is
6162provided for exactly the language described in the POSIX document.
6163The grammar (sbc.y) comes from the POSIX document. The Makefile
6164contains rules to make sbc. (for Standard BC)
6165
6166Since the POSIX document does not specify how bc must be implemented,
6167this version does not use the historical method of having bc be a
6168compiler for the dc calculator. This version has a single executable
6169that both compiles the language and runs the a resulting "byte code".
6170The "byte code" is NOT the dc language.
6171
6172Also, included in the initial distribution is the library file
6173vfprintf.c for MINIX systems. My minix 1.5 did not have this file.
6174Also, you should verify that vsprintf.c works correctly on your
6175system.
6176
6177The extensions add some features I think are missing. The major
6178changes and additions for bc are (a) names are allowed to be full
6179identifiers ([a-z][a-z0-9_]*), (b) addition of the &&, ||, and !
6180operators, (c) allowing comparison and boolean operations in any
6181expression, (d) addition of an else clause to the if statement, (e)
6182addition of a new standard function "read()" that reads a number from
6183the standard input under program control, (f) passing of arrays as
6184parameters by variable, (g) addition of the "halt" statement that is
6185an executable statement unlike the quit (i.e. "if (1 == 0) quit" will
6186halt bc but "if (1 == 0) halt" will not halt bc.), and (h) the
6187addition of the special variable "last" that is assigned the value of
6188each print as the number is printed.
6189-----------------------------------------------------------------------
6190 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
6191<html>
6192<!-- Created on December 21, 2009 by texi2html 1.82
6193texi2html was written by:
6194 Lionel Cons <Lionel.Cons@cern.ch> (original author)
6195 Karl Berry <karl@freefriends.org>
6196 Olaf Bachmann <obachman@mathematik.uni-kl.de>
6197 and many others.
6198Maintained by: Many creative people.
6199Send bugs and suggestions to <texi2html-bug@nongnu.org>
6200-->
6201<head>
6202<title>dc, an arbitrary precision calculator</title>
6203
6204<meta name="description" content="dc, an arbitrary precision calculator">
6205<meta name="keywords" content="dc, an arbitrary precision calculator">
6206<meta name="resource-type" content="document">
6207<meta name="distribution" content="global">
6208<meta name="Generator" content="texi2html 1.82">
6209<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
6210<style type="text/css">
6211<!--
6212a.summary-letter {text-decoration: none}
6213blockquote.smallquotation {font-size: smaller}
6214pre.display {font-family: serif}
6215pre.format {font-family: serif}
6216pre.menu-comment {font-family: serif}
6217pre.menu-preformatted {font-family: serif}
6218pre.smalldisplay {font-family: serif; font-size: smaller}
6219pre.smallexample {font-size: smaller}
6220pre.smallformat {font-family: serif; font-size: smaller}
6221pre.smalllisp {font-size: smaller}
6222span.roman {font-family:serif; font-weight:normal;}
6223span.sansserif {font-family:sans-serif; font-weight:normal;}
6224ul.toc {list-style: none}
6225-->
6226</style>
6227
6228
6229</head>
6230
6231<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
6232
6233<p>This file documents <code>dc</code>, an arbitrary precision calculator.
6234</p>
6235<p>Published by the Free Software Foundation, Inc.
623651 Franklin Street, Fifth Floor
6237Boston, MA 02110-1301 USA
6238</p>
6239<p>Copyright (C) 1984, 1994, 1997, 1998, 2000, 2005, 2006 Free Software Foundation, Inc.
6240</p>
6241<p>Permission is granted to make and distribute verbatim copies of
6242this manual provided the copyright notice and this permission notice
6243are preserved on all copies.
6244</p>
6245
6246<p>Permission is granted to copy and distribute modified versions of this
6247manual under the conditions for verbatim copying, provided that the entire
6248resulting derived work is distributed under the terms of a permission
6249notice identical to this one.
6250</p>
6251<p>Permission is granted to copy and distribute translations of this manual
6252into another language, under the above conditions for modified versions,
6253except that this permission notice may be stated in a translation approved
6254by the Foundation.
6255</p>
6256
6257
6258<a name="Top"></a>
6259<table cellpadding="1" cellspacing="1" border="0">
6260<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6261<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6262<td valign="middle" align="left">[Index]</td>
6263<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6264</tr></table>
6265<h1 class="settitle">dc, an arbitrary precision calculator</h1>
6266
6267<table class="menu" border="0" cellspacing="0">
6268<tr><td align="left" valign="top"><a href="#Introduction">1. Introduction</a></td><td> </td><td align="left" valign="top"></td></tr>
6269<tr><td align="left" valign="top"><a href="#Invocation">2. Invocation</a></td><td> </td><td align="left" valign="top"></td></tr>
6270<tr><td align="left" valign="top"><a href="#Printing-Commands">3. Printing Commands</a></td><td> </td><td align="left" valign="top"></td></tr>
6271<tr><td align="left" valign="top"><a href="#Arithmetic">4. Arithmetic</a></td><td> </td><td align="left" valign="top"></td></tr>
6272<tr><td align="left" valign="top"><a href="#Stack-Control">5. Stack Control</a></td><td> </td><td align="left" valign="top"></td></tr>
6273<tr><td align="left" valign="top"><a href="#Registers">6. Registers</a></td><td> </td><td align="left" valign="top"></td></tr>
6274<tr><td align="left" valign="top"><a href="#Parameters">7. Parameters</a></td><td> </td><td align="left" valign="top"></td></tr>
6275<tr><td align="left" valign="top"><a href="#Strings">8. Strings</a></td><td> </td><td align="left" valign="top"></td></tr>
6276<tr><td align="left" valign="top"><a href="#Status-Inquiry">9. Status Inquiry</a></td><td> </td><td align="left" valign="top"></td></tr>
6277<tr><td align="left" valign="top"><a href="#Miscellaneous">10. Miscellaneous</a></td><td> </td><td align="left" valign="top"> Other commands
6278</td></tr>
6279<tr><td align="left" valign="top"><a href="#Reporting-bugs">11. Reporting bugs</a></td><td> </td><td align="left" valign="top"></td></tr>
6280</table>
6281
6282<hr size="1">
6283<a name="Introduction"></a>
6284<table cellpadding="1" cellspacing="1" border="0">
6285<tr><td valign="middle" align="left">[<a href="#Top" title="Previous section in reading order"> < </a>]</td>
6286<td valign="middle" align="left">[<a href="#Invocation" title="Next section in reading order"> > </a>]</td>
6287<td valign="middle" align="left"> </td>
6288<td valign="middle" align="left">[ << ]</td>
6289<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6290<td valign="middle" align="left">[<a href="#Invocation" title="Next chapter"> >> </a>]</td>
6291<td valign="middle" align="left"> </td>
6292<td valign="middle" align="left"> </td>
6293<td valign="middle" align="left"> </td>
6294<td valign="middle" align="left"> </td>
6295<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6296<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6297<td valign="middle" align="left">[Index]</td>
6298<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6299</tr></table>
6300<a name="Introduction-1"></a>
6301<h1 class="chapter">1. Introduction</h1>
6302
6303<p><code>dc</code> is a reverse-polish desk calculator
6304which supports unlimited precision arithmetic.
6305It also allows you to define and call macros.
6306Normally <code>dc</code> reads from the standard input;
6307if any command arguments are given to it, they are filenames,
6308and <code>dc</code> reads and executes the contents of the files
6309instead of reading from standard input.
6310All normal output is to standard output;
6311all error messages are written to standard error.
6312</p>
6313<p>To exit, use ‘<samp>q</samp>’.
6314<kbd>C-c</kbd>
6315(or whatever other keystroke your system uses to generate a <code>SIGINT</code>)
6316does not exit;
6317it is used to abort macros that are looping, etc.
6318</p>
6319<p>A reverse-polish calculator stores numbers on a stack.
6320Entering a number pushes it on the stack.
6321Arithmetic operations pop arguments off the stack and push the results.
6322</p>
6323<p>To enter a number in <code>dc</code>, type the digits (using upper
6324case letters <code>A</code> through <code>F</code> as "digits" when working
6325with input bases greater than ten),
6326with an optional decimal point.
6327Exponential notation is not supported.
6328To enter a negative number, begin the number with ‘<samp>_</samp>’.
6329‘<samp>-</samp>’ cannot be used for this, as it is a binary operator
6330for subtraction instead.
6331To enter two numbers in succession,
6332separate them with spaces or newlines;
6333these have no meaning as commands.
6334</p>
6335<hr size="6">
6336<a name="Invocation"></a>
6337<table cellpadding="1" cellspacing="1" border="0">
6338<tr><td valign="middle" align="left">[<a href="#Introduction" title="Previous section in reading order"> < </a>]</td>
6339<td valign="middle" align="left">[<a href="#Printing-Commands" title="Next section in reading order"> > </a>]</td>
6340<td valign="middle" align="left"> </td>
6341<td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6342<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6343<td valign="middle" align="left">[<a href="#Printing-Commands" title="Next chapter"> >> </a>]</td>
6344<td valign="middle" align="left"> </td>
6345<td valign="middle" align="left"> </td>
6346<td valign="middle" align="left"> </td>
6347<td valign="middle" align="left"> </td>
6348<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6349<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6350<td valign="middle" align="left">[Index]</td>
6351<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6352</tr></table>
6353<a name="Invocation-1"></a>
6354<h1 class="chapter">2. Invocation</h1>
6355
6356<p><code>dc</code> may be invoked with the following command-line options:
6357</p><dl compact="compact">
6358<dt> ‘<samp>-e <var>expr</var></samp>’</dt>
6359<dt> ‘<samp>--expression=<var>expr</var></samp>’</dt>
6360<dd><p>Evaluate <var>expr</var> as <code>dc</code> commands.
6361</p>
6362</dd>
6363<dt> ‘<samp>-f <var>file</var></samp>’</dt>
6364<dt> ‘<samp>--file=<var>file</var></samp>’</dt>
6365<dd><p>Read and evaluate <code>dc</code> commands from <var>file</var>.
6366</p>
6367</dd>
6368<dt> ‘<samp>-h</samp>’</dt>
6369<dt> ‘<samp>--help</samp>’</dt>
6370<dd><p>Print a usage message summarizing the command-line options, then exit.
6371</p>
6372</dd>
6373<dt> ‘<samp>-V</samp>’</dt>
6374<dt> ‘<samp>--version</samp>’</dt>
6375<dd><p>Print the version information for this program, then exit.
6376</p></dd>
6377</dl>
6378
6379<p>If any command-line parameters remain after processing the options,
6380these parameters are interpreted as additional <var>file</var>s whose
6381contents are read and evaluated.
6382A file name of <code>-</code> refers to the standard input stream.
6383If no <code>-e</code> option was specified, and no files were specified,
6384then the standard input will be read for commands to evaluate.
6385</p>
6386<hr size="6">
6387<a name="Printing-Commands"></a>
6388<table cellpadding="1" cellspacing="1" border="0">
6389<tr><td valign="middle" align="left">[<a href="#Invocation" title="Previous section in reading order"> < </a>]</td>
6390<td valign="middle" align="left">[<a href="#Arithmetic" title="Next section in reading order"> > </a>]</td>
6391<td valign="middle" align="left"> </td>
6392<td valign="middle" align="left">[<a href="#Invocation" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6393<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6394<td valign="middle" align="left">[<a href="#Arithmetic" title="Next chapter"> >> </a>]</td>
6395<td valign="middle" align="left"> </td>
6396<td valign="middle" align="left"> </td>
6397<td valign="middle" align="left"> </td>
6398<td valign="middle" align="left"> </td>
6399<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6400<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6401<td valign="middle" align="left">[Index]</td>
6402<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6403</tr></table>
6404<a name="Printing-Commands-1"></a>
6405<h1 class="chapter">3. Printing Commands</h1>
6406
6407<dl compact="compact">
6408<dt> ‘<samp>p</samp>’</dt>
6409<dd><p>Prints the value on the top of the stack,
6410without altering the stack.
6411A newline is printed after the value.
6412</p>
6413</dd>
6414<dt> ‘<samp>n</samp>’</dt>
6415<dd><p>Prints the value on the top of the stack, popping it off,
6416and does not print a newline after.
6417(This command is a GNU extension.)
6418</p>
6419</dd>
6420<dt> ‘<samp>P</samp>’</dt>
6421<dd><p>Pops off the value on top of the stack.
6422If it it a string, it is simply printed without a trailing newline.
6423Otherwise it is a number, and the integer portion of its absolute
6424value is printed out as a "base (UCHAR_MAX+1)" byte stream.
6425Assuming that (UCHAR_MAX+1) is 256
6426(as it is on most machines with 8-bit bytes),
6427the sequence
6428<code>KSK0k1/ _1Ss[ls*]Sxd0>x
6429[256~Ssd0<x]dsxx
6430sx[q]Sq[Lsd0>qaPlxx]dsxx
6431sx0sqLqsxLxLK+k</code>
6432could also accomplish this function.
6433(Much of the complexity of the above native-dc code is due
6434to the ~ computing the characters backwards,
6435and the desire to ensure that all registers wind up back
6436in their original states.)
6437(Details of the behavior with a number are a GNU extension.
6438Traditional <code>dc</code> happened to "support" similar functionality
6439for a limited range of inputs as an accidental side-effect of its
6440internal representation of numbers.)
6441</p>
6442</dd>
6443<dt> ‘<samp>f</samp>’</dt>
6444<dd><p>Prints the entire contents of the stack
6445without altering anything.
6446This is a good command to use if you are lost or want
6447to figure out what the effect of some command has been.
6448</p></dd>
6449</dl>
6450
6451<p>All numeric output is split to fit within 70 columns, by default.
6452When a number is broken up in this way, the split is indicated
6453by a "\" at the end of the to-be-continued output lines.
6454The column width at which output is split can be overridden
6455by setting the <var>DC_LINE_LENGTH</var> environment variable to
6456the desired width.
6457A <var>DC_LINE_LENGTH</var> of 0 (zero) disables the line-split
6458feature altogether.
6459Invalid values of <var>DC_LINE_LENGTH</var> are silently ignored.
6460(The <var>DC_LINE_LENGTH</var> variable is a GNU extension.)
6461</p>
6462<hr size="6">
6463<a name="Arithmetic"></a>
6464<table cellpadding="1" cellspacing="1" border="0">
6465<tr><td valign="middle" align="left">[<a href="#Printing-Commands" title="Previous section in reading order"> < </a>]</td>
6466<td valign="middle" align="left">[<a href="#Stack-Control" title="Next section in reading order"> > </a>]</td>
6467<td valign="middle" align="left"> </td>
6468<td valign="middle" align="left">[<a href="#Printing-Commands" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6469<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6470<td valign="middle" align="left">[<a href="#Stack-Control" title="Next chapter"> >> </a>]</td>
6471<td valign="middle" align="left"> </td>
6472<td valign="middle" align="left"> </td>
6473<td valign="middle" align="left"> </td>
6474<td valign="middle" align="left"> </td>
6475<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6476<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6477<td valign="middle" align="left">[Index]</td>
6478<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6479</tr></table>
6480<a name="Arithmetic-1"></a>
6481<h1 class="chapter">4. Arithmetic</h1>
6482
6483<dl compact="compact">
6484<dt> ‘<samp>+</samp>’</dt>
6485<dd><p>Pops two values off the stack, adds them, and pushes the result.
6486The precision of the result is determined only
6487by the values of the arguments, and is enough to be exact.
6488</p>
6489</dd>
6490<dt> ‘<samp>-</samp>’</dt>
6491<dd><p>Pops two values, subtracts the first one popped
6492from the second one popped, and pushes the result.
6493</p>
6494</dd>
6495<dt> ‘<samp>*</samp>’</dt>
6496<dd><p>Pops two values, multiplies them, and pushes the result.
6497The number of fraction digits in the result is the largest of
6498the precision value,
6499the number of fraction digits in the multiplier,
6500or the number of fraction digits in the multiplicand;
6501but in no event exceeding the number of digits required for
6502an exact result.
6503</p>
6504</dd>
6505<dt> ‘<samp>/</samp>’</dt>
6506<dd><p>Pops two values, divides the second one popped
6507from the first one popped, and pushes the result.
6508The number of fraction digits is specified by the precision value.
6509</p>
6510</dd>
6511<dt> ‘<samp>%</samp>’</dt>
6512<dd><p>Pops two values,
6513computes the remainder of the division that
6514the ‘<samp>/</samp>’ command would do,
6515and pushes that.
6516The value computed is the same as that computed by
6517the sequence <code>Sd dld/ Ld*-</code> .
6518</p>
6519</dd>
6520<dt> ‘<samp>~</samp>’</dt>
6521<dd><p>Pops two values,
6522divides the second one popped from the first one popped.
6523The quotient is pushed first, and the remainder is pushed next.
6524The number of fraction digits used in the division
6525is specified by the precision value.
6526(The sequence <code>SdSn lnld/ LnLd%</code> could also accomplish
6527this function, with slightly different error checking.)
6528(This command is a GNU extension.)
6529</p>
6530</dd>
6531<dt> ‘<samp>^</samp>’</dt>
6532<dd><p>Pops two values and exponentiates,
6533using the first value popped as the exponent
6534and the second popped as the base.
6535The fraction part of the exponent is ignored.
6536The precision value specifies the number of fraction
6537digits in the result.
6538</p>
6539</dd>
6540<dt> ‘<samp>|</samp>’</dt>
6541<dd><p>Pops three values and computes a modular exponentiation.
6542The first value popped is used as the reduction modulus;
6543this value must be a non-zero number,
6544and the result may not be accurate if the modulus
6545is not an integer.
6546The second popped is used as the exponent;
6547this value must be a non-negative number,
6548and any fractional part of this exponent will be ignored.
6549The third value popped is the base which gets exponentiated,
6550which should be an integer.
6551For small integers this is like the sequence <code>Sm^Lm%</code>,
6552but, unlike <code>^</code>,
6553this command will work with arbritrarily large exponents.
6554(This command is a GNU extension.)
6555</p>
6556</dd>
6557<dt> ‘<samp>v</samp>’</dt>
6558<dd><p>Pops one value, computes its square root, and pushes that.
6559The precision value specifies the number of fraction digits
6560in the result.
6561</p></dd>
6562</dl>
6563
6564<p>Most arithmetic operations are affected by the <em>precision value</em>,
6565which you can set with the ‘<samp>k</samp>’ command.
6566The default precision value is zero,
6567which means that all arithmetic except for
6568addition and subtraction produces integer results.
6569</p>
6570<hr size="6">
6571<a name="Stack-Control"></a>
6572<table cellpadding="1" cellspacing="1" border="0">
6573<tr><td valign="middle" align="left">[<a href="#Arithmetic" title="Previous section in reading order"> < </a>]</td>
6574<td valign="middle" align="left">[<a href="#Registers" title="Next section in reading order"> > </a>]</td>
6575<td valign="middle" align="left"> </td>
6576<td valign="middle" align="left">[<a href="#Arithmetic" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6577<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6578<td valign="middle" align="left">[<a href="#Registers" title="Next chapter"> >> </a>]</td>
6579<td valign="middle" align="left"> </td>
6580<td valign="middle" align="left"> </td>
6581<td valign="middle" align="left"> </td>
6582<td valign="middle" align="left"> </td>
6583<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6584<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6585<td valign="middle" align="left">[Index]</td>
6586<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6587</tr></table>
6588<a name="Stack-Control-1"></a>
6589<h1 class="chapter">5. Stack Control</h1>
6590
6591<dl compact="compact">
6592<dt> ‘<samp>c</samp>’</dt>
6593<dd><p>Clears the stack, rendering it empty.
6594</p>
6595</dd>
6596<dt> ‘<samp>d</samp>’</dt>
6597<dd><p>Duplicates the value on the top of the stack,
6598pushing another copy of it.
6599Thus, ‘<samp>4d*p</samp>’ computes 4 squared and prints it.
6600</p>
6601</dd>
6602<dt> ‘<samp>r</samp>’</dt>
6603<dd><p>Reverses the order of (swaps) the top two values on the stack.
6604(This can also be accomplished with the sequence <code>SaSbLaLb</code>.)
6605(This command is a GNU extension.)
6606</p></dd>
6607</dl>
6608
6609<hr size="6">
6610<a name="Registers"></a>
6611<table cellpadding="1" cellspacing="1" border="0">
6612<tr><td valign="middle" align="left">[<a href="#Stack-Control" title="Previous section in reading order"> < </a>]</td>
6613<td valign="middle" align="left">[<a href="#Parameters" title="Next section in reading order"> > </a>]</td>
6614<td valign="middle" align="left"> </td>
6615<td valign="middle" align="left">[<a href="#Stack-Control" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6616<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6617<td valign="middle" align="left">[<a href="#Parameters" title="Next chapter"> >> </a>]</td>
6618<td valign="middle" align="left"> </td>
6619<td valign="middle" align="left"> </td>
6620<td valign="middle" align="left"> </td>
6621<td valign="middle" align="left"> </td>
6622<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6623<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6624<td valign="middle" align="left">[Index]</td>
6625<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6626</tr></table>
6627<a name="Registers-1"></a>
6628<h1 class="chapter">6. Registers</h1>
6629
6630<p><code>dc</code> provides at least 256 memory registers<a name="DOCF1" href="#FOOT1">(1)</a>,
6631each named by a single character.
6632You can store a number in a register and retrieve it later.
6633</p>
6634<dl compact="compact">
6635<dt> ‘<samp>s<var>r</var></samp>’</dt>
6636<dd><p>Pop the value off the top of the stack and
6637store it into register <var>r</var>.
6638</p>
6639</dd>
6640<dt> ‘<samp>l<var>r</var></samp>’</dt>
6641<dd><p>Copy the value in register <var>r</var>,
6642and push it onto the stack.
6643This does not alter the contents of <var>r</var>.
6644</p>
6645<p>Each register also contains its own stack.
6646The current register value is the top of the register’s stack.
6647</p>
6648</dd>
6649<dt> ‘<samp>S<var>r</var></samp>’</dt>
6650<dd><p>Pop the value off the top of the (main) stack and
6651push it onto the stack of register <var>r</var>.
6652The previous value of the register becomes inaccessible.
6653</p>
6654</dd>
6655<dt> ‘<samp>L<var>r</var></samp>’</dt>
6656<dd><p>Pop the value off the top of register <var>r</var>’s stack
6657and push it onto the main stack.
6658The previous value in register <var>r</var>’s stack, if any,
6659is now accessible via the ‘<samp>l<var>r</var></samp>’ command.
6660</p></dd>
6661</dl>
6662
6663<hr size="6">
6664<a name="Parameters"></a>
6665<table cellpadding="1" cellspacing="1" border="0">
6666<tr><td valign="middle" align="left">[<a href="#Registers" title="Previous section in reading order"> < </a>]</td>
6667<td valign="middle" align="left">[<a href="#Strings" title="Next section in reading order"> > </a>]</td>
6668<td valign="middle" align="left"> </td>
6669<td valign="middle" align="left">[<a href="#Registers" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6670<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6671<td valign="middle" align="left">[<a href="#Strings" title="Next chapter"> >> </a>]</td>
6672<td valign="middle" align="left"> </td>
6673<td valign="middle" align="left"> </td>
6674<td valign="middle" align="left"> </td>
6675<td valign="middle" align="left"> </td>
6676<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6677<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6678<td valign="middle" align="left">[Index]</td>
6679<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6680</tr></table>
6681<a name="Parameters-1"></a>
6682<h1 class="chapter">7. Parameters</h1>
6683
6684<p><code>dc</code> has three parameters that control its operation:
6685the precision, the input radix, and the output radix.
6686The precision specifies the number of fraction digits
6687to keep in the result of most arithmetic operations.
6688The input radix controls the interpretation of numbers typed in;
6689<em>all</em> numbers typed in use this radix.
6690The output radix is used for printing numbers.
6691</p>
6692<p>The input and output radices are separate parameters;
6693you can make them unequal, which can be useful or confusing.
6694The input radix must be between 2 and 16 inclusive.
6695The output radix must be at least 2.
6696The precision must be zero or greater.
6697The precision is always measured in decimal digits,
6698regardless of the current input or output radix.
6699</p>
6700<dl compact="compact">
6701<dt> ‘<samp>i</samp>’</dt>
6702<dd><p>Pops the value off the top of the stack
6703and uses it to set the input radix.
6704</p>
6705</dd>
6706<dt> ‘<samp>o</samp>’</dt>
6707<dd><p>Pops the value off the top of the stack
6708and uses it to set the output radix.
6709</p>
6710</dd>
6711<dt> ‘<samp>k</samp>’</dt>
6712<dd><p>Pops the value off the top of the stack
6713and uses it to set the precision.
6714</p>
6715</dd>
6716<dt> ‘<samp>I</samp>’</dt>
6717<dd><p>Pushes the current input radix on the stack.
6718</p>
6719</dd>
6720<dt> ‘<samp>O</samp>’</dt>
6721<dd><p>Pushes the current output radix on the stack.
6722</p>
6723</dd>
6724<dt> ‘<samp>K</samp>’</dt>
6725<dd><p>Pushes the current precision on the stack.
6726</p>
6727</dd>
6728</dl>
6729
6730<hr size="6">
6731<a name="Strings"></a>
6732<table cellpadding="1" cellspacing="1" border="0">
6733<tr><td valign="middle" align="left">[<a href="#Parameters" title="Previous section in reading order"> < </a>]</td>
6734<td valign="middle" align="left">[<a href="#Status-Inquiry" title="Next section in reading order"> > </a>]</td>
6735<td valign="middle" align="left"> </td>
6736<td valign="middle" align="left">[<a href="#Parameters" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6737<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6738<td valign="middle" align="left">[<a href="#Status-Inquiry" title="Next chapter"> >> </a>]</td>
6739<td valign="middle" align="left"> </td>
6740<td valign="middle" align="left"> </td>
6741<td valign="middle" align="left"> </td>
6742<td valign="middle" align="left"> </td>
6743<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6744<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6745<td valign="middle" align="left">[Index]</td>
6746<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6747</tr></table>
6748<a name="Strings-1"></a>
6749<h1 class="chapter">8. Strings</h1>
6750
6751<p><code>dc</code> has a limited ability
6752to operate on strings as well as on numbers;
6753the only things you can do with strings are print them
6754and execute them as macros
6755(which means that the contents of the string are processed
6756as <code>dc</code> commands).
6757Both registers and the stack can hold strings,
6758and <code>dc</code> always knows whether any given object is
6759a string or a number.
6760Some commands such as arithmetic operations demand numbers
6761as arguments and print errors if given strings.
6762Other commands can accept either a number or a string;
6763for example, the ‘<samp>p</samp>’ command can accept either and prints the object
6764according to its type.
6765</p>
6766<dl compact="compact">
6767<dt> ‘<samp>[<var>characters</var>]</samp>’</dt>
6768<dd><p>Makes a string containing <var>characters</var> and pushes it on the stack.
6769For example, ‘<samp>[foo]P</samp>’ prints the characters ‘<samp>foo</samp>’
6770(with no newline).
6771Note that all square brackets (‘<samp>[</samp>’s and ‘<samp>]</samp>’s) must be balanced;
6772there is no mechanism provided for handling unbalanced square brackets.
6773</p>
6774</dd>
6775<dt> ‘<samp>a</samp>’</dt>
6776<dd><p>The mnemonic for this is somewhat erroneous: asciify.
6777The top-of-stack is popped.
6778If it was a number, then the low-order byte of this number
6779is converted into a 1-character string
6780and pushed onto the stack.
6781Otherwise the top-of-stack was a string,
6782and the first character of that string is pushed back.
6783(This command is a GNU extension.)
6784</p>
6785</dd>
6786<dt> ‘<samp>x</samp>’</dt>
6787<dd><p>Pops a value off the stack and executes it as a macro.
6788Normally it should be a string;
6789if it is a number, it is simply pushed back onto the stack.
6790For example, ‘<samp>[1p]x</samp>’ executes the macro ‘<samp>1p</samp>’,
6791which pushes 1 on the stack and prints ‘<samp>1</samp>’ on a separate line.
6792</p>
6793<p>Macros are most often stored in registers;
6794‘<samp>[1p]sa</samp>’ stores a macro to print ‘<samp>1</samp>’ into register ‘<samp>a</samp>’,
6795and ‘<samp>lax</samp>’ invokes the macro.
6796</p>
6797</dd>
6798<dt> ‘<samp>><var>r</var></samp>’</dt>
6799<dd><p>Pops two values off the stack and compares them
6800assuming they are numbers,
6801executing the contents of register <var>r</var> as a macro
6802if the original top-of-stack is greater.
6803Thus, ‘<samp>1 2>a</samp>’ will invoke register ‘<samp>a</samp>’’s contents
6804and ‘<samp>2 1>a</samp>’ will not.
6805</p>
6806</dd>
6807<dt> ‘<samp>!><var>r</var></samp>’</dt>
6808<dd><p>Similar but invokes the macro if the original top-of-stack is not greater
6809(is less than or equal to) what was the second-to-top.
6810</p>
6811</dd>
6812<dt> ‘<samp><<var>r</var></samp>’</dt>
6813<dd><p>Similar but invokes the macro if the original top-of-stack is less.
6814</p>
6815</dd>
6816<dt> ‘<samp>!<<var>r</var></samp>’</dt>
6817<dd><p>Similar but invokes the macro if the original top-of-stack is not less
6818(is greater than or equal to) what was the second-to-top.
6819</p>
6820</dd>
6821<dt> ‘<samp>=<var>r</var></samp>’</dt>
6822<dd><p>Similar but invokes the macro if the two numbers popped are equal.
6823</p>
6824</dd>
6825<dt> ‘<samp>!=<var>r</var></samp>’</dt>
6826<dd><p>Similar but invokes the macro if the two numbers popped are not equal.
6827</p>
6828</dd>
6829<dt> ‘<samp>?</samp>’</dt>
6830<dd><p>Reads a line from the terminal and executes it.
6831This command allows a macro to request input from the user.
6832</p>
6833</dd>
6834<dt> ‘<samp>q</samp>’</dt>
6835<dd><p>During the execution of a macro,
6836this command exits from the macro and also from the macro which invoked it.
6837If called from the top level,
6838or from a macro which was called directly from the top level,
6839the ‘<samp>q</samp>’ command will cause <code>dc</code> to exit.
6840</p>
6841</dd>
6842<dt> ‘<samp>Q</samp>’</dt>
6843<dd><p>Pops a value off the stack and uses it as a count
6844of levels of macro execution to be exited.
6845Thus, ‘<samp>3Q</samp>’ exits three levels.
6846</p></dd>
6847</dl>
6848
6849<hr size="6">
6850<a name="Status-Inquiry"></a>
6851<table cellpadding="1" cellspacing="1" border="0">
6852<tr><td valign="middle" align="left">[<a href="#Strings" title="Previous section in reading order"> < </a>]</td>
6853<td valign="middle" align="left">[<a href="#Miscellaneous" title="Next section in reading order"> > </a>]</td>
6854<td valign="middle" align="left"> </td>
6855<td valign="middle" align="left">[<a href="#Strings" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6856<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6857<td valign="middle" align="left">[<a href="#Miscellaneous" title="Next chapter"> >> </a>]</td>
6858<td valign="middle" align="left"> </td>
6859<td valign="middle" align="left"> </td>
6860<td valign="middle" align="left"> </td>
6861<td valign="middle" align="left"> </td>
6862<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6863<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6864<td valign="middle" align="left">[Index]</td>
6865<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6866</tr></table>
6867<a name="Status-Inquiry-1"></a>
6868<h1 class="chapter">9. Status Inquiry</h1>
6869
6870<dl compact="compact">
6871<dt> ‘<samp>Z</samp>’</dt>
6872<dd><p>Pops a value off the stack,
6873calculates the number of digits it has
6874(or number of characters, if it is a string)
6875and pushes that number.
6876</p>
6877<p>Note that the digit count for a number does
6878<em>not</em> include any leading zeros,
6879even if those appear to the right of the radix point.
6880This may seem a bit strange at first,
6881but it is compatable with historical implementations of <code>dc</code>,
6882and can be argued to be useful for computing the magnitude of a value:
6883<code>dSaXLaZ-</code> will compute the power-of-ten multiplier
6884which would be needed to shift the decimal point
6885to be immediately before the leftmost non-zero digit.
6886</p>
6887</dd>
6888<dt> ‘<samp>X</samp>’</dt>
6889<dd><p>Pops a value off the stack,
6890calculates the number of fraction digits it has,
6891and pushes that number.
6892For a string, the value pushed is
68930.
6894</p>
6895</dd>
6896<dt> ‘<samp>z</samp>’</dt>
6897<dd><p>Pushes the current stack depth:
6898the number of objects on the stack
6899before the execution of the ‘<samp>z</samp>’ command.
6900</p></dd>
6901</dl>
6902
6903<hr size="6">
6904<a name="Miscellaneous"></a>
6905<table cellpadding="1" cellspacing="1" border="0">
6906<tr><td valign="middle" align="left">[<a href="#Status-Inquiry" title="Previous section in reading order"> < </a>]</td>
6907<td valign="middle" align="left">[<a href="#Reporting-bugs" title="Next section in reading order"> > </a>]</td>
6908<td valign="middle" align="left"> </td>
6909<td valign="middle" align="left">[<a href="#Status-Inquiry" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6910<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6911<td valign="middle" align="left">[<a href="#Reporting-bugs" title="Next chapter"> >> </a>]</td>
6912<td valign="middle" align="left"> </td>
6913<td valign="middle" align="left"> </td>
6914<td valign="middle" align="left"> </td>
6915<td valign="middle" align="left"> </td>
6916<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6917<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6918<td valign="middle" align="left">[Index]</td>
6919<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6920</tr></table>
6921<a name="Miscellaneous-1"></a>
6922<h1 class="chapter">10. Miscellaneous</h1>
6923
6924<dl compact="compact">
6925<dt> ‘<samp>!</samp>’</dt>
6926<dd><p>Will run the rest of the line as a system command.
6927Note that parsing of the !<, !=, and !> commands take precidence,
6928so if you want to run a command starting with <, =, or > you will
6929need to add a space after the !.
6930</p>
6931</dd>
6932<dt> ‘<samp>#</samp>’</dt>
6933<dd><p>Will interpret the rest of the line as a comment.
6934(This command is a GNU extension.)
6935</p>
6936</dd>
6937<dt> ‘<samp>:<var>r</var></samp>’</dt>
6938<dd><p>Will pop the top two values off of the stack.
6939The old second-to-top value will be stored in the array <var>r</var>,
6940indexed by the old top-of-stack value.
6941</p>
6942</dd>
6943<dt> ‘<samp>;<var>r</var></samp>’</dt>
6944<dd><p>Pops the top-of-stack and uses it as an index into
6945the array <var>r</var>.
6946The selected value is then pushed onto the stack.
6947</p></dd>
6948</dl>
6949
6950<p>Note that each stacked instance of a register has its own
6951array associated with it.
6952Thus ‘<samp>1 <var>0:a</var> 0S<var>a</var> 2 <var>0:a</var> L<var>a</var> <var>0;a</var>p</samp>’
6953will print 1, because the 2 was stored in an instance of <var>0:a</var>
6954that was later popped.
6955</p>
6956<hr size="6">
6957<a name="Reporting-bugs"></a>
6958<table cellpadding="1" cellspacing="1" border="0">
6959<tr><td valign="middle" align="left">[<a href="#Miscellaneous" title="Previous section in reading order"> < </a>]</td>
6960<td valign="middle" align="left">[ > ]</td>
6961<td valign="middle" align="left"> </td>
6962<td valign="middle" align="left">[<a href="#Miscellaneous" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6963<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6964<td valign="middle" align="left">[ >> ]</td>
6965<td valign="middle" align="left"> </td>
6966<td valign="middle" align="left"> </td>
6967<td valign="middle" align="left"> </td>
6968<td valign="middle" align="left"> </td>
6969<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6970<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6971<td valign="middle" align="left">[Index]</td>
6972<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6973</tr></table>
6974<a name="Reporting-bugs-1"></a>
6975<h1 class="chapter">11. Reporting bugs</h1>
6976
6977<p>Email bug reports to <a href="mailto:bug-dc@gnu.org">bug-dc@gnu.org</a>.
6978</p><hr size="6">
6979<a name="SEC_Foot"></a>
6980<table cellpadding="1" cellspacing="1" border="0">
6981<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6982<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6983<td valign="middle" align="left">[Index]</td>
6984<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6985</tr></table>
6986<h1>Footnotes</h1>
6987<h3><a name="FOOT1" href="#DOCF1">(1)</a></h3>
6988<p>The
6989exact number of registers provided by <code>dc</code> depends
6990on the range of an <code>unsigned char</code> in the C compiler
6991used to create the <code>dc</code> executable.
6992</p><hr size="1">
6993<a name="SEC_Contents"></a>
6994<table cellpadding="1" cellspacing="1" border="0">
6995<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6996<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6997<td valign="middle" align="left">[Index]</td>
6998<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6999</tr></table>
7000<h1>Table of Contents</h1>
7001<div class="contents">
7002
7003<ul class="toc">
7004 <li><a name="toc-Introduction-1" href="#Introduction">1. Introduction</a></li>
7005 <li><a name="toc-Invocation-1" href="#Invocation">2. Invocation</a></li>
7006 <li><a name="toc-Printing-Commands-1" href="#Printing-Commands">3. Printing Commands</a></li>
7007 <li><a name="toc-Arithmetic-1" href="#Arithmetic">4. Arithmetic</a></li>
7008 <li><a name="toc-Stack-Control-1" href="#Stack-Control">5. Stack Control</a></li>
7009 <li><a name="toc-Registers-1" href="#Registers">6. Registers</a></li>
7010 <li><a name="toc-Parameters-1" href="#Parameters">7. Parameters</a></li>
7011 <li><a name="toc-Strings-1" href="#Strings">8. Strings</a></li>
7012 <li><a name="toc-Status-Inquiry-1" href="#Status-Inquiry">9. Status Inquiry</a></li>
7013 <li><a name="toc-Miscellaneous-1" href="#Miscellaneous">10. Miscellaneous</a></li>
7014 <li><a name="toc-Reporting-bugs-1" href="#Reporting-bugs">11. Reporting bugs</a></li>
7015</ul>
7016</div>
7017<hr size="1">
7018<a name="SEC_About"></a>
7019<table cellpadding="1" cellspacing="1" border="0">
7020<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7021<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7022<td valign="middle" align="left">[Index]</td>
7023<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7024</tr></table>
7025<h1>About This Document</h1>
7026<p>
7027 This document was generated by <em>Build Daemon user</em> on <em>December 21, 2009</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.
7028</p>
7029<p>
7030 The buttons in the navigation panels have the following meaning:
7031</p>
7032<table border="1">
7033 <tr>
7034 <th> Button </th>
7035 <th> Name </th>
7036 <th> Go to </th>
7037 <th> From 1.2.3 go to</th>
7038 </tr>
7039 <tr>
7040 <td align="center"> [ < ] </td>
7041 <td align="center">Back</td>
7042 <td>Previous section in reading order</td>
7043 <td>1.2.2</td>
7044 </tr>
7045 <tr>
7046 <td align="center"> [ > ] </td>
7047 <td align="center">Forward</td>
7048 <td>Next section in reading order</td>
7049 <td>1.2.4</td>
7050 </tr>
7051 <tr>
7052 <td align="center"> [ << ] </td>
7053 <td align="center">FastBack</td>
7054 <td>Beginning of this chapter or previous chapter</td>
7055 <td>1</td>
7056 </tr>
7057 <tr>
7058 <td align="center"> [ Up ] </td>
7059 <td align="center">Up</td>
7060 <td>Up section</td>
7061 <td>1.2</td>
7062 </tr>
7063 <tr>
7064 <td align="center"> [ >> ] </td>
7065 <td align="center">FastForward</td>
7066 <td>Next chapter</td>
7067 <td>2</td>
7068 </tr>
7069 <tr>
7070 <td align="center"> [Top] </td>
7071 <td align="center">Top</td>
7072 <td>Cover (top) of document</td>
7073 <td> </td>
7074 </tr>
7075 <tr>
7076 <td align="center"> [Contents] </td>
7077 <td align="center">Contents</td>
7078 <td>Table of contents</td>
7079 <td> </td>
7080 </tr>
7081 <tr>
7082 <td align="center"> [Index] </td>
7083 <td align="center">Index</td>
7084 <td>Index</td>
7085 <td> </td>
7086 </tr>
7087 <tr>
7088 <td align="center"> [ ? ] </td>
7089 <td align="center">About</td>
7090 <td>About (help)</td>
7091 <td> </td>
7092 </tr>
7093</table>
7094
7095<p>
7096 where the <strong> Example </strong> assumes that the current position is at <strong> Subsubsection One-Two-Three </strong> of a document of the following structure:
7097</p>
7098
7099<ul>
7100 <li> 1. Section One
7101 <ul>
7102 <li>1.1 Subsection One-One
7103 <ul>
7104 <li>...</li>
7105 </ul>
7106 </li>
7107 <li>1.2 Subsection One-Two
7108 <ul>
7109 <li>1.2.1 Subsubsection One-Two-One</li>
7110 <li>1.2.2 Subsubsection One-Two-Two</li>
7111 <li>1.2.3 Subsubsection One-Two-Three
7112 <strong><== Current Position </strong></li>
7113 <li>1.2.4 Subsubsection One-Two-Four</li>
7114 </ul>
7115 </li>
7116 <li>1.3 Subsection One-Three
7117 <ul>
7118 <li>...</li>
7119 </ul>
7120 </li>
7121 <li>1.4 Subsection One-Four</li>
7122 </ul>
7123 </li>
7124</ul>
7125
7126<hr size="1">
7127<p>
7128 <font size="-1">
7129 This document was generated by <em>Build Daemon user</em> on <em>December 21, 2009</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.
7130 </font>
7131 <br>
7132
7133</p>
7134</body>
7135</html>
7136 Format: http://dep.debian.net/deps/dep5/
7137Upstream-Name: dconf
7138Upstream-Contact: Ryan Lortie <desrt@desrt.ca>
7139Source: http://ftp.gnome.org/pub/GNOME/sources/dconf
7140
7141Files: *
7142Copyright: 2008,2009 Ryan Lortie <desrt@desrt.ca>
7143 2010 Codethink Limited
7144License: LGPL-2+
7145
7146Files: dbus-1/dconf-dbus-1.*
7147 tests/gsettings.c tests/dbus1.c
7148Copyright: 2010 Canonical Limited
7149License: GPL-3+
7150
7151Files: debian/*
7152Copyright: 2010,2011 Canonical Limited
7153License: GPL-3
7154
7155License: LGPL-2+
7156 This program is free software: you can redistribute it and/or modify
7157 it under the terms of the GNU Lesser General Public License as published by
7158 the Free Software Foundation, either version 2 of the License, or
7159 (at your option) any later version.
7160 .
7161 This program is distributed in the hope that it will be useful,
7162 but WITHOUT ANY WARRANTY; without even the implied warranty of
7163 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7164 GNU General Public License for more details.
7165 .
7166 You should have received a copy of the GNU Lesser General Public License
7167 along with this program. If not, see <http://www.gnu.org/licenses/>.
7168 .
7169 On Debian systems, the full text of the GNU General Public License
7170 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7171
7172License: GPL-3
7173 This program is free software: you can redistribute it and/or modify
7174 it under the terms of the GNU General Public License as published by
7175 the Free Software Foundation, version 3 of the License.
7176 .
7177 This program is distributed in the hope that it will be useful,
7178 but WITHOUT ANY WARRANTY; without even the implied warranty of
7179 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7180 GNU General Public License for more details.
7181 .
7182 You should have received a copy of the GNU General Public License
7183 along with this program. If not, see <http://www.gnu.org/licenses/>.
7184 .
7185 On Debian systems, the full text of the GNU General Public License
7186 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7187
7188License: GPL-3+
7189 This program is free software: you can redistribute it and/or modify
7190 it under the terms of the GNU General Public License as published by
7191 the Free Software Foundation, either version 3 of the License, or
7192 (at your option) any later version.
7193 .
7194 This program is distributed in the hope that it will be useful,
7195 but WITHOUT ANY WARRANTY; without even the implied warranty of
7196 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7197 GNU General Public License for more details.
7198 .
7199 You should have received a copy of the GNU General Public License
7200 along with this program. If not, see <http://www.gnu.org/licenses/>.
7201 .
7202 On Debian systems, the full text of the GNU General Public License
7203 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7204
7205 Format: http://dep.debian.net/deps/dep5/
7206Upstream-Name: dconf
7207Upstream-Contact: Ryan Lortie <desrt@desrt.ca>
7208Source: http://ftp.gnome.org/pub/GNOME/sources/dconf
7209
7210Files: *
7211Copyright: 2008,2009 Ryan Lortie <desrt@desrt.ca>
7212 2010 Codethink Limited
7213License: LGPL-2+
7214
7215Files: dbus-1/dconf-dbus-1.*
7216 tests/gsettings.c tests/dbus1.c
7217Copyright: 2010 Canonical Limited
7218License: GPL-3+
7219
7220Files: debian/*
7221Copyright: 2010,2011 Canonical Limited
7222License: GPL-3
7223
7224License: LGPL-2+
7225 This program is free software: you can redistribute it and/or modify
7226 it under the terms of the GNU Lesser General Public License as published by
7227 the Free Software Foundation, either version 2 of the License, or
7228 (at your option) any later version.
7229 .
7230 This program is distributed in the hope that it will be useful,
7231 but WITHOUT ANY WARRANTY; without even the implied warranty of
7232 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7233 GNU General Public License for more details.
7234 .
7235 You should have received a copy of the GNU Lesser General Public License
7236 along with this program. If not, see <http://www.gnu.org/licenses/>.
7237 .
7238 On Debian systems, the full text of the GNU General Public License
7239 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7240
7241License: GPL-3
7242 This program is free software: you can redistribute it and/or modify
7243 it under the terms of the GNU General Public License as published by
7244 the Free Software Foundation, version 3 of the License.
7245 .
7246 This program is distributed in the hope that it will be useful,
7247 but WITHOUT ANY WARRANTY; without even the implied warranty of
7248 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7249 GNU General Public License for more details.
7250 .
7251 You should have received a copy of the GNU General Public License
7252 along with this program. If not, see <http://www.gnu.org/licenses/>.
7253 .
7254 On Debian systems, the full text of the GNU General Public License
7255 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7256
7257License: GPL-3+
7258 This program is free software: you can redistribute it and/or modify
7259 it under the terms of the GNU General Public License as published by
7260 the Free Software Foundation, either version 3 of the License, or
7261 (at your option) any later version.
7262 .
7263 This program is distributed in the hope that it will be useful,
7264 but WITHOUT ANY WARRANTY; without even the implied warranty of
7265 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7266 GNU General Public License for more details.
7267 .
7268 You should have received a copy of the GNU General Public License
7269 along with this program. If not, see <http://www.gnu.org/licenses/>.
7270 .
7271 On Debian systems, the full text of the GNU General Public License
7272 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7273
7274 If you're looking for documentation on debconf, install the debconf-doc
7275package and see debconf(7) and the other man pages in that package.
7276
7277That package also contains the full changelog for debconf, if anyone was
7278wondering. The changelog in this package is reduced to avoid bloating base
7279with all my years of changes.
7280
7281-- Joey Hess <joeyh@debian.org>
7282 ********************