· 9 years ago · Nov 16, 2015, 08:40 PM
1Stuff on David's Computer
2
3 BlueZ D-Bus Control API description
4***********************************
5
6Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
7Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
8
9
10Control hierarchy
11=================
12
13Service org.bluez
14Interface org.bluez.Control
15Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
16
17Methods boolean IsConnected() {deprecated}
18
19 Returns True if connected, otherwise FALSE.
20
21 dict GetProperties()
22
23 Returns all properties for the interface. See the
24 properties section for available properties.
25
26 void VolumeUp()
27
28 Adjust remote volume one step up
29
30 void VolumeDown()
31
32 Adjust remote volume one step down
33
34Signals Connected() {deprecated}
35This package was debianized by Edd Dumbill <edd@usefulinc.com> on
36Sat, 13 Apr 2002 16:09:02 +0100.
37
38It was downloaded from http://www.bluez.org/
39
40BlueZ - Bluetooth protocol stack for Linux
41
42Copyright:
43 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
44 Copyright (C) 2006-2009 Nokia Corporation
45 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
46 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
47 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
48 Copyright (C) 2007-2008 Texas Instruments, Inc.
49 Copyright (C) 2000-2005 CSR Ltd.
50 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
51 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
52 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
53 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
54 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
55 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
56 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
57 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
58 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
59 Copyright (C) 2000-2001 Qualcomm Incorporated
60 Copyright (C) 2008 Joao Paulo Rechi Vita
61 Copyright (C) 2009 Lennart Poettering
62 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
63 Copyright (C) 2009 Intel Corporation
64
65License:
66 audio/
67 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
68 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
69 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
70 unix.c unix.h
71
72 License: GPL version 2 or any later version
73
74 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
75 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
76 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
77 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
78 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
79 ipc.c ipc.h rtp.h
80 ipctest.c
81
82 License: LGPL version 2.1 or any later version
83
84 sbc/
85 formats.h sbcdec.c sbcenc.c sbcinfo.c
86 sbctester.c
87
88 License: GPL version 2 or any later version
89
90 sbc.c sbc.h
91 sbc_math.h sbc_primitives.c sbc_primitives.h
92 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
93 sbc_primitives_neon.h sbc_tables.h
94
95 License: LGPL version 2.1 or any later version
96
97 tools/
98 ubcsp.c ubcsp.h
99
100 License: MIT License
101
102 Permission is hereby granted, free of charge, to any person
103 obtaining a copy of this software and associated documentation
104 files (the "Software"), to deal in the Software without
105 restriction, including without limitation the rights to use,
106 copy, modify, merge, publish, distribute, sublicense, and/or sell
107 copies of the Software, and to permit persons to whom the
108 Software is furnished to do so, subject to the following
109 conditions:
110
111 The above copyright notice and this permission notice shall be
112 included in all copies or substantial portions of the Software.
113
114 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
115 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
116 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
117 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
118 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
119 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
120 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
121 OTHER DEALINGS IN THE SOFTWARE.
122
123 avctrl.c bccmd.c avinfo.c
124 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
125 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
126 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
127 hciattach_ti.c
128 hciattach.c hciconfig.c hcitool.c l2ping.c
129 hcisecfilter.c sdptool.c
130
131 License: GPL version 2 or any later version
132
133 doc/
134 All files.
135
136 License: GFDL version 1.1 or any later version
137 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
138
139 other:
140 License: GPL version 2 or any later version
141
142On Debian GNU/Linux systems, the complete text of the GNU General Public
143License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
144General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
145the GNU Free Documentation License can be found in
146`/usr/share/common-licenses/GFDL'.
147Gateway hierarchy
148========================
149
150Service org.bluez
151Interface org.bluez.HandsfreeGateway
152Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
153
154This interface is available for remote devices which can function in the Audio
155Gateway role of the HFP profiles. It is intended to be used with external
156telephony stacks / handlers of the HFP protocol.
157
158Methods void Connect()
159
160 Connect to the AG service on the remote device.
161
162 void Disconnect()
163
164 Disconnect from the AG service on the remote device
165
166 dict GetProperties()
167
168 Returns all properties for the interface. See the
169 properties section for available properties.
170
171 void RegisterAgent(object path)
172
173 The object path defines the path the of the agent
174 that will be called when a new Handsfree connection
175 is established.
176
177 If an application disconnects from the bus all of its
178 registered agents will be removed.
179
180 void UnregisterAgent(object path)
181
182 This unregisters the agent that has been previously
183 registered. The object path parameter must match the
184 same value that has been used on registration.
185
186 Possible Errors: org.bluez.Error.Failed
187 org.bluez.Error.InvalidArguments
188
189
190Signals PropertyChanged(string name, variant value)
191
192 This signal indicates a changed value of the given
193 property.
194
195Properties string State [readonly]
196
197 Indicates the state of the connection. Possible
198 values are:
199 "disconnected"
200 "connecting"
201 "connected"
202 "playing"
203
204HandsfreeAgent hierarchy
205===============
206
207Service unique name
208Interface org.bluez.HandsfreeAgent
209Object path freely definable
210
211Methods void NewConnection(filedescriptor fd, uint16 version)
212
213 This method gets called whenever a new handsfree
214 connection has been established. The objectpath
215 contains the object path of the remote device. This
216 method assumes that DBus daemon with file descriptor
217 passing capability is being used.
218
219 The agent should only return successfully once the
220 establishment of the service level connection (SLC)
221 has been completed. In the case of Handsfree this
222 means that BRSF exchange has been performed and
223 necessary initialization has been done.
224
225 Possible Errors: org.bluez.Error.InvalidArguments
226 org.bluez.Error.Failed
227
228 void Release()
229
230 This method gets called whenever the service daemon
231 unregisters the agent or whenever the Adapter where
232 the HandsfreeAgent registers itself is removed.
233 BlueZ D-Bus Input API description
234*********************************
235
236Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
237
238
239Input hierarchy
240===============
241
242Service org.bluez
243Interface org.bluez.Input
244Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
245
246Methods void Connect()
247
248 Connect to the input device.
249
250 Possible errors: org.bluez.Error.AlreadyConnected
251 org.bluez.Error.ConnectionAttemptFailed
252
253 void Disconnect()
254
255 Disconnect from the input device.
256
257 To abort a connection attempt in case of errors or
258 timeouts in the client it is fine to call this method.
259
260 Possible errors: org.bluez.Error.Failed
261
262 dict GetProperties()
263
264 Returns all properties for the interface. See the
265 properties section for available properties.
266
267 Possible Errors: org.bluez.Error.InvalidArguments
268
269Signals PropertyChanged(string name, variant value)
270
271 This signal indicates a changed value of the given
272 property.
273
274Properties boolean Connected [readonly]
275
276 Indicates if the device is connected.
277 BlueZ D-Bus Manager API description
278***********************************
279
280Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
281Copyright (C) 2005-2006 Johan Hedberg <johan.hedberg@nokia.com>
282Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
283Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
284
285
286Manager hierarchy
287=================
288
289Service org.bluez
290Interface org.bluez.Manager
291Object path /
292
293Methods dict GetProperties()
294
295 Returns all global properties. See the
296 properties section for available properties.
297
298 Possible Errors: org.bluez.Error.DoesNotExist
299 org.bluez.Error.InvalidArguments
300
301 object DefaultAdapter()
302
303 Returns object path for the default adapter.
304
305 Possible errors: org.bluez.Error.InvalidArguments
306 org.bluez.Error.NoSuchAdapter
307
308 object FindAdapter(string pattern)
309
310 Returns object path for the specified adapter. Valid
311 patterns are "hci0" or "00:11:22:33:44:55".
312
313 Possible errors: org.bluez.Error.InvalidArguments
314 org.bluez.Error.NoSuchAdapter
315
316 array{object} ListAdapters() {deprecated}
317
318 Returns list of adapter object paths under /org/bluez.
319 This method is deprecated, instead use the Adapters
320 Property to get the list of adapter object paths.
321
322 Possible errors: org.bluez.Error.InvalidArguments
323 org.bluez.Error.Failed
324 org.bluez.Error.OutOfMemory
325
326Signals PropertyChanged(string name, variant value)
327
328 This signal indicates a changed value of the given
329 property.
330
331 AdapterAdded(object adapter)
332
333 Parameter is object path of added adapter.
334
335 AdapterRemoved(object adapter)
336
337 Parameter is object path of removed adapter.
338
339 DefaultAdapterChanged(object adapter)
340
341 Parameter is object path of the new default adapter.
342
343 In case all adapters are removed this signal will not
344 be emitted. The AdapterRemoved signal has to be used
345 to detect that no default adapter is selected or
346 available anymore.
347
348Properties array{object} Adapters [readonly]
349
350 List of adapter object paths.
351 BlueZ D-Bus Network API description
352***********************************
353
354Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
355
356
357Network hierarchy
358=================
359
360Service org.bluez
361Interface org.bluez.Network
362Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
363
364Methods string Connect(string uuid)
365
366 Connect to the network device and return the network
367 interface name. Examples of the interface name are
368 bnep0, bnep1 etc.
369
370 uuid can be either one of "gn", "panu" or "nap" (case
371 insensitive) or a traditional string representation of
372 UUID or a hexadecimal number.
373
374 The connection will be closed and network device
375 released either upon calling Disconnect() or when
376 the client disappears from the message bus.
377
378 Possible errors: org.bluez.Error.AlreadyConnected
379 org.bluez.Error.ConnectionAttemptFailed
380
381 void Disconnect()
382
383 Disconnect from the network device.
384
385 To abort a connection attempt in case of errors or
386 timeouts in the client it is fine to call this method.
387
388 Possible errors: org.bluez.Error.Failed
389
390 dict GetProperties()
391
392 Returns all properties for the interface. See the
393 properties section for available properties.
394
395Signals PropertyChanged(string name, variant value)
396
397 This signal indicates a changed value of the given
398 property.
399
400Properties boolean Connected [readonly]
401
402 Indicates if the device is connected.
403
404 string Interface [readonly]
405
406 Indicates the network interface name when available.
407
408 string UUID [readonly]
409
410 Indicates the connection role when available.
411
412
413Network server hierarchy
414========================
415
416Service org.bluez
417Interface org.bluez.NetworkServer
418Object path /org/bluez/{hci0,hci1,...}
419
420Methods void Register(string uuid, string bridge)
421
422 Register server for the provided UUID. Every new
423 connection to this server will be added the bridge
424 interface.
425
426 Valid UUIDs are "gn", "panu" or "nap".
427
428 Initially no network server SDP is provided. Only
429 after this method a SDP record will be available
430 and the BNEP server will be ready for incoming
431 connections.
432
433 void Unregister(string uuid)
434
435 Unregister the server for provided UUID.
436
437 All servers will be automatically unregistered when
438 the calling application terminates.
439 BlueZ D-Bus Sim Access Profile API description
440***********************************
441
442Copyright (C) 2010 ST-Ericsson SA
443
444
445Sim Access Profile hierarchy
446============================
447
448Service org.bluez
449Interface org.bluez.SimAccess
450Object path [variable prefix]/{hci0,hci1,...}
451
452Methods void Disconnect()
453
454 Disconnects SAP client from the server.
455
456 Possible errors: org.bluez.Error.Failed
457
458 dict GetProperties()
459
460 Return all properties for the interface. See the
461 properties section for available properties.
462
463 Possible Errors: org.bluez.Error.Failed
464
465Signals PropertyChanged(string name, variant value)
466
467 This signal indicates a changed value of the given
468 property.
469
470Properties boolean Connected [readonly]
471
472 Indicates if SAP client is connected to the server.
473 BlueZ D-Bus Adapter API description
474***********************************
475
476Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
477Copyright (C) 2005-2006 Johan Hedberg <johan.hedberg@nokia.com>
478Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
479Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
480
481
482Service hierarchy
483=================
484
485Service org.bluez
486Interface org.bluez.Service
487Object path [variable prefix]/{hci0,hci1,...}
488
489Methods uint32 AddRecord(string record)
490
491 Adds a new service record from the XML description
492 and returns the assigned record handle.
493
494 Possible errors: org.bluez.Error.InvalidArguments
495 org.bluez.Error.Failed
496
497 void UpdateRecord(uint32 handle, string record)
498
499 Updates a given service record provided in the
500 XML format.
501
502 Possible errors: org.bluez.Error.InvalidArguments
503 org.bluez.Error.NotAvailable
504 org.bluez.Error.Failed
505
506 void RemoveRecord(uint32 handle)
507
508 Remove a service record identified by its handle.
509
510 It is only possible to remove service records that
511 where added by the current connection.
512
513 Possible errors: org.bluez.Error.InvalidArguments
514 org.bluez.Error.NotAuthorized
515 org.bluez.Error.DoesNotExist
516 org.bluez.Error.Failed
517
518 void RequestAuthorization(string address, uint32 handle)
519
520 Request an authorization for an incoming connection
521 for a specific service record. The service record
522 needs to be registered via AddRecord first.
523
524 Possible errors: org.bluez.Error.InvalidArguments
525 org.bluez.Error.NotAuthorized
526 org.bluez.Error.DoesNotExist
527 org.bluez.Error.Failed
528
529 void CancelAuthorization()
530
531 Possible errors: org.bluez.Error.InvalidArguments
532 org.bluez.Error.NotAuthorized
533 org.bluez.Error.DoesNotExist
534 org.bluez.Error.Failed
535 Maxim Krasnyansky <maxk@qualcomm.com>
536Marcel Holtmann <marcel@holtmann.org>
537Stephen Crane <steve.crane@rococosoft.com>
538Jean Tourrilhes <jt@hpl.hp.com>
539Jan Beutel <j.beutel@ieee.org>
540Ilguiz Latypov <ilatypov@superbt.com>
541Thomas Moser <thomas.moser@tmoser.ch>
542Nils Faerber <nils@kernelconcepts.de>
543Martin Leopold <martin@leopold.dk>
544Wolfgang Heidrich <wolfgang.heidrich@esk.fhg.de>
545Fabrizio Gennari <fabrizio.gennari@philips.com>
546Brad Midgley <bmidgley@xmission.com>
547Henryk Ploetz <henryk@ploetzli.ch>
548Philip Blundell <pb@nexus.co.uk>
549Johan Hedberg <johan.hedberg@intel.com>
550Claudio Takahasi <claudio.takahasi@indt.org.br>
551Eduardo Rocha <eduardo.rocha@indt.org.br>
552Denis Kenzior <denis.kenzior@trolltech.com>
553Frederic Dalleau <frederic.dalleau@access-company.com>
554Frederic Danis <frederic.danis@access-company.com>
555Luiz Augusto von Dentz <luiz.dentz@gmail.com>
556Fabien Chevalier <fabchevalier@free.fr>
557Ohad Ben-Cohen <ohad@bencohen.org>
558Daniel Gollub <dgollub@suse.de>
559Tom Patzig <tpatzig@suse.de>
560Kai Vehmanen <kai.vehmanen@nokia.com>
561Vinicius Gomes <vinicius.gomes@openbossa.org>
562Alok Barsode <alok.barsode@azingo.com>
563Bastien Nocera <hadess@hadess.net>
564Albert Huang <albert@csail.mit.edu>
565Glenn Durfee <gdurfee@google.com>
566David Woodhouse <david.woodhouse@intel.com>
567Christian Hoene <hoene@uni-tuebingen.de>
568Pekka Pessi <pekka.pessi@nokia.com>
569Siarhei Siamashka <siarhei.siamashka@nokia.com>
570Nick Pelly <npelly@google.com>
571Lennart Poettering <lennart@poettering.net>
572Gustavo F. Padovan <padovan@profusion.mobi>
573Marc-Andre Lureau <marc-andre.lureau@nokia.com>
574Bea Lam <bea.lam@nokia.com>
575Zygo Blaxell <zygo.blaxell@xandros.com>
576Forrest Zhao <forrest.zhao@intel.com>
577Scott Talbot <psyc@stalbot.com>
578Ilya Rubtsov <lusyaru@gmail.com>
579Mario Limonciello <mario_limonciello@dell.com>
580Filippo Giunchedi <filippo@esaurito.net>
581Jaikumar Ganesh <jaikumar@google.com>
582Elvis Pfutzenreuter <epx@signove.com>
583Santiago Carot-Nemesio <scarot@libresoft.es>
584José Antonio Santos Cadenas <jcaden@libresoft.es>
585Francisco Alecrim <francisco.alecrim@openbossa.org>
586Daniel Orstadius <daniel.orstadius@gmail.com>
587Anderson Briglia <anderson.briglia@openbossa.org>
588Anderson Lizardo <anderson.lizardo@openbossa.org>
589Bruna Moreira <bruna.moreira@openbossa.org>
590Brian Gix <bgix@codeaurora.org>
591Andre Guedes <andre.guedes@openbossa.org>
592Sheldon Demario <sheldon.demario@openbossa.org>
593Lucas De Marchi <lucas.demarchi@profusion.mobi>
594Szymon Janc <szymon.janc@tieto.com>
595 This package was debianized by Edd Dumbill <edd@usefulinc.com> on
596Sat, 13 Apr 2002 16:09:02 +0100.
597
598It was downloaded from http://www.bluez.org/
599
600BlueZ - Bluetooth protocol stack for Linux
601
602Copyright:
603 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
604 Copyright (C) 2006-2009 Nokia Corporation
605 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
606 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
607 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
608 Copyright (C) 2007-2008 Texas Instruments, Inc.
609 Copyright (C) 2000-2005 CSR Ltd.
610 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
611 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
612 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
613 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
614 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
615 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
616 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
617 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
618 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
619 Copyright (C) 2000-2001 Qualcomm Incorporated
620 Copyright (C) 2008 Joao Paulo Rechi Vita
621 Copyright (C) 2009 Lennart Poettering
622 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
623 Copyright (C) 2009 Intel Corporation
624
625License:
626 audio/
627 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
628 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
629 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
630 unix.c unix.h
631
632 License: GPL version 2 or any later version
633
634 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
635 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
636 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
637 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
638 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
639 ipc.c ipc.h rtp.h
640 ipctest.c
641
642 License: LGPL version 2.1 or any later version
643
644 sbc/
645 formats.h sbcdec.c sbcenc.c sbcinfo.c
646 sbctester.c
647
648 License: GPL version 2 or any later version
649
650 sbc.c sbc.h
651 sbc_math.h sbc_primitives.c sbc_primitives.h
652 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
653 sbc_primitives_neon.h sbc_tables.h
654
655 License: LGPL version 2.1 or any later version
656
657 tools/
658 ubcsp.c ubcsp.h
659
660 License: MIT License
661
662 Permission is hereby granted, free of charge, to any person
663 obtaining a copy of this software and associated documentation
664 files (the "Software"), to deal in the Software without
665 restriction, including without limitation the rights to use,
666 copy, modify, merge, publish, distribute, sublicense, and/or sell
667 copies of the Software, and to permit persons to whom the
668 Software is furnished to do so, subject to the following
669 conditions:
670
671 The above copyright notice and this permission notice shall be
672 included in all copies or substantial portions of the Software.
673
674 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
675 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
676 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
677 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
678 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
679 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
680 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
681 OTHER DEALINGS IN THE SOFTWARE.
682
683 avctrl.c bccmd.c avinfo.c
684 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
685 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
686 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
687 hciattach_ti.c
688 hciattach.c hciconfig.c hcitool.c l2ping.c
689 hcisecfilter.c sdptool.c
690
691 License: GPL version 2 or any later version
692
693 doc/
694 All files.
695
696 License: GFDL version 1.1 or any later version
697 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
698
699 other:
700 License: GPL version 2 or any later version
701
702On Debian GNU/Linux systems, the complete text of the GNU General Public
703License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
704General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
705the GNU Free Documentation License can be found in
706`/usr/share/common-licenses/GFDL'.
707 BlueZ - Bluetooth protocol stack for Linux
708******************************************
709
710Copyright (C) 2000-2001 Qualcomm Incorporated
711Copyright (C) 2002-2003 Maxim Krasnyansky <maxk@qualcomm.com>
712Copyright (C) 2002-2010 Marcel Holtmann <marcel@holtmann.org>
713
714
715Compilation and installation
716============================
717
718In order to compile Bluetooth utilities you need following software packages:
719 - Linux Bluetooth protocol stack (BlueZ)
720 - GCC compiler
721 - D-Bus library
722 - GLib library
723 - USB library (optional)
724 - Lexical Analyzer (flex, lex)
725 - YACC (yacc, bison, byacc)
726
727To configure run:
728 ./configure --prefix=/usr --mandir=/usr/share/man \
729 --sysconfdir=/etc --localstatedir=/var --libexecdir=/lib
730
731Configure automatically searches for all required components and packages.
732
733To compile and install run:
734 make && make install
735
736
737Information
738===========
739
740Mailing lists:
741 linux-bluetooth@vger.kernel.org
742
743For additional information about the project visit BlueZ web site:
744 http://www.bluez.org
745 This package was debianized by Edd Dumbill <edd@usefulinc.com> on
746Sat, 13 Apr 2002 16:09:02 +0100.
747
748It was downloaded from http://www.bluez.org/
749
750BlueZ - Bluetooth protocol stack for Linux
751
752Copyright:
753 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
754 Copyright (C) 2006-2009 Nokia Corporation
755 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
756 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
757 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
758 Copyright (C) 2007-2008 Texas Instruments, Inc.
759 Copyright (C) 2000-2005 CSR Ltd.
760 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
761 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
762 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
763 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
764 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
765 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
766 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
767 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
768 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
769 Copyright (C) 2000-2001 Qualcomm Incorporated
770 Copyright (C) 2008 Joao Paulo Rechi Vita
771 Copyright (C) 2009 Lennart Poettering
772 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
773 Copyright (C) 2009 Intel Corporation
774
775License:
776 audio/
777 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
778 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
779 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
780 unix.c unix.h
781
782 License: GPL version 2 or any later version
783
784 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
785 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
786 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
787 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
788 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
789 ipc.c ipc.h rtp.h
790 ipctest.c
791
792 License: LGPL version 2.1 or any later version
793
794 sbc/
795 formats.h sbcdec.c sbcenc.c sbcinfo.c
796 sbctester.c
797
798 License: GPL version 2 or any later version
799
800 sbc.c sbc.h
801 sbc_math.h sbc_primitives.c sbc_primitives.h
802 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
803 sbc_primitives_neon.h sbc_tables.h
804
805 License: LGPL version 2.1 or any later version
806
807 tools/
808 ubcsp.c ubcsp.h
809
810 License: MIT License
811
812 Permission is hereby granted, free of charge, to any person
813 obtaining a copy of this software and associated documentation
814 files (the "Software"), to deal in the Software without
815 restriction, including without limitation the rights to use,
816 copy, modify, merge, publish, distribute, sublicense, and/or sell
817 copies of the Software, and to permit persons to whom the
818 Software is furnished to do so, subject to the following
819 conditions:
820
821 The above copyright notice and this permission notice shall be
822 included in all copies or substantial portions of the Software.
823
824 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
825 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
826 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
827 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
828 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
829 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
830 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
831 OTHER DEALINGS IN THE SOFTWARE.
832
833 avctrl.c bccmd.c avinfo.c
834 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
835 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
836 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
837 hciattach_ti.c
838 hciattach.c hciconfig.c hcitool.c l2ping.c
839 hcisecfilter.c sdptool.c
840
841 License: GPL version 2 or any later version
842
843 doc/
844 All files.
845
846 License: GFDL version 1.1 or any later version
847 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
848
849 other:
850 License: GPL version 2 or any later version
851
852On Debian GNU/Linux systems, the complete text of the GNU General Public
853License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
854General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
855the GNU Free Documentation License can be found in
856`/usr/share/common-licenses/GFDL'.
857 This package was debianized by Edd Dumbill <edd@usefulinc.com> on
858Sat, 13 Apr 2002 16:09:02 +0100.
859
860It was downloaded from http://www.bluez.org/
861
862BlueZ - Bluetooth protocol stack for Linux
863
864Copyright:
865 Copyright (C) 2001-2009 Marcel Holtmann <marcel@holtmann.org>
866 Copyright (C) 2006-2009 Nokia Corporation
867 Copyright (C) 2000-2003 Maxim Krasnyansky <maxk@qualcomm.com>
868 Copyright (C) 2002-2003 Jean Tourrilhes <jt@hpl.hp.com>
869 Copyright (C) 2007-2008 Frederic Dalleau <fdalleau@free.fr>
870 Copyright (C) 2007-2008 Texas Instruments, Inc.
871 Copyright (C) 2000-2005 CSR Ltd.
872 Copyright (C) 2005-2008 Brad Midgley <bmidgley@xmission.com>
873 Copyright (C) 2007-2008 David Stockwell <dstockwell@frequency-one.com>
874 Copyright (C) 2007-2008 Fabien Chevalier <fabchevalier@free.fr>
875 Copyright (C) 2005-2006 Claudio Takahasi <claudio.takahasi@indt.org.br>
876 Copyright (C) 2006-2007 Luiz von Dentz <luiz.dentz@indt.org.br>
877 Copyright (C) 2005-2007 Johan Hedberg <johan.hedberg@nokia.com>
878 Copyright (C) 2005-2006 Brad Midgley <bmidgley@xmission.com>
879 Copyright (C) 2004-2005 Henryk Ploetz <henryk@ploetzli.ch>
880 Copyright (C) 2002-2003 Stephen Crane <steve.crane@rococosoft.com>
881 Copyright (C) 2000-2001 Qualcomm Incorporated
882 Copyright (C) 2008 Joao Paulo Rechi Vita
883 Copyright (C) 2009 Lennart Poettering
884 Copyright (C) 2004 Scott James Remnant <scott@netsplit.com>
885 Copyright (C) 2009 Intel Corporation
886
887License:
888 audio/
889 a2dp.c a2dp.h avdtp.c avdtp.h control.c control.h device.c device.h
890 gateway.c gateway.h headset.c headset.h main.c manager.c manager.h
891 sink.c sink.h telephony-dummy.c telephony-maemo.c telephony.h
892 unix.c unix.h
893
894 License: GPL version 2 or any later version
895
896 gsta2dpsink.c gsta2dpsink.h gstavdtpsink.c
897 gstavdtpsink.h gstbluetooth.c gstrtpsbcpay.c gstrtpsbcpay.h
898 gstsbcdec.c gstsbcdec.h gstsbcenc.c gstsbcenc.h
899 gstsbcparse.c gstsbcparse.h gstsbcutil.c gstsbcutil.h
900 pcm_bluetooth.c gstbluetooth.c: ctl_bluetooth.c
901 ipc.c ipc.h rtp.h
902 ipctest.c
903
904 License: LGPL version 2.1 or any later version
905
906 sbc/
907 formats.h sbcdec.c sbcenc.c sbcinfo.c
908 sbctester.c
909
910 License: GPL version 2 or any later version
911
912 sbc.c sbc.h
913 sbc_math.h sbc_primitives.c sbc_primitives.h
914 sbc_primitives_mmx.c sbc_primitives_mmx.h sbc_primitives_neon.c
915 sbc_primitives_neon.h sbc_tables.h
916
917 License: LGPL version 2.1 or any later version
918
919 tools/
920 ubcsp.c ubcsp.h
921
922 License: MIT License
923
924 Permission is hereby granted, free of charge, to any person
925 obtaining a copy of this software and associated documentation
926 files (the "Software"), to deal in the Software without
927 restriction, including without limitation the rights to use,
928 copy, modify, merge, publish, distribute, sublicense, and/or sell
929 copies of the Software, and to permit persons to whom the
930 Software is furnished to do so, subject to the following
931 conditions:
932
933 The above copyright notice and this permission notice shall be
934 included in all copies or substantial portions of the Software.
935
936 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
937 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
938 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
939 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
940 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
941 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
942 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
943 OTHER DEALINGS IN THE SOFTWARE.
944
945 avctrl.c bccmd.c avinfo.c
946 ciptool.c csr.c csr.h csr_3wire.c csr_bcsp.c csr_h4.c
947 csr_hci.c csr_usb.c dfu.c dfu.h dfubabel.c dfutool.c
948 hciattach.h hciattach_st.c hciattach_tialt.c hid2hci.c ppporc.c
949 hciattach_ti.c
950 hciattach.c hciconfig.c hcitool.c l2ping.c
951 hcisecfilter.c sdptool.c
952
953 License: GPL version 2 or any later version
954
955 doc/
956 All files.
957
958 License: GFDL version 1.1 or any later version
959 No Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
960
961 other:
962 License: GPL version 2 or any later version
963
964On Debian GNU/Linux systems, the complete text of the GNU General Public
965License can be found in `/usr/share/common-licenses/GPL-2', the GNU Lesser
966General Public License can be found in `/usr/share/common-licenses/LGPL-2.1' and
967the GNU Free Documentation License can be found in
968`/usr/share/common-licenses/GFDL'.
969
970 bluez-cups
971
972To configure a Bluetooth printer, set it up in CUPS like it was connected to
973your parallel or USB port. Then edit your /etc/cups/printers.conf and replace
974the device URI with a bluetooth one.
975
976The printer's URI will look something like this: bluetooth://00408C5E5DA4/spp
977If your printer uses HCRP (hardcopy cable replacement protocol) then remove
978the "/spp" from the end. SPP is serial port protocol.
979
980 -- Edd Dumbill <ejad@debian.org>, Fri Jul 16 19:25:21 BST 2004
981 This package was debianized by Scott Ritchie <scott@open-vote.org> on
982Wed, 03 Jun 2009 10:48:48 -0700.
983
984Copyright:
985
986 Andreas Røsdal <andreasr@gnome.org>:
987 gnome-games/gnometris/pixmaps/gnometris.svg GPL-2.0+ and CC-BY-SA-3.0+
988 Mads Rosendahl Hansen <madsrh@gmail.com>:
989 gnome-games/pixmaps/baize.png GPL-2.0+
990 gnome-games/pixmaps/slot.svg GPL-2.0+
991 gnome-games-common/cards/gnomangelo_bitmap.svg GPL-2.0+
992 gnome-games/mahjongg/pixmaps/postmodern.svg GPL-2.0+
993
994
995License: CC-BY-SA-3.0+
996
997 THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
998
999BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
1000
10011. Definitions
1002
1003 1. "Adaptation" means a work based upon the Work, or upon the Work and other pre-existing works, such as a translation, adaptation, derivative work, arrangement of music or other alterations of a literary or artistic work, or phonogram or performance and includes cinematographic adaptations or any other form in which the Work may be recast, transformed, or adapted including in any form recognizably derived from the original, except that a work that constitutes a Collection will not be considered an Adaptation for the purpose of this License. For the avoidance of doubt, where the Work is a musical work, performance or phonogram, the synchronization of the Work in timed-relation with a moving image ("synching") will be considered an Adaptation for the purpose of this License.
1004 2. "Collection" means a collection of literary or artistic works, such as encyclopedias and anthologies, or performances, phonograms or broadcasts, or other works or subject matter other than works listed in Section 1(f) below, which, by reason of the selection and arrangement of their contents, constitute intellectual creations, in which the Work is included in its entirety in unmodified form along with one or more other contributions, each constituting separate and independent works in themselves, which together are assembled into a collective whole. A work that constitutes a Collection will not be considered an Adaptation (as defined below) for the purposes of this License.
1005 3. "Creative Commons Compatible License" means a license that is listed at http://creativecommons.org/compatiblelicenses that has been approved by Creative Commons as being essentially equivalent to this License, including, at a minimum, because that license: (i) contains terms that have the same purpose, meaning and effect as the License Elements of this License; and, (ii) explicitly permits the relicensing of adaptations of works made available under that license under this License or a Creative Commons jurisdiction license with the same License Elements as this License.
1006 4. "Distribute" means to make available to the public the original and copies of the Work or Adaptation, as appropriate, through sale or other transfer of ownership.
1007 5. "License Elements" means the following high-level license attributes as selected by Licensor and indicated in the title of this License: Attribution, ShareAlike.
1008 6. "Licensor" means the individual, individuals, entity or entities that offer(s) the Work under the terms of this License.
1009 7. "Original Author" means, in the case of a literary or artistic work, the individual, individuals, entity or entities who created the Work or if no individual or entity can be identified, the publisher; and in addition (i) in the case of a performance the actors, singers, musicians, dancers, and other persons who act, sing, deliver, declaim, play in, interpret or otherwise perform literary or artistic works or expressions of folklore; (ii) in the case of a phonogram the producer being the person or legal entity who first fixes the sounds of a performance or other sounds; and, (iii) in the case of broadcasts, the organization that transmits the broadcast.
1010 8. "Work" means the literary and/or artistic work offered under the terms of this License including without limitation any production in the literary, scientific and artistic domain, whatever may be the mode or form of its expression including digital form, such as a book, pamphlet and other writing; a lecture, address, sermon or other work of the same nature; a dramatic or dramatico-musical work; a choreographic work or entertainment in dumb show; a musical composition with or without words; a cinematographic work to which are assimilated works expressed by a process analogous to cinematography; a work of drawing, painting, architecture, sculpture, engraving or lithography; a photographic work to which are assimilated works expressed by a process analogous to photography; a work of applied art; an illustration, map, plan, sketch or three-dimensional work relative to geography, topography, architecture or science; a performance; a broadcast; a phonogram; a compilation of data to the extent it is protected as a copyrightable work; or a work performed by a variety or circus performer to the extent it is not otherwise considered a literary or artistic work.
1011 9. "You" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.
1012 10. "Publicly Perform" means to perform public recitations of the Work and to communicate to the public those public recitations, by any means or process, including by wire or wireless means or public digital performances; to make available to the public Works in such a way that members of the public may access these Works from a place and at a place individually chosen by them; to perform the Work to the public by any means or process and the communication to the public of the performances of the Work, including by public digital performance; to broadcast and rebroadcast the Work by any means including signs, sounds or images.
1013 11. "Reproduce" means to make copies of the Work by any means including without limitation by sound or visual recordings and the right of fixation and reproducing fixations of the Work, including storage of a protected performance or phonogram in digital form or other electronic medium.
1014
10152. Fair Dealing Rights. Nothing in this License is intended to reduce, limit, or restrict any uses free from copyright or rights arising from limitations or exceptions that are provided for in connection with the copyright protection under copyright law or other applicable laws.
1016
10173. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
1018
1019 1. to Reproduce the Work, to incorporate the Work into one or more Collections, and to Reproduce the Work as incorporated in the Collections;
1020 2. to create and Reproduce Adaptations provided that any such Adaptation, including any translation in any medium, takes reasonable steps to clearly label, demarcate or otherwise identify that changes were made to the original Work. For example, a translation could be marked "The original work was translated from English to Spanish," or a modification could indicate "The original work has been modified.";
1021 3. to Distribute and Publicly Perform the Work including as incorporated in Collections; and,
1022 4. to Distribute and Publicly Perform Adaptations.
1023 5.
1024
1025 For the avoidance of doubt:
1026 1. Non-waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme cannot be waived, the Licensor reserves the exclusive right to collect such royalties for any exercise by You of the rights granted under this License;
1027 2. Waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme can be waived, the Licensor waives the exclusive right to collect such royalties for any exercise by You of the rights granted under this License; and,
1028 3. Voluntary License Schemes. The Licensor waives the right to collect royalties, whether individually or, in the event that the Licensor is a member of a collecting society that administers voluntary licensing schemes, via that society, from any exercise by You of the rights granted under this License.
1029
1030The above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. Subject to Section 8(f), all rights not expressly granted by Licensor are hereby reserved.
1031
10324. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
1033
1034 1. You may Distribute or Publicly Perform the Work only under the terms of this License. You must include a copy of, or the Uniform Resource Identifier (URI) for, this License with every copy of the Work You Distribute or Publicly Perform. You may not offer or impose any terms on the Work that restrict the terms of this License or the ability of the recipient of the Work to exercise the rights granted to that recipient under the terms of the License. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties with every copy of the Work You Distribute or Publicly Perform. When You Distribute or Publicly Perform the Work, You may not impose any effective technological measures on the Work that restrict the ability of a recipient of the Work from You to exercise the rights granted to that recipient under the terms of the License. This Section 4(a) applies to the Work as incorporated in a Collection, but this does not require the Collection apart from the Work itself to be made subject to the terms of this License. If You create a Collection, upon notice from any Licensor You must, to the extent practicable, remove from the Collection any credit as required by Section 4(c), as requested. If You create an Adaptation, upon notice from any Licensor You must, to the extent practicable, remove from the Adaptation any credit as required by Section 4(c), as requested.
1035 2. You may Distribute or Publicly Perform an Adaptation only under the terms of: (i) this License; (ii) a later version of this License with the same License Elements as this License; (iii) a Creative Commons jurisdiction license (either this or a later license version) that contains the same License Elements as this License (e.g., Attribution-ShareAlike 3.0 US)); (iv) a Creative Commons Compatible License. If you license the Adaptation under one of the licenses mentioned in (iv), you must comply with the terms of that license. If you license the Adaptation under the terms of any of the licenses mentioned in (i), (ii) or (iii) (the "Applicable License"), you must comply with the terms of the Applicable License generally and the following provisions: (I) You must include a copy of, or the URI for, the Applicable License with every copy of each Adaptation You Distribute or Publicly Perform; (II) You may not offer or impose any terms on the Adaptation that restrict the terms of the Applicable License or the ability of the recipient of the Adaptation to exercise the rights granted to that recipient under the terms of the Applicable License; (III) You must keep intact all notices that refer to the Applicable License and to the disclaimer of warranties with every copy of the Work as included in the Adaptation You Distribute or Publicly Perform; (IV) when You Distribute or Publicly Perform the Adaptation, You may not impose any effective technological measures on the Adaptation that restrict the ability of a recipient of the Adaptation from You to exercise the rights granted to that recipient under the terms of the Applicable License. This Section 4(b) applies to the Adaptation as incorporated in a Collection, but this does not require the Collection apart from the Adaptation itself to be made subject to the terms of the Applicable License.
1036 3. If You Distribute, or Publicly Perform the Work or any Adaptations or Collections, You must, unless a request has been made pursuant to Section 4(a), keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or if the Original Author and/or Licensor designate another party or parties (e.g., a sponsor institute, publishing entity, journal) for attribution ("Attribution Parties") in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; (ii) the title of the Work if supplied; (iii) to the extent reasonably practicable, the URI, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and (iv) , consistent with Ssection 3(b), in the case of an Adaptation, a credit identifying the use of the Work in the Adaptation (e.g., "French translation of the Work by Original Author," or "Screenplay based on original Work by Original Author"). The credit required by this Section 4(c) may be implemented in any reasonable manner; provided, however, that in the case of a Adaptation or Collection, at a minimum such credit will appear, if a credit for all contributing authors of the Adaptation or Collection appears, then as part of these credits and in a manner at least as prominent as the credits for the other contributing authors. For the avoidance of doubt, You may only use the credit required by this Section for the purpose of attribution in the manner set out above and, by exercising Your rights under this License, You may not implicitly or explicitly assert or imply any connection with, sponsorship or endorsement by the Original Author, Licensor and/or Attribution Parties, as appropriate, of You or Your use of the Work, without the separate, express prior written permission of the Original Author, Licensor and/or Attribution Parties.
1037 4. Except as otherwise agreed in writing by the Licensor or as may be otherwise permitted by applicable law, if You Reproduce, Distribute or Publicly Perform the Work either by itself or as part of any Adaptations or Collections, You must not distort, mutilate, modify or take other derogatory action in relation to the Work which would be prejudicial to the Original Author's honor or reputation. Licensor agrees that in those jurisdictions (e.g. Japan), in which any exercise of the right granted in Section 3(b) of this License (the right to make Adaptations) would be deemed to be a distortion, mutilation, modification or other derogatory action prejudicial to the Original Author's honor and reputation, the Licensor will waive or not assert, as appropriate, this Section, to the fullest extent permitted by the applicable national law, to enable You to reasonably exercise Your right under Section 3(b) of this License (right to make Adaptations) but not otherwise.
1038
10395. Representations, Warranties and Disclaimer
1040
1041UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
1042
10436. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
1044
10457. Termination
1046
1047 1. This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Adaptations or Collections from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.
1048 2. Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
1049
10508. Miscellaneous
1051
1052 1. Each time You Distribute or Publicly Perform the Work or a Collection, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.
1053 2. Each time You Distribute or Publicly Perform an Adaptation, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.
1054 3. If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
1055 4. No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.
1056 5. This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.
1057 6. The rights granted under, and the subject matter referenced, in this License were drafted utilizing the terminology of the Berne Convention for the Protection of Literary and Artistic Works (as amended on September 28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms Treaty of 1996 and the Universal Copyright Convention (as revised on July 24, 1971). These rights and subject matter take effect in the relevant jurisdiction in which the License terms are sought to be enforced according to the corresponding provisions of the implementation of those treaty provisions in the applicable national law. If the standard suite of rights granted under applicable copyright law includes additional rights not granted under this License, such additional rights are deemed to be included in the License; this License is not intended to restrict the license of any rights under applicable law.
1058
1059
1060The Debian packaging is copyright 2009, Scott Ritchie <scott@open-vote.org> and
1061is licensed under the GPL-2.0+
1062
1063On Debian systems, the complete text of the GNU General
1064Public License can be found in `/usr/share/common-licenses/GPL-2'.
1065 This package was debianized by Ondřej Surý <ondrej@debian.org> on
1066Fri, 12 May 2006 15:46:36 +0200.
1067
1068It was downloaded from:
1069 http://ftp.gnome.org/pub/GNOME/sources/brasero/
1070
1071Upstream Author:
1072 Philippe Rouquier <bonfire-app@wanadoo.fr>
1073
1074Copyright:
1075
1076 Copyright © 2005-2009 Philippe Rouquier
1077 Copyright © 2008 Lin Ma
1078 Copyright © 2008 Joe Marcus Clarke
1079 Copyright © 2009 Joan Duran
1080 Copyright © 2005 William Jon McCann
1081 Copyright © 2003, 2007 Novell, Inc.
1082 Copyright © 1999-2004 Red Hat, Inc.
1083 Copyright © 2008 Luis Medinas
1084 Copyright © 2006 Paolo Borelli
1085 Copyright © 2001 George Lebl
1086
1087
1088License for Brasero:
1089
1090 Brasero is free software: you can redistribute it and/or modify it
1091 under the terms of the GNU General Public License as published by the
1092 Free Software Foundation, either version 3 of the License, or
1093 (at your option) any later version.
1094
1095 Brasero is distributed in the hope that it will be useful, but
1096 WITHOUT ANY WARRANTY; without even the implied warranty of
1097 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
1098 See the GNU General Public License for more details.
1099
1100 You should have received a copy of the GNU General Public License along
1101 with this program. If not, see <http://www.gnu.org/licenses/>.
1102
1103On Debian systems, the complete text of the GNU General
1104Public License can be found in `/usr/share/common-licenses/GPL-3'.
1105
1106
1107libbrasero-media is licensed under the following terms:
1108
1109 This package is free software; you can redistribute it and/or modify
1110 it under the terms of the GNU General Public License as published by
1111 the Free Software Foundation; either version 2 of the License, or
1112 (at your option) any later version.
1113
1114 This package is distributed in the hope that it will be useful,
1115 but WITHOUT ANY WARRANTY; without even the implied warranty of
1116 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1117 GNU General Public License for more details.
1118
1119 You should have received a copy of the GNU General Public License
1120 along with this package; if not, write to the Free Software
1121 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1122
1123 The Libbrasero-media authors hereby grant permission for non-GPL compatible
1124 GStreamer plugins to be used and distributed together with GStreamer
1125 and Libbrasero-media. This permission is above and beyond the permissions
1126 granted by the GPL license by which Libbrasero-media is covered. If
1127 you modify this code you may extend this exception to your version of
1128 the code, but you are not obligated to do so. If you do not wish to
1129 do so, delete this exception statement from your version.
1130
1131On Debian systems, the complete text of the GNU General
1132Public License can be found in `/usr/share/common-licenses/GPL-2'.
1133
1134
1135License for src/egg* and src/baobab*:
1136
1137 This package is free software; you can redistribute it and/or
1138 modify it under the terms of the GNU Lesser General Public
1139 License as published by the Free Software Foundation; either
1140 version 2 of the License, or (at your option) any later version.
1141
1142 This package is distributed in the hope that it will be useful,
1143 but WITHOUT ANY WARRANTY; without even the implied warranty of
1144 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1145 Lesser General Public License for more details.
1146
1147 You should have received a copy of the GNU Lesser General Public
1148 License along with this package; if not, write to the Free Software
1149 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1150
1151On Debian systems, the complete text of the GNU Lesser General
1152Public License can be found in `/usr/share/common-licenses/LGPL-2'.
1153
1154The help is licensed under the GFDL:
1155
1156 Permission is granted to copy, distribute and/or modify this
1157 document under the terms of the GNU Free Documentation
1158 License (GFDL), Version 1.1 or any later version published
1159 by the Free Software Foundation with no Invariant Sections,
1160 no Front-Cover Texts, and no Back-Cover Texts.
1161
1162On Debian systems, the complete text of the GNU Lesser General
1163Public License can be found in `/usr/share/common-licenses/GFDL'.
1164 This package was debianized by Ondřej Surý <ondrej@debian.org> on
1165Fri, 12 May 2006 15:46:36 +0200.
1166
1167It was downloaded from:
1168 http://ftp.gnome.org/pub/GNOME/sources/brasero/
1169
1170Upstream Author:
1171 Philippe Rouquier <bonfire-app@wanadoo.fr>
1172
1173Copyright:
1174
1175 Copyright © 2005-2009 Philippe Rouquier
1176 Copyright © 2008 Lin Ma
1177 Copyright © 2008 Joe Marcus Clarke
1178 Copyright © 2009 Joan Duran
1179 Copyright © 2005 William Jon McCann
1180 Copyright © 2003, 2007 Novell, Inc.
1181 Copyright © 1999-2004 Red Hat, Inc.
1182 Copyright © 2008 Luis Medinas
1183 Copyright © 2006 Paolo Borelli
1184 Copyright © 2001 George Lebl
1185
1186
1187License for Brasero:
1188
1189 Brasero is free software: you can redistribute it and/or modify it
1190 under the terms of the GNU General Public License as published by the
1191 Free Software Foundation, either version 3 of the License, or
1192 (at your option) any later version.
1193
1194 Brasero is distributed in the hope that it will be useful, but
1195 WITHOUT ANY WARRANTY; without even the implied warranty of
1196 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
1197 See the GNU General Public License for more details.
1198
1199 You should have received a copy of the GNU General Public License along
1200 with this program. If not, see <http://www.gnu.org/licenses/>.
1201
1202On Debian systems, the complete text of the GNU General
1203Public License can be found in `/usr/share/common-licenses/GPL-3'.
1204
1205
1206libbrasero-media is licensed under the following terms:
1207
1208 This package is free software; you can redistribute it and/or modify
1209 it under the terms of the GNU General Public License as published by
1210 the Free Software Foundation; either version 2 of the License, or
1211 (at your option) any later version.
1212
1213 This package is distributed in the hope that it will be useful,
1214 but WITHOUT ANY WARRANTY; without even the implied warranty of
1215 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1216 GNU General Public License for more details.
1217
1218 You should have received a copy of the GNU General Public License
1219 along with this package; if not, write to the Free Software
1220 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1221
1222 The Libbrasero-media authors hereby grant permission for non-GPL compatible
1223 GStreamer plugins to be used and distributed together with GStreamer
1224 and Libbrasero-media. This permission is above and beyond the permissions
1225 granted by the GPL license by which Libbrasero-media is covered. If
1226 you modify this code you may extend this exception to your version of
1227 the code, but you are not obligated to do so. If you do not wish to
1228 do so, delete this exception statement from your version.
1229
1230On Debian systems, the complete text of the GNU General
1231Public License can be found in `/usr/share/common-licenses/GPL-2'.
1232
1233
1234License for src/egg* and src/baobab*:
1235
1236 This package is free software; you can redistribute it and/or
1237 modify it under the terms of the GNU Lesser General Public
1238 License as published by the Free Software Foundation; either
1239 version 2 of the License, or (at your option) any later version.
1240
1241 This package is distributed in the hope that it will be useful,
1242 but WITHOUT ANY WARRANTY; without even the implied warranty of
1243 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1244 Lesser General Public License for more details.
1245
1246 You should have received a copy of the GNU Lesser General Public
1247 License along with this package; if not, write to the Free Software
1248 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1249
1250On Debian systems, the complete text of the GNU Lesser General
1251Public License can be found in `/usr/share/common-licenses/LGPL-2'.
1252
1253The help is licensed under the GFDL:
1254
1255 Permission is granted to copy, distribute and/or modify this
1256 document under the terms of the GNU Free Documentation
1257 License (GFDL), Version 1.1 or any later version published
1258 by the Free Software Foundation with no Invariant Sections,
1259 no Front-Cover Texts, and no Back-Cover Texts.
1260
1261On Debian systems, the complete text of the GNU Lesser General
1262Public License can be found in `/usr/share/common-licenses/GFDL'.
1263 AUTHORS:
1264
1265Philippe Rouquier <bonfire-app@wanadoo.fr>
1266
1267Report bugs at:
1268http://bugzilla.gnome.org/enter_bug.cgi?product=brasero
1269 Brasero is a CD/DVD mastering tool for the GNOME Desktop. It is designed to be simple and easy to use.
1270
1271Features:
1272
1273Data CD/DVD:
1274- supports edition of discs contents (remove/move/rename files inside directories)
1275- can burn data CD/DVD on the fly
1276- automatic filtering for unwanted files (hidden files, broken/recursive symlinks, files not conforming to joliet standard, ...)
1277- supports multisession
1278- supports joliet extension
1279- can write the image to the hard drive
1280
1281Audio CD:
1282- write CD-TEXT information (automatically found thanks to gstreamer)
1283- supports the edition of CD-TEXT information
1284- can burn audio CD on the fly
1285- can use all audio files handled by GStreamer local installation (ogg, flac, mp3, ...)
1286- can search for audio files inside dropped folders
1287- can insert a pause
1288- can split a track
1289
1290CD/DVD copy:
1291- can copy a CD/DVD to the hard drive
1292- can copy DVD and CD on the fly
1293- supports single-session data DVD
1294- supports any kind of CD
1295- can copy encrypted Video DVDs (needs libdvdcss)
1296
1297Others:
1298- erase CD/DVD
1299- can save/load projects
1300- can burn CD/DVD images and cue files
1301- song, image and video previewer
1302- device detection thanks to HAL
1303- file change notification (requires kernel > 2.6.13)
1304- supports Drag and Drop / Cut'n'Paste from nautilus (and others apps)
1305- can use files on a network as long as the protocol is handled by gnome-vfs
1306- can search for files thanks to beagle (search is based on keywords or on file type)
1307- can display a playlist and its contents (note that playlists are automatically searched through beagle)
1308- all disc IO is done asynchronously to prevent the application from blocking
1309- Brasero default backend is provided by cdrtools/cdrkit but libburn can be used as an alternative
1310
1311
1312Notes on plugins for advanced users
1313
13141. configuration
1315
1316From 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.
1317If 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.
1318You 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".
1319If you set this key to -1 this turns off the plugin.
1320If you set this key to 0 this leaves the internal hardcoded priority - the default that basically lets brasero decide what's best.
1321If 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.
1322
13232. additional note
1324
1325Some 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
1326As examples, from my experience:
1327- growisofs is good at handling DVD+RW and DVD-RW restricted overwrite
1328- cdrdao is best for on the fly CD copying
1329- libburn returns a progress when it blanks/formats
1330
1331
1332Requirements:
1333- gtk+ >= 3.x
1334- gnome 3.x (gio)
1335- gstreamer (>=0.10.0)
1336- libxml2
1337- cdrtools or cdrkit
1338- growisofs
1339- a fairly new kernel (>= 2.6.13 because of inotify) (optional)
1340- cairo
1341- libcanberra
1342- totem (>= 3.0) (optional)
1343- tracker (>= 0.10.0) (optional)
1344- libburn (>=0.4.0) (optional)
1345- libisofs (>=0.6.2) (optional)
1346 This package was debianized by Ondřej Surý <ondrej@debian.org> on
1347Fri, 12 May 2006 15:46:36 +0200.
1348
1349It was downloaded from:
1350 http://ftp.gnome.org/pub/GNOME/sources/brasero/
1351
1352Upstream Author:
1353 Philippe Rouquier <bonfire-app@wanadoo.fr>
1354
1355Copyright:
1356
1357 Copyright © 2005-2009 Philippe Rouquier
1358 Copyright © 2008 Lin Ma
1359 Copyright © 2008 Joe Marcus Clarke
1360 Copyright © 2009 Joan Duran
1361 Copyright © 2005 William Jon McCann
1362 Copyright © 2003, 2007 Novell, Inc.
1363 Copyright © 1999-2004 Red Hat, Inc.
1364 Copyright © 2008 Luis Medinas
1365 Copyright © 2006 Paolo Borelli
1366 Copyright © 2001 George Lebl
1367
1368
1369License for Brasero:
1370
1371 Brasero is free software: you can redistribute it and/or modify it
1372 under the terms of the GNU General Public License as published by the
1373 Free Software Foundation, either version 3 of the License, or
1374 (at your option) any later version.
1375
1376 Brasero is distributed in the hope that it will be useful, but
1377 WITHOUT ANY WARRANTY; without even the implied warranty of
1378 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
1379 See the GNU General Public License for more details.
1380
1381 You should have received a copy of the GNU General Public License along
1382 with this program. If not, see <http://www.gnu.org/licenses/>.
1383
1384On Debian systems, the complete text of the GNU General
1385Public License can be found in `/usr/share/common-licenses/GPL-3'.
1386
1387
1388libbrasero-media is licensed under the following terms:
1389
1390 This package is free software; you can redistribute it and/or modify
1391 it under the terms of the GNU General Public License as published by
1392 the Free Software Foundation; either version 2 of the License, or
1393 (at your option) any later version.
1394
1395 This package is distributed in the hope that it will be useful,
1396 but WITHOUT ANY WARRANTY; without even the implied warranty of
1397 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1398 GNU General Public License for more details.
1399
1400 You should have received a copy of the GNU General Public License
1401 along with this package; if not, write to the Free Software
1402 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1403
1404 The Libbrasero-media authors hereby grant permission for non-GPL compatible
1405 GStreamer plugins to be used and distributed together with GStreamer
1406 and Libbrasero-media. This permission is above and beyond the permissions
1407 granted by the GPL license by which Libbrasero-media is covered. If
1408 you modify this code you may extend this exception to your version of
1409 the code, but you are not obligated to do so. If you do not wish to
1410 do so, delete this exception statement from your version.
1411
1412On Debian systems, the complete text of the GNU General
1413Public License can be found in `/usr/share/common-licenses/GPL-2'.
1414
1415
1416License for src/egg* and src/baobab*:
1417
1418 This package is free software; you can redistribute it and/or
1419 modify it under the terms of the GNU Lesser General Public
1420 License as published by the Free Software Foundation; either
1421 version 2 of the License, or (at your option) any later version.
1422
1423 This package is distributed in the hope that it will be useful,
1424 but WITHOUT ANY WARRANTY; without even the implied warranty of
1425 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1426 Lesser General Public License for more details.
1427
1428 You should have received a copy of the GNU Lesser General Public
1429 License along with this package; if not, write to the Free Software
1430 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
1431
1432On Debian systems, the complete text of the GNU Lesser General
1433Public License can be found in `/usr/share/common-licenses/LGPL-2'.
1434
1435The help is licensed under the GFDL:
1436
1437 Permission is granted to copy, distribute and/or modify this
1438 document under the terms of the GNU Free Documentation
1439 License (GFDL), Version 1.1 or any later version published
1440 by the Free Software Foundation with no Invariant Sections,
1441 no Front-Cover Texts, and no Back-Cover Texts.
1442
1443On Debian systems, the complete text of the GNU Lesser General
1444Public License can be found in `/usr/share/common-licenses/GFDL'.
1445 This directory contains the BRLTTY driver for the Albatross
1446[http://www.tivomatic.fi/html/albatross.html] braille display from Tivomatic
1447[http://www.tivomatic.fi/]. It has been implemented, and is being maintained,
1448by Dave Mielke <dave@mielke.cc> and Sami Haahtinen <ressu@ressukka.net>.
1449
1450
1451The keys on the front of the display are named as depicted below within the
1452documentation for this driver. See the help file for what they do.
1453
1454 +---+ +---+ +------+ +-----------+ +-----------+ +------+ +---+ +---+
1455 |Top| |Bak| | Up | | | | | | Up | |Bak| |Top|
1456 +---+ +---+ +------+ | | | | +------+ +---+ +---+
1457 | Left | | Right |
1458 +---+ +---+ +------+ | | | | +------+ +---+ +---+
1459 |Bot| |Csr| | Down | | | | | | Down | |Csr| |Bot|
1460 +---+ +---+ +------+ +-----------+ +-----------+ +------+ +---+ +---+
1461
1462
1463The keys on the top of the display are named as depicted below within the
1464documentation for this driver. See the help file for what they do.
1465
1466 +---+ +-------+ +---+ +---+ +-------+ +---+
1467 |Hlp| +---+ | Paste | +---+ |Prf| |PrU| +---+ | DifUp | +---+ |PgU|
1468 +---+ |mwp| +-------+ |gwp| +---+ +---+ |iup| +-------+ |idn| +---+
1469 |RF1| |RF2| |RF3| |RF4|
1470 +---+ |ctn| +-------+ |cta| +---+ +---+ |ctl| +-------+ |ctr| +---+
1471 |Lrn| +---+ | Track | +---+ |Stt| |PrD| +---+ | DifDn | +---+ |PgD|
1472 +---+ +-------+ +---+ +---+ +-------+ +---+
1473 Both the keyboard and the serial ports of the Inka should be connected in order
1474to use it with BRLTTY. The Inka itself is capable of communicating entirely via
1475the keyboard port, but the Linux kernel keyboard driver can't handle this.
1476
1477In order to use the Inka with BRLTTY it is necessary to have the latest version
1478(dated 1998) of the firmware. If the Inka says either "mode 1" or "mode 2" at
1479the end of the version number after it's connected to a computer and turned on
1480then it has the necessary firmware. If it doesn't then it'll probably need an
1481upgrade. To do this, contact Baum and give them the serial number of the Inka
1482(which is printed on the under side of the device).
1483
1484The newer firmware supports two modes of operation. Mode 1 uses the old Inka
1485protocol and transfers data at 57,600 baud with non-standard flow control. Mode
14862 uses the new Inka protocol and transfers data at 19,200 baud with no flow
1487control.
1488
1489The Inka defaults to mode 1. This is shown on the braille display when
1490the Inka first initializes or after a soft reset.
1491
1492Before running BRLTTY, change the Inka to mode 2 by pressing tl1+tl2+tr3 (which
1493is the digit 2 represented as a dot-six number). To return to mode 1 (neither
1494necessary nor desirable under Linux), press tl1+tr3 (which is the digit 1
1495represented as a dot-six number). The new mode setting is shown on the display
1496at the end of the line, after the version number and date of the firmware.
1497 ‹ •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´·
1498[©¡¶¾—Âm\(]–6ZW 5ón‰
1499Wé ®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Â¥
1500«JoTܬ¢l€,¨i:(_¨èT0ŸÂê¦ô'óˆà –FÃŒŽÂ7o½©SvöÔÆ5Âo´Âž¿øê¨X8_Š…Uû70u4©‚Ù£°2¦X¨©»gÃ#Ã¥Ã_Âõ¦d r¥Þdšï
1501—ž6uK´{oc
1502¦ÔzajC¼Ã±µ
1503Å“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’}Șžê¯<è
15042<ë)Ô0ÃÄqþUþôø$;êžôu¦n§f‰â⇛Ã裮7L{4÷SȉLÔêìê||3>
1505Cu`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
15064BñFûÙœ0â„¢ZÆ’{¾ ]¤pË%Ã-]lA IضÉK ‰KZœ«ßMóÄS¡«
1507ÈÂoÃ’tû;¤zý¯ÿ#Â_#Â?Û{#®Ã-d·m‚h\
1508ꛣ—Ô²ÓKôõDÄB¯‚¤¯ˆ¾ú¹ÎMa–S†ÃòÃs¿Â¹WÆ’IŸšEÂÃ¥j 3Go¯ÃÚNm’„Ç„ñÙ«þHš…š ÞM&£þp,!Cá `3ÌÈT
1509Â¥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
1510‚zÃß5½žâ€r6îŸÂúÃ<;WÒþú×rTÃæÇTÃMØ›?Õóü8Wgm)E’wANSÔ:„f¹WHtç^kªÂUPýÂÄuâ€h•FÃŽ
1511 C±à ¯;ëcÅó––=VˆÒ‘5ÃÙœÙêÖ çÃòO9z¶¹nTÙö› ¸Q\ŒÄº²
1512S{ÄÊ^—„ø4s‰Z cRÜ_Sòa
1513là ä¦3ð)4ÿ“ƒO?£ÂÂÃÓþÙëN¯ƿôAÑ‹Ó‡Ö÷æçÎâ€Ãž Q7<·Ç©aÉaeܪj1(“qÂHdIan¢TÚCu½ÆD²IM™¶£ø
1514±ÑeB;‡ Ã…i€j·‚¤éܶ¾D«fUµkÂÞ<Ä“¶AWÃñ¤Õ£Aÿü
1515Ô8ú-pÃŽe¹b{gǨ—Ã^@ Ã…y˜õ—ºsMgiPŽ‘yñ7dR‹÷öߤ÷ñà f+€¬üvVñ-¸5S· ÂïÃMú?uÚKÓ²õ
1516ÔfK
1517?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•
1518=PXÅ¡8ÿ~19{õvr3Dâ€â€¡Ã¹N<:•>xöâëCñûŒfÚÇ5£]Å¡]UÚ[`
1519fà 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
1520Vµ(YN[ ¶,!z R>˜°ÞS€=ÕäGw“‹K
1521¸×«K䯈 <ï©·Úf Ü’¿ìÔã¤kÞ´ÂysÃ’^O?C{‰=iƒ¢•áé‰:ë§îÚ§ž¨/º‡Ú!BºÛFÕ¶ ËlŒ»ð<å¶ÃÛ¶{Ñøà BsÇu9Â¥c÷i läÚ¼=°ýH¶ýê Ÿö ÊbÊîþ‰Z>ˆè©…Gh³ÞAñ–Û·n;Û
1522K-åÀ,ý‰#aiKQÅèæsJ4fî¹(,¿IEaid8®•Ÿèe mû‚@JÂðÒÂû÷LÂ/ëצ€ YÖÆz:2'éC {ˉL;„þÂUß«ão•Uß©)b3áïo1A¯K õ öñã?q[®‹äÿ±½ó矇ßf€©ÌR²¡ 0ȉ
1523 „êˤz¨
1524ë‹f‰œÊ÷:߀‰>}ÃÈÂG\fõ¨Ž–ßòø!®·k#RH„Õi'?Ù.sl±Z·á§£°°³˜$‰ÛzÂ
1525Â+Ëj…º$žù•Êpp‰ô©Ãɸ }SÄ M†¾Ébâ€P2/
1526j"§ziéDÃãÇl„ö²„9ÙÎkÂ%Û'ÿ(Ñ@êM
1527ÒïÕUÿ ¿Ôl¯ ui ^ôÔS¤µCÃŒ6㼏WÊ@¾o‘ƒ3]h¿%´Æ²¦NeÉ–Ã
1528Jæ¥R
1529¾4…mÑð› ût+Uh=6pWᇨŒgÖ£³k?o„<±3ßk!¿ÇKˆŒÂâ\Td†Â*ëzÃÇ\Ã'jÎõó8ÉÚådÜŒDË,’û?TU8Å¡]
1530
1531 This driver allows BRLTTY to access braille displays through BrlAPI. Multiple
1532instances of brltty can hence be run, one using the real braille driver, the
1533others accessing it through the API. Each instance of BRLTTY can use a different
1534screen driver thanks to the -x command-line option.
1535
1536
1537For example, in a gnome desktop you can run a second BRLTTY that reads
1538gnome-terminal by running
1539
1540brltty -b ba -x as
1541
1542from your X session.
1543
1544
1545Another example is accessing the Linux console of a remote host:
1546
1547ssh -R 4102:localhost:4101 root@theremotehost brltty -b ba -B host=localhost:1
1548
1549This will forward your local BrlAPI port (4101) to the remote machine (as 4102,
1550i.e. :1), where you can then run brltty and tell it to connect to localhost:1.
1551This will however take complete control of your braille device. To restrict the
1552control to some local console (e.g. console 4), you can use e.g.
1553
1554ssh -R 4102:localhost:4101 root@theremotehost WINDOWPATH=4 brltty -b ba -B host=localhost:1
1555 Adi Dascal <ad@baum.ro>
1556Alex Bernier <alex.bernier@free.fr>
1557Andreas Gross <andi@andi-bika.de>
1558Attila Hammer <hammera@pickup.hu>
1559August Hörandl <august.hoerandl@gmx.at>
1560Boris Daix <Boris.Daix@insa-lyon.fr>
1561Cheryl Homiak <chomiak@shellworld.net>
1562Christian Comaschi <christian_comaschi@libero.it>
1563Coscell Kao <coscell@molerat.net>
1564Daniel Dalton <d.dalton@iinet.net.au>
1565Dave Mielke <dave@mielke.cc>
1566David Sauer <sauer@brailcom.cz>
1567Hans Schou <chlor@schou.dk>
1568Helge Havnegjerde <helge.havnegjerde@c2i.net>
1569Hermann Bender <meinelisten@onlinehome.de>
1570James Teh <jamie@jantrid.net>
1571Jan Buchal <buchal@brailcom.org>
1572Jean-Philippe Mengual <jmengual@linuxfromscratch.org>
1573John J. Boyer <john.boyer@jjb-software.com>
1574Kazunori Minatani <99112004@gakushuin.ac.jp>
1575Lars Bjørndal <lars.bjorndal@broadpark.no>
1576Lee Maschmeyer <leemer1@comcast.net>
1577Luke Yelavich <themuso@ubuntu.com>
1578Mario Lang <mlang@delysid.org>
1579Mark Mielke <mark@mielke.cc>
1580Matthew Miller <mattdm@mattdm.org>
1581Michael Curran <mick@kulgan.net>
1582Michel Such <michel.such@free.fr>
1583Mike Pedersen <mpedersen@mindspring.com>
1584Nicolas Pitre <nico@fluxnic.net>
1585Olivier Bert <obert01@mistigri.org>`
1586Oscar Fernandez <ofa@once.es>
1587Pete De Vasto <pdevasto@incyte.com>
1588Peter Lundblad <plundblad@google.com>
1589Rich Burridge <Rich.Burridge@Sun.COM>
1590Rudolf Weeber <Rudolf.Weeber@gmx.de>
1591Samuel Thibault <samuel.thibault@ens-lyon.org>
1592Samuel Yang <mison@bbs.ee.ntu.edu.tw>
1593Sébastien Hinderer <sebastien.hinderer@ens-lyon.org>
1594Sérgio Neves <sergionevess@gmail.com>
1595Simon Kainz <simon@familiekainz.at>
1596Simon Meers <drmeers@gmail.com>
1597Stepan Kasal <kasal@ucw.cz>
1598Stephane Dalton <sdalton@videotron.ca>
1599Stéphane Doyon <s.doyon@videotron.ca>
1600Tapio Kelloniemi <tapio.kelloniemi@thack.org>
1601Thu Trang <phamtrang2002@softhome.net>
1602Timothy Spaulding <spaulding@icanbrew.com>
1603Timo Matsinen <matsinen@jyu.fi>
1604Tom spot Callaway <tcallawa@redhat.com>
1605Tomáš Janoušek <tomi@nomi.cz>
1606Tomoyuki Kudou <kudou@cypac.co.jp>
1607Willi Lutzenberger <willutz@gmx.net>
1608William Hubbs <w.d.hubbs@gmail.com>
1609Wolfgang Astleitner <wolfgang.astleitner@liwest.at>
1610Yair K. <caesium@hotpop.com>
1611Yannick Plassiard <yan@mistigri.org>
1612 Pairing a Bluetooth Device on Linux
1613===================================
1614
1615You need to "pair" your device with the host on which you wish to use it. You
1616can pair a device with more than one host, but you can usually only use it with
1617one host at a time.
1618
1619Pairing a Bluetooth device on Linux is relatively easy if you're comfortable
1620working within the graphical (X) environment. All you need to do is to run
1621"bluetooth-applet" and follow the steps it presents to you. It's a little
1622trickier to pair a Bluetooth device via the command line, but it can be done.
1623One way to do it is as follows:
1624
1625You need to find out your host's Bluetooth Device Address (referred to later in
1626this document as <host-address>). To do this, run the command "hciconfig hci0".
1627Look for the (indented) line which begins with "BD Address:". The very next
1628"word" on that line is your host's Bluetooth Device Address. It'll be six
1629two-digit hexadecimal numbers separated by colons (:). Examples in this
1630document use the value "01:23:45:67:89:AB".
1631
1632You need to find out your device's Bluetooth Device Address (referred to later
1633in this document as <device-address>). To do this, run the command "hcitool
1634scan". This command can take a while to complete as it gives devices a fair bit
1635of time to respond. Each device which responds creates one two-column output
1636line. The first column is its Bluetooth Device Address (examples in this
1637document use the value "12:34:56:78:9A:BC"), and the second column is its
1638current name. Manufacturers usually set a device's initial name to its product
1639name and model number so that it's easy to spot within the scan output. If your
1640device allows you to change its name, it's okay to do so even after you've
1641paired it.
1642
1643A device needs to be "visible" in order for the scan to find it. Most devices
1644are "invisible" by default, but have a way to be made temporarily visible. You
1645should check your device's manual to find out how to do this. In many cases
1646there's either a button which needs to be pressed or a menu item which needs to
1647be selected. Since both the device's temporary visibility and the host's scan
1648time out, Make your device visible just before you initiate the scan.
1649
1650You need to know what PIN (password) your device is expecting. Your device's
1651documentation should contain this information. Many devices allow you to set
1652the PIN, in which case they'll have a menu which allows you to do this.
1653Examples in this document use the value "1234".
1654
1655Go into the directory "/var/lib/bluetooth/<host-address>. In there (create if
1656necessary) is the file "pincodes". Each line in this file associates a device
1657with its PIN. It has two fields separated by space. The first field is the
1658device's Bluetooth Device Address and the second field is its PIN. The
1659Bluetooth Device Address must be in uppercase. For example:
1660
1661 cat /var/lib/bluetooth/01:23:45:67:89:AB/pincodes
1662 12:34:56:78:9A:BC 1234
1663
1664
1665Using a Bluetooth Device with BRLTTY
1666====================================
1667
1668After your device has been paired with your host, it's ready to be used by
1669BRLTTY. You can tell BRLTTY to use your Bluetooth device either via the -d (or
1670--braille-device=) command line option or via the braille-device line in the
1671file "/etc/brltty.conf". The device should be specified as the word
1672"bluetooth", a colon (:), and the device's Bluetooth Device Address. For
1673example:
1674
1675 brltty -d bluetooth:12:34:56:78:9A:BC
1676or
1677 cat /etc/brltty.conf
1678 braille-device bluetooth:12:34:56:78:9A:BC
1679
1680
1681 brltty for Debian
1682-----------------
1683
1684The ViaVoice and Theta speech modules are intentionally not included in the
1685binary package due to license incompatibilities.
1686
1687I also removed /sbin/brltty-install because I think
1688as soon as we have a .deb package, the reinstall
1689method isn't necessary.
1690(feel free to complain about this if you need it).
1691
1692 -- Mario Lang <mlang@delysid.org>, Wed May 19 09:41:09 2004
1693 This driver allows to use any tty as peripheral for BrlTTY. There are many ways
1694to use it.
1695
1696By ssh-ing from another machine
1697-------------------------------
1698
1699ssh from machB to machA, and give the current tty as device to brltty:
1700
1701samy@machB$ ssh machA
1702samy@machA$ su -
1703Password:
1704root@machA# brltty -b tt -d `tty` -B term=$TERM -n
1705
1706By using an Xterm
1707-----------------
1708
1709Just give the tty used by the xterm to brltty.
1710
1711$ su -
1712Password:
1713# brltty -b tt -d `tty` -B term=$TERM -n
1714
1715By using a real tty
1716-------------------
1717
1718Just give the serial port on which it is connected to brltty:
1719
1720# brltty -b tt -d /dev/ttyS0 -B term=ampex232,baud=19200,charset=IBM850,locale=fr_FR.IBM850
1721
1722I here had to precise the type of terminal (I have an Ampex232, see somewhere
1723like /usr/share/terminfo for your own's.
1724
1725I also had to tell that it uses the IBM850 codepage table. And I hence also
1726had to tell to use a special locale: fr_FR.IBM850, since I want french,
1727with IBM850 charset. I had to generate since by hand by adding
1728fr_FR.IBM850 IBM850
1729to my /etc/locale.gen, and then relaunch locale-gen
1730
1731
1732Notes
1733-----
1734
1735Another machine connected by a null-modem can be used as a tty: just run
1736minicom on it, and use vt100 as type of terminal.
1737
1738If a BrlAPI application writes dots (Gnopernicus for instance) you won't
1739get the text.
1740
1741See help.txt (or press F1) to get help on key bindings
1742Default configuration should be fine, but if not, get sure to use 8-dot text
1743style and not to show attributes in the configuration menu (F4).
1744
1745Note that when the displayed window is not supposed to contain the cursor, the
1746cursor is actually put below the displayed window.
1747 Ceci est le fichier README relatif àla version 0.2 du pilote VisioBraille
1748pour BRLTTY.
1749
1750Ce pilote a été testé avec succès avec les terminaux équipés de PROMs 0.0g et
17515.0q-fr. Il est vraisemblable que toutes les PROMs de version >=4
1752soient supportées par le présent pilote.
1753
1754Auteur et mainteneur actuel:
1755Sébastien Hinderer <Sebastien.Hinderer@ens-lyon.org>
1756
1757Bien que ce pilote soit utilisé de manière intensive, il n'est pas impossible
1758que certaines erreurs subsistent.
1759Si vous en trouvez, ou si vous avez des commentaires/suggestions quant ÃÂ
1760l'évolution de ce pilote, n'hésitez surtout pas àme contacter.
1761
1762Notes pour l'installation et Paramètres
1763=======================================
1764
1765Une table braille compatible avec celle fournie en standard dans le TVB
1766(basée sur la table SAGEM) est disponible, dans le fichier text.visiob.tbl du
1767répertoire ../../BrailleTables
1768
1769Paramètres acceptés par ce pilote :
1770
1771- displaysize : permet de spécifier la taille de la plage tactile.
1772
1773- promversion: permet de spécifier la version de PROM utilisée.
1774Ce paramètre n'est nécessaire que pour des PROMs de version inférieure ou
1775égale à3. Le support de ces PROMs n'étant disponible que pour Linux, et
1776moyennant une modification du noyau, merci de contacter directement l'auteur
1777si vous souhaitez utiliser une telle PROM.
1778
1779- baud: permet de spécifier la vitesse de la communication série.
1780Ce parmètre n'est pas nécessaire pour les terminaux VisioBraille et
1781n'est fourni que pour permettre l'utilisation d'émulateurs de terminaux qui
1782ne pourraient pas communiquer àune vitesse suffisante. Par conséquent,
1783n'utilisez pas ce paramètre, àmoins de savoir ce que vous faites.
1784
1785Pour des informations sur la manière de passer des paramètres au pilote, ou
1786pour toute autre précision concernant l'installation et l'utilisation de
1787brltty, merci de consulter la documentation du répertoire ../../Documents
1788
1789Notes pour l'utilisation.
1790=========================
1791
1792 Voici la description des fonctions attachées aux touches des claviers
1793auxiliaires ainsi qu'aux commandes ploc-ploc.
1794
1795~~a Active l'aide de BRLTTY
1796~~b Active/désactive les bips
1797~~c Menu de configuration BRLTTY (~~c pour le quitter)
1798~~d page down
1799~~e end
1800~~h home
1801~~i Active/désactive le mode info (Cf le manuel BRLTTY pour en savoir plus)
1802~~r Réinitialise les paramètres de BRLTTY
1803~~s Sauvegarde la configuration des paramètres BRLTTY
1804~~u page up
1805
1806Clavier auxiliaire:
1807Sous Linux, les touches A1,A2,A3,A6,A7,A8 permettent d'activer les
18086 premières consoles virtuelles (correspond àalt-f1 àalt-f6).
1809L'action de ces touches n'est pas définie sur les autres systèmes
1810d'exploitation.
1811B6 coin supérieur gauche de l'écran
1812D6 coin inférieur gauche de l'écran
1813A4 fenêtre non vide précédente
1814A5 fenêtre non vide suivante
1815B7 ligne précédente
1816D7 ligne suivante
1817C6 fenêtre précédente
1818C8 fenêtre suivante
1819C7 fenêtre contenant le curseur
1820C1 flèche gauche
1821C3 flèche droite
1822B2 flèche haut
1823D2 flèche bas
1824B3 curseur on/off
1825D1 delete
1826
1827 En outre, les touches backspace, tab, ctrl, alt... sont siulées de la même
1828manière que sous DOS et Windows.
1829
1830Autres liens
1831============
1832
1833Un programme permettant le transfert de visiobases entre PC et TVB est
1834disponible àl'adresse suivante :
1835
1836http://brl.thefreecat.org
1837
1838Ce qu'il reste àfaire
1839======================
1840
1841 Pour les prochaines versions du driver, il serait peut-être souhaitable
1842d'inclure la possibilité de reprohrammer les touches, un peu comme cela se
1843fait sous DOS avec la commande ~~f.
1844
1845
1846--
1847Sébastien Hinderer <Sebastien.Hinderer@ens-lyon.org>
1848 BRLTTY Driver for the Tieman Voyager Braille Display
1849This is the user-space-only version of the driver.
1850Version 0.10 (March 2004)
1851
1852 <HTML>
1853<HEAD>
1854<TITLE> Dnsmasq - a DNS forwarder for NAT firewalls.</TITLE>
1855<link rel="icon"
1856 href="http://www.thekelleys.org.uk/dnsmasq/images/favicon.ico">
1857</HEAD>
1858<BODY BGCOLOR="WHITE">
1859<table width="100%" border="0" cellpadding="0" cellspacing="0">
1860<tr>
1861<td align="left" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td>
1862<td align="middle" valign="middle"><h1>Dnsmasq</h1></td>
1863<td align="right" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td></tr>
1864</table>
1865
1866Dnsmasq is a lightweight, easy to configure DNS forwarder and DHCP
1867 server. It is designed to provide DNS and, optionally, DHCP, to a
1868 small network. It can serve the names of local machines which are
1869 not in the global DNS. The DHCP server integrates with the DNS
1870 server and allows machines with DHCP-allocated addresses
1871 to appear in the DNS with names configured either in each host or
1872 in a central configuration file. Dnsmasq supports static and dynamic
1873 DHCP leases and BOOTP/TFTP/PXE for network booting of diskless machines.
1874<P>
1875 Dnsmasq is targeted at home networks using NAT and
1876connected to the internet via a modem, cable-modem or ADSL
1877connection but would be a good choice for any smallish network (up to
18781000 clients is known to work) where low
1879resource use and ease of configuration are important.
1880<P>
1881Supported platforms include Linux (with glibc and uclibc), *BSD,
1882Solaris and Mac OS X.
1883Dnsmasq is included in at least the following Linux distributions:
1884Gentoo, Debian, Slackware, Suse, Fedora,
1885Smoothwall, IP-Cop, floppyfw, Firebox, LEAF, Freesco, fli4l,
1886CoyoteLinux, Endian Firewall and
1887Clarkconnect. It is also available as FreeBSD, OpenBSD and NetBSD ports and is used in
1888Linksys wireless routers (dd-wrt, openwrt and the stock firmware) and the m0n0wall project.
1889<P>
1890Dnsmasq provides the following features:
1891<DIR>
1892
1893<LI>
1894The DNS configuration of machines behind the firewall is simple and
1895doesn't depend on the details of the ISP's dns servers
1896<LI>
1897Clients which try to do DNS lookups while a modem link to the
1898internet is down will time out immediately.
1899</LI>
1900<LI>
1901Dnsmasq will serve names from the /etc/hosts file on the firewall
1902machine: If the names of local machines are there, then they can all
1903be addressed without having to maintain /etc/hosts on each machine.
1904</LI>
1905<LI>
1906The integrated DHCP server supports static and dynamic DHCP leases and
1907multiple networks and IP ranges. It works across BOOTP relays and
1908supports DHCP options including RFC3397 DNS search lists.
1909Machines which are configured by DHCP have their names automatically
1910included in the DNS and the names can specified by each machine or
1911centrally by associating a name with a MAC address in the dnsmasq
1912config file.
1913</LI>
1914<LI>
1915Dnsmasq caches internet addresses (A records and AAAA records) and address-to-name
1916mappings (PTR records), reducing the load on upstream servers and
1917improving performance (especially on modem connections).
1918</LI>
1919<LI>
1920Dnsmasq can be configured to automatically pick up the addresses of
1921its upstream nameservers from ppp or dhcp configuration. It will
1922automatically reload this information if it changes. This facility
1923will be of particular interest to maintainers of Linux firewall
1924distributions since it allows dns configuration to be made automatic.
1925</LI>
1926<LI>
1927On IPv6-enabled boxes, dnsmasq can both talk to upstream servers via IPv6
1928and offer DNS service via IPv6. On dual-stack (IPv4 and IPv6) boxes it talks
1929both protocols and can even act as IPv6-to-IPv4 or IPv4-to-IPv6 forwarder.
1930</LI>
1931<LI>
1932Dnsmasq can be configured to send queries for certain domains to
1933upstream servers handling only those domains. This makes integration
1934with private DNS systems easy.
1935</LI>
1936<LI>
1937Dnsmasq supports MX and SRV records and can be configured to return MX records
1938for any or all local machines.
1939</LI>
1940</DIR>
1941
1942<H2>Download.</H2>
1943
1944<A HREF="http://www.thekelleys.org.uk/dnsmasq/"> Download</A> dnsmasq here.
1945The tarball includes this documentation, source, and manpage.
1946There is also a <A HREF="CHANGELOG"> CHANGELOG</A> and a <A HREF="FAQ">FAQ</A>.
1947Dnsmasq is part of the Debian distribution, it can be downloaded from
1948<A HREF="http://ftp.debian.org/debian/pool/main/d/dnsmasq/"> here</A> or installed using <TT>apt</TT>.
1949
1950<H2>Links.</H2>
1951Damien 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>
1952There is a good article about dnsmasq at <A
1953HREF="http://www.enterprisenetworkingplanet.com/netos/article.php/3377351">http://www.enterprisenetworkingplanet.com/netos/article.php/3377351</A>
1954and another at <A
1955HREF="http://www.linux.com/articles/149040">http://www.linux.com/articles/149040</A>
1956and Ilya Evseev has an article in Russian about dnsmasq to be found at
1957<A HREF="http://ilya-evseev.narod.ru/articles/dnsmasq">
1958http://ilya-evseev.narod.ru/articles/dnsmasq</A>. Ismael Ull has an
1959article 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>
1960<H2>License.</H2>
1961Dnsmasq is distributed under the GPL. See the file COPYING in the distribution
1962for details.
1963
1964<H2>Contact.</H2>
1965There is a dnsmasq mailing list at <A
1966HREF="http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss">
1967http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss</A> which should be the
1968first location for queries, bugreports, suggestions etc.
1969Dnsmasq was written by Simon Kelley. You can contact me at <A
1970HREF="mailto:simon@thekelleys.org.uk">simon@thekelleys.org.uk</A>.
1971</BODY>
1972
1973 <HTML>
1974<HEAD>
1975<TITLE> Configuring Dnsmasq.</TITLE>
1976</HEAD>
1977<BODY BGCOLOR="WHITE">
1978<H1 ALIGN=center>Dnsmasq setup</H1>
1979<H2>Installation.</H2>
1980To compile and install dnsmasq, the following command (as root) is enough.
1981
1982<PRE>
1983make install
1984</PRE>
1985
1986You might want to edit config.h. Dnsmasq has
1987been run on (at least) Linux, uCLinux, AIX 4.1.5, FreeBSD 4.4 OpenBSD and Tru64 4.x
1988
1989Dnsmasq is normally run on a firewall machine (the machine with the
1990modem or other connection to your ISP.) but it can run on any machine
1991with access to the ISPs nameservers.
1992
1993Put the binary in <TT>/usr/local/sbin/dnsmasq</TT> (running <TT>make install</TT> will do this) and arrange for it
1994to be started at boot time.
1995
1996Note that dnsmasq needs to run as root, since it binds privileged ports. It will drop root privileges after start-up. Dnsmasq
1997logs problems using the syslog facility as a daemon. It logs debugging
1998information to local0
1999<P>
2000<H2>Configuration.</H2>
2001Configuration for dnsmasq is pretty simple in almost all cases. The
2002program has collected a fair few options as it has developed but most of them
2003are not needed most of the time. A machine which already has a DNS
2004configuration (ie one or more external nameservers in <TT>/etc/resolv.conf</TT>
2005and any local hosts in <TT>/etc/hosts</TT>) can be turned into a nameserver
2006simply by running dnsmasq, with no options or configuration at
2007all. Set the IP address of the machine running dnsmasq as the DNS
2008server in all the other machines on your network, and you're done.
2009<P>
2010With a few option flags, it is possible to make dnsmasq do more clever
2011tricks. Options for dnsmasq can be set either on the command line
2012when starting dnsmasq, or in its configuration file, <TT>/etc/dnsmasq.conf</TT>.
2013
2014<h2>Making the nameserver machine use dnsmasq.</h2>
2015In the simple configuration described above, processes local to the
2016machine will not use dnsmasq, since they get their information about
2017which nameservers to use from /etc/resolv.conf, which is set to the
2018upstream nameservers. To fix this, simply replace the nameserver in
2019<TT>/etc/resolv.conf</TT> with the local address 127.0.0.1 and give the
2020address(es) of the upstream nameserver(s) to dnsmasq directly. You can
2021do this using either the <TT>server</TT> option, or by putting them into
2022another file, and telling dnsmasq about its location with
2023the <TT>resolv-file</TT> option.
2024
2025<h2>Automatic nameserver configuration.</h2>
2026The two protocols most used for automatic IP network configuration
2027(PPP and DHCP) can determine the IP addresses for nameservers automatically.
2028The daemons can be made to write out a file in the resolv.conf format with the
2029nameservers in which is perfect for dnsmasq to use. When the
2030nameservers change, for instance on dialling into a new ISP using PPP,
2031dnsmasq will automatically re-read this file and begin using the new
2032nameserver(s) completely transparently.
2033
2034<h3>Automatic DNS server configuration with PPP.</h3>
2035Later versions of pppd have an option "usepeerdns" which instructs it to write a file containing
2036the address(es) of the DNS severs in <TT>/etc/ppp/resolv.conf</TT>. Configure dnsmasq
2037as above with "nameserver 127.0.0.1" in <TT>/etc/resolv.conf</TT> and run dnsmasq
2038with to option <TT>resolv-file=/etc/ppp/resolv.conf</TT>.
2039<P>
2040On Redhat (at least versions 7.1, 7.2 and 7.3) you can set pppd
2041options by adding "PPPOPTIONS=usepeerdns" to
2042<TT>/etc/sysconfig/network-scripts/ifcfg-ippp0</TT>. In the same file, make sure
2043that "PEERDNS=no" to stop RedHat's network initscripts from copying
2044<TT>/etc/ppp/resolv.conf</TT> into <TT>/etc/resolv.conf</TT>.<BR>
2045
2046On SuSE (at least version 8.1, and 8.2) you should use YaST to activate
2047<TT>[x] Modify DNS when connected</TT> then stop SuSEs network initscripts
2048from copying <TT>/etc/ppp/resolv.conf</TT> into <TT>/etc/resolv.conf</TT>
2049by modifying MODIFY_RESOLV_CONF_DYNAMICALLY="no" in <TT>/etc/sysconfig/network/config</TT>.
2050
2051
2052<h3>Automatic DNS server configuration with DHCP.</h3>
2053You need to get your DHCP client to write the addresse(s) of the DNS
2054servers to a file other than <TT>/etc/resolv.conf</TT>. For dhcpcd, the
2055<TT>dhcpcd.exe</TT> script gets run with the addresses of the nameserver(s) in
2056the shell variable <TT>$DNS</TT>. The following bit of shell script
2057uses that to write a file suitable for dnsmasq.
2058<PRE>
2059
2060echo -n >|/etc/dhcpc/resolv.conf
2061dnsservs=${DNS//,/ }
2062for serv in $dnsservs; do
2063 echo "nameserver $serv" >>/etc/dhcpc/resolv.conf
2064done
2065
2066</PRE>
2067
2068Remember to give dhcpcd the <TT>-R</TT> flag to stop it overwriting
2069<TT>/etc/resolv.conf</TT>.
2070
2071<P>
2072For other DHCP clients it should be possible to achieve the same effect.
2073
2074<h3> DHCP and PPP.</h3>
2075On a laptop which may potentially connect via a modem and PPP or
2076ethernet and DHCP it is possible to combine both of the above
2077configurations. Running dnsmasq with the flags
2078<TT>resolv-file=/etc/ppp/resolv.conf resolv-file=/etc/dhcpc/resolv.conf</TT>
2079makes it poll <B>both</B> files and use whichever was updated
2080last. The result is automatic switching between DNS servers.
2081</H3>
2082
2083<H2> Integration with DHCP.</H2>
2084Dnsmasq reads <TT>/etc/hosts</TT> so that the names of local machines are
2085available in DNS. This is fine when you give all your local machines
2086static IP addresses which can go in <TT>/etc/hosts</TT>, but it doesn't work
2087when local machines are configured via DHCP, since the IP address
2088allocated to machine is not fixed. Dnsmasq comes with an integrated
2089DHCP daemon to solve this problem.
2090<P>
2091The dnsmasq DHCP daemon allocates addresses to hosts on the network and tries
2092to determine their names. If it succeeds it add the name and address
2093pair to the DNS. There are basically two ways to associate a name with
2094a DHCP-configured machine; either the machine knows its name which it
2095gets a DHCP lease, or dnsmasq gives it a name, based on the MAC
2096address of its ethernet card. For the former to work, a machine needs to know its name when it
2097requests a DHCP lease. For dhcpcd, the -h option specifies this. The
2098names may be anything as far as DHCP is concerned, but dnsmasq adds
2099some limitations. By default the names must no have a domain part, ie
2100they must just be a alphanumeric name, without any dots. This is a
2101security feature to stop a machine on your network telling DHCP that
2102its name is "www.microsoft.com" and thereby grabbing traffic which
2103shouldn't go to it. A domain part is only allowed by dnsmasq in DHCP machine names
2104if the <TT>domain-suffix</TT> option is set, the domain part must match the
2105suffix.
2106<P>
2107As an aside, make sure not to tell DHCP to set the hostname when it
2108obtains a lease (in dhcpcd that's the -H flag.)
2109This is not reliable since the DHCP server gets the
2110hostname from DNS which in this case is dnsmasq. There is a race
2111condition because the host's name in the DNS may change as a
2112result of it getting a DHCP lease, but this does not propagate before
2113the name is looked up. The net effect may be that the host believes it
2114is called something different to its name in the DNS. To be safe, set
2115the hostname on a machine locally, and pass the same name to DHCP when
2116requesting a lease.
2117<P>
2118<H2>Setting up a mailhub.</H2>
2119If you generate mail on the machines attached to your private network, you may
2120 be interested in the MX record feature of dnsmasq. This allows you to have all
2121 the machines on your network use your firewall or another machine as a "smarthost" and
2122deliver mail to it. The details of how to set this up are highly dependent on
2123your mailer, system and distribution. The only thing that's relevant to dnsmasq is that the mailer
2124needs to be able to interrogate the DNS and find an MX record for your mailhub.
2125<P>
2126By giving dnsmasq the <TT>mx-host</TT> option
2127you instruct dnsmasq to serve an MX record for the specified address.
2128By default the MX record
2129points to the machine on which dnsmasq is running, so mail delivered to that
2130name will get sent to the mailer on your firewall machine. You can
2131have the MX record point to another machine by using the <TT>mx-target</TT>
2132option.
2133<P>
2134In some cases it's useful for all local machines to see an MX record
2135pointing at themselves: this allows mailers which insist on an MX record and
2136don't fall back to A records to deliver mail within the
2137machine. These MX records are enabled using the <TT>selfmx</TT> option.
2138
2139<H2>Using special servers.</H2>
2140Dnsmasq has the ability to direct DNS queries for certain domains to
2141specific upstream nameservers. This feature was added for use with
2142VPNs but it is fully general. The scenario is this: you have a
2143standard internet connection via an ISP, and dnsmasq is configured to
2144forward queries to the ISP's nameservers, then you make a VPN
2145connection into your companies network, giving access to hosts inside
2146the company firewall. You have access, but since many of the internal hosts
2147aren't visible on the public internet, your company doesn't publish
2148them to the public DNS and you can't get their IP address from the ISP
2149nameservers. The solution is to use the companies nameserver for
2150private domains within the company, and dnsmasq allows this. Assuming
2151that internal company machines are all in the domain internal.myco.com
2152and the companies nameserver is at 192.168.10.1 then the option
2153<TT>server=/internal.myco.com/192.168.10.1</TT> will direct all
2154queries in the internal domain to the correct nameserver. You can
2155specify more than one domain in each server option. If there is
2156more than one nameserver just include as many
2157<TT>server</TT> options as is needed to specify them all.
2158
2159<H2>Local domains.</H2>
2160Sometimes people have local domains which they do not want forwarded
2161to upstream servers. This is accomodated by using server options
2162without the server IP address. To make things clearer <TT>local</TT>
2163is a synonym for <TT>server</TT>. For example the option
2164<TT>local=/localnet/</TT> ensures that any domain name query which ends in
2165<TT>.localnet</TT> will be answered if possible from
2166<TT>/etc/hosts</TT> or DHCP, but never sent to an upstream server.
2167
2168<H2>Defeating wildcards in top level domains.</H2>
2169In September 2003 Verisign installed a wildcard record in the .com and
2170.net top level domains. The effect of this is that queries for
2171unregistered .com and .net names now return the address of Verisign's
2172sitefinder service, rather than a "no such domain" response. To
2173restore the correct behaviour, you can tell dnsmasq the address of the
2174sitefinder host and have it substitute an NXDOMAIN reply when it sees
2175that address. The sitefinder address is currently 64.94.110.11, so
2176giving the option <TT>bogus-nxdomain=64.94.110.11</TT> will enable
2177this facility for Verisign. If other TLDs do that same thing you can
2178add the correct addresses for them too. See the dnsmasq FAQ for more
2179details on the <TT>bogus-nxdomain</TT> option.
2180
2181<H2>Other configuration details.</H2>
2182By default dnsmasq offers DNS service on all the configured interfaces
2183of a host. It's likely that you don't (for instance) want to offer a
2184DNS service to the world via an interface connected to ADSL or
2185cable-modem so dnsmasq allows you to specify which interfaces it will
2186listen on. Use either the <TT>interface</TT> or <TT>address</TT> options to do this.
2187<P>
2188The <TT>filterwin2k</TT> option makes dnsmasq ignore certain DNS requests which
2189are made by Windows boxen every few minutes. The requests generally
2190don't get sensible answers in the global DNS and cause trouble by
2191triggering dial-on-demand internet links.
2192<P>
2193Sending SIGHUP to the dnsmasq process will cause it to empty its cache and
2194then re-load <TT>/etc/hosts</TT> and <TT>/etc/resolv.conf</TT>.
2195<P> Sending SIGUSR1 (killall -10 dnsmasq) to the dnsmasq process will
2196cause to write cache usage statisticss to the log, typically
2197<TT>/var/log/syslog</TT> or <TT>/var/log/messages</TT>.
2198<P> The <TT>log-queries</TT> option tells dnsmasq to verbosely log the queries
2199it is handling and causes SIGUSR1 to trigger a complete dump of the
2200contents of the cache to the syslog.
2201
2202<P>For a complete listing of options please take a look at the manpage
2203dnsmasq(8).
2204
2205This is the Debian doc-base package. It was assembled by
2206Christian Schwarz <schwarz@debian.org>. The next maintainer
2207was Adam Di Carlo <aph@debian.org>. It is currently maintained
2208by Robert Luberda <robert@debian.org>.
2209
2210doc-base Copyright (C) 1997,1998 Christian Schwarz.
2211doc-base Copyright (C) 2006-2009 Robert Luberda.
2212
2213This package is free software; you may redistribute it and/or modify it
2214under the terms of the GNU General Public License as published by the
2215Free Software Foundation; either version 2, or (at your option) any
2216later version.
2217
2218This is distributed in the hope that it will be useful, but without
2219any warranty; without even the implied warranty of merchantability or
2220fitness for a particular purpose. See the GNU General Public License
2221for more details.
2222
2223You should have received a copy of the GNU General Public License with
2224your Debian GNU/Linux system, in /usr/share/common-licenses/GPL-2, or
2225with the dpkg source package as the file COPYING. If not, write to the
2226Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
2227MA 02110-1301 USA
2228
2229
2230Copyright 2004 by Stéphane Doyon <s.doyon@videotron.ca>
2231
2232This is a partial rewrite of the driver which functions entirely from
2233user-space (whereas the previous driver depended on a kernel driver for
2234the USB communication with the Voyager display).
2235
2236This driver supports the Tieman Voyager 44 and 70.
2237
2238The driver works with later 2.4.x kernels and with at least some versions
2239in the 2.6.x series.
2240Note that the kernel brlvger driver used with the old BRLTTY driver does
2241not work properly with 2.6.x kernels.
2242
2243Many thanks to the Tieman people: Corand van Strien, Ivar Illing, Daphne
2244Vogelaar and Ingrid Vogel. They provided us with a Braille display (as
2245well as programming information) so that we could write this driver. They
2246replaced the display when it broke and they answered our technical
2247questions. It is very motivating when companies take an interest in such
2248projects and are so supportive.
2249
2250Thanks to Andor Demarteau <ademarte@students.cs.uu.nl> who got this whole
2251project started and beta-tested all our early buggy attempts.
2252
2253Thanks to Stéphane Dalton who wrote the initial version of the old kernel
2254driver. Without his initiative this project would not have been a success.
2255
2256This rewrite of the driver should allow more flexibility, but is as of yet
2257very young and not thoroughly tested.
2258
2259When BRLTTY will be running, press the leftmost routing key to bring up
2260the help screen so you can read the details of the key bindings.
2261
2262Users of the 2.6.x kernel may experience some difficulties. The old
2263kernel driver, which is included in the official kernels, will actually
2264get in the way of this driver as it will claim the USB interface to the
2265display, and I've seen some hangs occur when BRLTTY asks to disconnect
2266the kernel driver. If you have this problem you should make sure the
2267kernel module called brlvger is not inserted into your kernel. One simple
2268way to prevent that module from auto-loading is to rename the module file
2269so it isn't found.
2270cd /lib/modules/`uname -r`/kernel/drivers/usb/
2271mv brlvger.o brlvger.o.hold
2272If lsmod shows the brlvger module as already loaded then do
2273rmmod brlvger
2274
2275The old kernel driver will soon be pulled out of 2.6.x kernels.
2276
2277BRLTTY currently assumes the default braille device to be a serial port,
2278so you must tell it that it is in fact USB.
2279Either provide the "--with-braille-device=usb:" option when running the
2280BRLTTY top-level ./configure command, or use the braille-device parameter
2281in your BRLTTY configuration file (/etc/brltty.conf):
2282braille-device usb:
2283
2284If you actually have more than one Voyager display connected at the same
2285time, you can also specify the serial number of the device that you want
2286to use.
2287
2288This driver knows a number of driver parameters which you can pass via
2289the braille-parameters clause in your BRLTTY configuration file
2290(/etc/brltty.conf) or via brltty's -B (--braille-parameters=) command
2291line option.
2292
2293InputMode: This parameter specifies whether or not the eight top keys
2294function as a braille keyboard. When set to "no" (the default), top
2295key combinations perform various navigational and operational
2296functions. When set to yes", they function as an 8-dot braille
2297keyboard. If B, C, or B+C is pressed along with any top key
2298combination then it's as if this parameter were set to "no".
2299
2300There are only a handful of BRLTTY users, so if you are trying out this
2301driver, please drop us a note, even if you have no problems!
2302
2303Note to BRLTTY developers: This is my first attempt at combining the key
2304binding definitions with the help file text in one place, through
2305annotations in the braille.c file. If you change the key bindings,
2306currently you need python installed to be able to rebuild the help
2307files.
2308 This package was debianized by Mario Lang <mlang@delysid.org> on
2309Thu, 4 Jan 2001 16:22:12 +0100.
2310
2311It was downloaded from <URL:http://mielke.cc/brltty/releases/>
2312
2313Upstream Authors:
2314 Nicolas Pitre <nico@cam.org>
2315 Current maintainer; author of the drivers for the Alva B.V.
2316 series and for the EuroBraille family of displays.
2317
2318 Stéphane Doyon <s.doyon@videotron.ca>:
2319 Active developer; author of the driver for Telesensory
2320 Systems's PowerBraille and Navigator models.
2321
2322 Nikhil Nair <nn201@cus.cam.ac.uk>:
2323 Original author; author of the drivers for the Tieman B.V.
2324 CombiBraille and Blazie Engineering's BrailleLite.
2325
2326 James Bowden <jrbowden@bcs.org.uk>:
2327 Acted in an advisory capacity; contributed some braille
2328 translation tables.
2329
2330 August Hörandl <hoerandl@elina.htlw1.ac.at>:
2331 Noted contributor of the driver for the Papenmeier Screen 2D
2332 Terminal. Thanks to the members of his team (Tibor Becker,
2333 Michael Burger, Herbert Gruber and Heimo Schön) who worked on
2334 this project at the Technical High School, Department for
2335 electrical engineering, Vienna, Austria.
2336
2337 Oscar Fernandez <ofa@once.es>:
2338 Contributor of the driver for the EcoBraille from La O.N.C.E.
2339
2340 A more complete list of contributors can be found in
2341 `/usr/share/doc/brltty/CONTRIBUTORS'.
2342
2343Copyright:
2344
2345Copyright (C) 1995-2009 by The BRLTTY Team, All rights reserved.
2346
2347BRLTTY comes with ABSOLUTELY NO WARRANTY.
2348
2349This is free software, placed under the terms of the
2350GNU General Public License, as published by the Free Software
2351Foundation; either version 2 of the License, or (at your option) any
2352later version.
2353
2354On Debian GNU/Linux systems, the complete text of the GNU General
2355Public License can be found in `/usr/share/common-licenses/GPL-2'.
2356
2357Text, attribute and contraction tables in /etc/brltty/ are placed under
2358the terms of the GNU Lesser General Public License, as published by the
2359Free Software Foundation; either version 2.1 of the License, or (at your
2360option) any later version.
2361
2362On Debian GNU/Linux systems, the complete text of the GNU Lesser General
2363Public License can be found in `/usr/share/common-licenses/LGPL-2.1'.
2364
2365 This is bsdmainutils, a collection of userland programs from the *BSD source
2366distributions. All of the program except for calendar(1) and lorder(1) come
2367from FreeBSD, while these two come from OpenBSD. The calendars themselves
2368mostly come from FreeBSD though, but not all.
2369
2370These sources were originally pacakged by Austin Donnelly
2371<and1000@debian.org>, and were based heavily on bsdutils, which was
2372originally put together by Ian Murdock <imurdock@gnu.ai.mit.edu>.
2373
2374After that, the package was maintained by Charles Briscoe-Smith
2375<cpbs@debian.org>. He gathered data for the 1999-2001 calendar files from
2376various sources on the Internet. Oliver Elphick, Julian Gilbey, Daniel
2377Martin and Jaldhar H. Vyas provided much useful data on the various religous
2378calendars.
2379
2380After Charles, Marco d'Itri <md@linux.it> maintained the package for almost
2381two years, before Tollef Fog Heen <tfheen@debian.org> took over followed by
2382Graham Wilson <bob@decoy.wox.org> and Daniel Baumann <daniel@debian.org>.
2383The package is now maintained by Giacomo Catenazzi <cate@debian.org> and
2384Michael Meskes <meskes@debian.org>.
2385
2386Graham Wilson replaced the FreeBSD calendar(1) with the calendar from
2387OpenBSD(1), thanks to a suggestion from Matt Zimmerman. Nicolas Évrard provided
2388calendar files for the EU and Belgium, and Martin Schulze provided a calendar
2389with Debian dates.
2390
2391See /usr/share/doc/bsdmainutils/source.data.gz for more information on calendar
2392sources.
2393
2394$Id$
2395 This is a collection of programs from 4.4BSD-Lite that have not (yet)
2396been re-written by FSF as GNU. It was constructed for inclusion in
2397Debian Linux. As programs found here become available from GNU sources,
2398they will be replaced.
2399
2400This package was originally put together by Austin Donnelly
2401<and1000@debian.org>, but is heavily based on bsdutils, originally put
2402together by Ian Murdock <imurdock@gnu.ai.mit.edu>. Please report any
2403problems or suggested additions or changes to Austin Donnelly.
2404
2405Then the package has been maintained by Charles Briscoe-Smith
2406<cpbs@debian.org>. I gathered data for the 1999-2001 calendar files
2407from various sources on the Internet, and I'd also like to thank Oliver
2408Elphick, Julian Gilbey, Daniel Martin and Jaldhar H. Vyas for providing
2409much useful data on the various religous calendars. I have edited the
2410files they provided to fit calendar's requirements, so any errors should
2411be attributed to me.
2412
2413After cpbs@debian.org, Marco d'Itri <md@linux.it> maintained it for
2414almost two years, before Tollef Fog Heen <tfheen@debian.org> took over.
2415The package is now maintained by Graham Wilson <bob@decoy.wox.org>.
2416
2417This package may be redistributed under the terms of the UCB BSD
2418license:
2419
2420Copyright (C) 1980 -1998 The Regents of the University of California.
2421All rights reserved.
2422
2423Redistribution and use in source and binary forms, with or without
2424modification, are permitted provided that the following conditions
2425are met:
24261. Redistributions of source code must retain the above copyright
2427 notice, this list of conditions and the following disclaimer.
24282. Redistributions in binary form must reproduce the above copyright
2429 notice, this list of conditions and the following disclaimer in the
2430 documentation and/or other materials provided with the distribution.
24314. Neither the name of the University nor the names of its contributors
2432 may be used to endorse or promote products derived from this software
2433 without specific prior written permission.
2434
2435THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2436ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2437IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2438ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2439FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2440DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2441OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2442HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2443LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2444OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2445SUCH DAMAGE.
2446 Security hole in `script'
2447-------------------------
2448
2449The BSD `script' utility included in the `bsdutils' package is not
2450installed setuid root, and was not written to be. Sometimes the tty
2451`script' allocates is already owned by the appropriate user, in which
2452case there will be no problem. In other cases, `script' will not be
2453able to set the ownership or mode of the pty/tty pair it allocates,
2454and so it cannot prevent other processes reading or writing to the tty.
2455
2456The result of this is a security hole: during such a `script' session,
2457other users can read keystrokes from your tty, or write to your terminal,
2458without any warning or explicit authorisation. This means that any
2459password(s) or other sensitive data you enter during such a `script'
2460session are not secure against snooping, even if they are (properly)
2461not echoed to the screen.
2462
2463To protect against this, `script' tries to detect whether the tty
2464allocated for it by the C library's openpty() function is secure
2465against snooping. If it detects that there is a problem, `script'
2466issues a warning. If you see this warning, you should not enter any
2467sensitive data during the script session, and you should not trust the
2468output displayed, or that recorded in the `typescript' file, to be free
2469from tampering.
2470
2471This bug is due to a long-standing design flaw in UNIX, and is to be cured
2472shortly by the introduction of the UNIX98-style pty system supported
2473by GLIBC 2.1 and Linux 2.2. The UNIX98-style pty system makes use of
2474kernel support to create slave devices on the fly, with the correct
2475ownership and permissions already in place. This allows unprivileged
2476user programs to allocate pty/tty pairs securely, and eliminates the
2477race conditions currently present in pty allocation.
2478
2479When `script' is used on a system with UNIX98-style pty support in
2480the kernel and in libc, `script' will detect that its tty is secure,
2481and will not display the warning.
2482
2483Charles Briscoe-Smith <cpbs@debian.org> Wed, 9 Dec 1998 13:32:49 +0000
2484 This is the Debian GNU/Linux prepackaged version of util-linux.
2485
2486This package was put together by Guy Maor <maor@debian.org> and later
2487maintained by Sean 'Shaleh' Perry <shaleh@debian.org>, and Adrian Bunk
2488<bunk@stusta.de>.
2489
2490The current maintainer is LaMont Jones <lamont@debian.org>.
2491See also: git://git.debian.org/~lamont/util-linux.git
2492
2493It was downloaded from:
2494 ftp://ftp.us.kernel.org/pub/linux/utils/util-linux-ng/
2495
2496Upstream maintainers include:
2497 Maintainer: Karel Zak <kzak@redhat.com>
2498 Past Maintainer: Adrian Bunk <bunk@fs.tum.de>
2499 Past Maintainer: Andries Brouwer <aeb@cwi.nl>
2500 See also /usr/share/doc/util-linux/AUTHORS
2501
2502Copyright:
2503
2504 A variety of people and entities, as befits the nature of the package.
2505 See the individual sources for exact copyright holder information.
2506
2507License:
2508
2509 The project doesn't use same license for all code. There is code with:
2510
2511 * GPLv2+ (GNU General Public License version 2, or any later version)
2512
2513 * GPLv2 (GNU General Public License version 2)
2514
2515 * BSD with advertising
2516
2517 * Public Domain
2518
2519 Please, check source code for more details. A license is usually at the start
2520 of each source file.
2521
2522 Anything lacking an explicit license may be redistributed under the terms
2523 of the GNU GPL Version 2 or later found on Debian systems in the file
2524 /usr/share/common-licenses/GPL
2525 This package was debianized by Erik Andersen <andersee@debian.org> on
2526Sun, 18 Jun 2000 23:31:02 -0600
2527
2528It was downloaded from ftp://ftp.busybox.net/busybox
2529
2530BusyBox is an aggregate of multiple packages. These packages are copyrighted
2531by their respective authors.
2532
2533Copyright: 1999-2005 Erik Andersen
2534
2535License:
2536
2537 This package is free software; you can redistribute it and/or modify
2538 it under the terms of the GNU General Public License as published by
2539 the Free Software Foundation; version 2 dated June, 1991.
2540
2541 This package is distributed in the hope that it will be useful,
2542 but WITHOUT ANY WARRANTY; without even the implied warranty of
2543 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2544 GNU General Public License for more details.
2545
2546 You should have received a copy of the GNU General Public License
2547 along with this package; if not, write to the Free Software
2548 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
2549 MA 02110-1301, USA.
2550
2551On Debian GNU/Linux systems, the complete text of the GNU General
2552Public License can be found in `/usr/share/common-licenses/GPL-2'.
2553 This package was debianized by Erik Andersen <andersee@debian.org> on
2554Sun, 18 Jun 2000 23:31:02 -0600
2555
2556It was downloaded from ftp://ftp.busybox.net/busybox
2557
2558BusyBox is an aggregate of multiple packages. These packages are copyrighted
2559by their respective authors.
2560
2561Copyright: 1999-2005 Erik Andersen
2562
2563License:
2564
2565 This package is free software; you can redistribute it and/or modify
2566 it under the terms of the GNU General Public License as published by
2567 the Free Software Foundation; version 2 dated June, 1991.
2568
2569 This package is distributed in the hope that it will be useful,
2570 but WITHOUT ANY WARRANTY; without even the implied warranty of
2571 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2572 GNU General Public License for more details.
2573
2574 You should have received a copy of the GNU General Public License
2575 along with this package; if not, write to the Free Software
2576 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
2577 MA 02110-1301, USA.
2578
2579On Debian GNU/Linux systems, the complete text of the GNU General
2580Public License can be found in `/usr/share/common-licenses/GPL-2'.
2581 This package (bzip2) was created by Philippe Troin <phil@fifi.org>.
2582It is currently mantained by Anibal Monsalve Salazar <anibal@debian.org>.
2583This package is Copyright (C) 1999, 2000, 2001, 2002 Philippe Troin
2584<phil@fifi.org> and Copyright (C) 2004-2007 Anibal Monsalve Salazar.
2585It is licensed under the GNU General Public License which can be
2586found in /usr/share/common-licenses/GPL.
2587
2588It was downloaded from
2589 http://www.bzip.org/downloads.html
2590
2591For more information about bzip2, please visit:
2592 http://www.bzip.org/
2593
2594Author:
2595 Julian Seward <jseward@acm.org>
2596
2597Copyright: (from LICENSE)
2598
2599
2600--------------------------------------------------------------------------
2601
2602This program, "bzip2", the associated library "libbzip2", and all
2603documentation, are copyright (C) 1996-2010 Julian R Seward. All
2604rights reserved.
2605
2606Redistribution and use in source and binary forms, with or without
2607modification, are permitted provided that the following conditions
2608are met:
2609
26101. Redistributions of source code must retain the above copyright
2611 notice, this list of conditions and the following disclaimer.
2612
26132. The origin of this software must not be misrepresented; you must
2614 not claim that you wrote the original software. If you use this
2615 software in a product, an acknowledgment in the product
2616 documentation would be appreciated but is not required.
2617
26183. Altered source versions must be plainly marked as such, and must
2619 not be misrepresented as being the original software.
2620
26214. The name of the author may not be used to endorse or promote
2622 products derived from this software without specific prior written
2623 permission.
2624
2625THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
2626OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
2627WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2628ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
2629DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2630DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
2631GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
2632INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
2633WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
2634NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
2635SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2636
2637Julian Seward, jseward@bzip.org
2638bzip2/libbzip2 version 1.0.6 of 6 September 2010
2639
2640--------------------------------------------------------------------------
2641 The Debian Package “ca-certificatesâ€Â
2642----------------------------------
2643
2644This package includes PEM files of CA certificates to allow SSL-based
2645applications to check for the authenticity of SSL connections.
2646
2647Please note that Debian can neither confirm nor deny whether the
2648certificate authorities whose certificates are included in this package
2649have in any way been audited for trustworthiness or RFC 3647 compliance.
2650Full responsibility to assess them belongs to the local system
2651administrator.
2652
2653The CA certificates contained in this package are installed into
2654“/usr/share/ca-certificatesâ€Â.
2655
2656The configuration file “/etc/ca-certificates.conf†is seeded with
2657trust information through Debconf. Just call “dpkg-reconfigure
2658ca-certificates†to adjust the settings.
2659
2660“update-ca-certificates†will then update “/etc/ssl/certs†which may be
2661used by the web browsers in Debian. It will also generate the hash
2662symlinks and generate a single-file version in
2663“/etc/ssl/certs/ca-certificates.crtâ€Â.
2664
2665If you want to install local certificate authorities to be implicitly
2666trusted, please put the certificate files as single files ending with
2667“.crt“ into “/usr/local/share/ca-certificates†and re-run
2668“update-ca-certificatesâ€Â. If you want to prepare a local package
2669of your certificates, you should depend on “ca-certificates“, install
2670the PEM files into “/usr/local/share/ca-certificates†as above and call
2671“update-ca-certificates†in the package's “postinst“.
2672
2673How certificates will be accepted into the ca-certificates package
2674------------------------------------------------------------------
2675
2676 Option 1:
2677 - File a *GPG-signed* bug report against ca-certificates with
2678 *severity normal*. The bug report must include an attached
2679 copy of the PEM certificates of the CA, a link to and a
2680 description of the CA, the licence of the CA certificate
2681 and signed fingerprint and/or hash values of the certificate.
2682 - Get two or three recommendations from other people to the
2683 bug report, GPG-signed (preferably from the strong set).
2684 - CA certificates will not be accepted if requested by only
2685 one person.
2686
2687 Option 2:
2688 - Get it included into Mozilla's trust store.
2689 - File a bug against ca-certificates stating this fact.
2690 ca-certificates was originally written and maintained by Fumitoshi UKAI
2691<ukai@debian.or.jp> on Mon, 7 Jan 2002 21:16:51 +0900.
2692
2693The original source can always be found at:
2694ftp://ftp.debian.org/dists/unstable/main/source/
2695
2696
2697sbin/update-ca-certificates:
2698
2699 Copyright (c) 2003 Fumitoshi UKAI <ukai@debian.or.jp>
2700 Copyright (c) 2009 Philipp Kern <pkern@debian.org>
2701
2702 This program is free software; you can redistribute it and/or modify
2703 it under the terms of the GNU General Public License as published by
2704 the Free Software Foundation; either version 2 of the License, or
2705 (at your option) any later version.
2706
2707 This program is distributed in the hope that it will be useful,
2708 but WITHOUT ANY WARRANTY; without even the implied warranty of
2709 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2710 GNU General Public License for more details.
2711
2712 You should have received a copy of the GNU General Public License
2713 along with this program; if not, write to the Free Software
2714 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,
2715 USA.
2716
2717mozilla/certdata2pem.py:
2718
2719 Copyright (c) 2009 Philipp Kern <pkern@debian.org>
2720 (based on a Ruby script by Fumitoshi UKAI)
2721 Licensed under the same license as sbin/update-ca-certificates.
2722
2723CA certificates from Mozilla as follows:
2724# The contents of this file are subject to the Mozilla Public
2725# License Version 1.1 (the "License"); you may not use this file
2726# except in compliance with the License. You may obtain a copy of
2727# the License at http://www.mozilla.org/MPL/
2728#
2729# Software distributed under the License is distributed on an "AS
2730# IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
2731# implied. See the License for the specific language governing
2732# rights and limitations under the License.
2733#
2734# The Original Code is the Netscape security libraries.
2735#
2736# The Initial Developer of the Original Code is Netscape
2737# Communications Corporation. Portions created by Netscape are
2738# Copyright (C) 1994-2000 Netscape Communications Corporation. All
2739# Rights Reserved.
2740#
2741# Contributor(s):
2742#
2743# Alternatively, the contents of this file may be used under the
2744# terms of the GNU General Public License Version 2 or later (the
2745# "GPL"), in which case the provisions of the GPL are applicable
2746# instead of those above. If you wish to allow use of your
2747# version of this file only under the terms of the GPL and not to
2748# allow others to use your version of this file under the MPL,
2749# indicate your decision by deleting the provisions above and
2750# replace them with the notice and other provisions required by
2751# the GPL. If you do not delete the provisions above, a recipient
2752# may use your version of this file under either the MPL or the
2753# GPL.
2754
2755On Debian GNU/Linux systems, the complete text of the GNU General Public
2756License can be found in '/usr/share/common-licenses/GPL'.
2757
2758 This is Checkbox which provides an extensible interface for system testing.
2759
2760See the following page for documentation:
2761
2762https://wiki.ubuntu.com/Testing/Automation/Checkbox
2763 This package was debianized by Marc Tardif <marc.tardif@canonical.com> Mon,
276417 Sep 2007 17:25:54 -0300.
2765
2766It was downloaded from http://launchpad.net/checkbox
2767
2768Upstream Authors:
2769 Marc Tardif <marc.tardif@canonical.com>
2770 Christian Reis <christian.reis@canonical.com>
2771 David Murphy <david.murphy@canonical.com>
2772 Martin Pitt <martin.pitt@ubuntu.com>
2773 Gustavo Niemeyer <gustavo@niemeyer.net>
2774
2775Copyright:
2776 Copyright 2008 Canonical Ltd.
2777 Copyright 2006 Gustavo Niemeyer
2778
2779License:
2780
2781 This package is free software: you can redistribute it and/or modify
2782 it under the terms of the GNU General Public License as published by
2783 the Free Software Foundation, either version 3 of the License, or
2784 (at your option) any later version.
2785
2786 This program is distributed in the hope that it will be useful,
2787 but WITHOUT ANY WARRANTY; without even the implied warranty of
2788 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2789 GNU General Public License for more details.
2790
2791 You should have received a copy of the GNU General Public License
2792 along with this program. If not, see <http://www.gnu.org/licenses/>.
2793
2794On Debian systems, the complete text of the GNU General
2795Public License can be found in `/usr/share/common-licenses/GPL'.
2796 This package was debianized by Marc Tardif <marc.tardif@canonical.com> Mon,
279717 Sep 2007 17:25:54 -0300.
2798
2799It was downloaded from http://launchpad.net/checkbox
2800
2801Upstream Authors:
2802 Marc Tardif <marc.tardif@canonical.com>
2803 Christian Reis <christian.reis@canonical.com>
2804 David Murphy <david.murphy@canonical.com>
2805 Martin Pitt <martin.pitt@ubuntu.com>
2806 Gustavo Niemeyer <gustavo@niemeyer.net>
2807
2808Copyright:
2809 Copyright 2008 Canonical Ltd.
2810 Copyright 2006 Gustavo Niemeyer
2811
2812License:
2813
2814 This package is free software: you can redistribute it and/or modify
2815 it under the terms of the GNU General Public License as published by
2816 the Free Software Foundation, either version 3 of the License, or
2817 (at your option) any later version.
2818
2819 This program is distributed in the hope that it will be useful,
2820 but WITHOUT ANY WARRANTY; without even the implied warranty of
2821 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2822 GNU General Public License for more details.
2823
2824 You should have received a copy of the GNU General Public License
2825 along with this program. If not, see <http://www.gnu.org/licenses/>.
2826
2827On Debian systems, the complete text of the GNU General
2828Public License can be found in `/usr/share/common-licenses/GPL'.
2829 cmap-adobe-japan2 for Debian
2830----------------------
2831
2832The use of the Adobe-Japan2-0 character collection is now deprecated
2833because the Adobe-Japan1-6 character collection made it
2834obsolete.
2835
2836 -- Kenshi Muto <kmuto@debian.org>, Thu, 1 Oct 2009 21:22:17 +0900
2837
2838 This package was debianized by Yasuhiro Take <take@debian.org> on
2839Fri, 1 Dec 2000 19:26:17 +0900.
2840
2841It was downloaded from http://opensource.adobe.com/wiki/display/cmap/Downloads
2842
2843Upstream Author:
2844
2845 Adobe Systems Incorporated.
2846
2847Copyright:
2848
2849 Copyright (C) 1990-2009 Adobe Systems Incorporated.
2850
2851License:
2852
2853 Copyright 1990-2009 Adobe Systems Incorporated.
2854 All rights reserved.
2855
2856 Redistribution and use in source and binary forms, with or
2857 without modification, are permitted provided that the
2858 following conditions are met:
2859
2860 Redistributions of source code must retain the above
2861 copyright notice, this list of conditions and the following
2862 disclaimer.
2863
2864 Redistributions in binary form must reproduce the above
2865 copyright notice, this list of conditions and the following
2866 disclaimer in the documentation and/or other materials
2867 provided with the distribution.
2868
2869 Neither the name of Adobe Systems Incorporated nor the names
2870 of its contributors may be used to endorse or promote
2871 products derived from this software without specific prior
2872 written permission.
2873
2874 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
2875 CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
2876 INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
2877 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
2878 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
2879 CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
2880 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
2881 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
2882 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2883 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
2884 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
2885 OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
2886 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2887
2888The Debian packaging is (C) 2000-2001 Yasuhiro Take <take@debian.org>,
28892003-2007 Akira TAGOH <tagoh@debian.org>, 2007-2009 Kenshi Muto
2890<kmuto@debian.org> and Masayuki Hatta <mhatta@debian.org>, and
2891is licensed under the GPL, see `/usr/share/common-licenses/GPL'.
2892
2893Note from http://opensource.adobe.com/wiki/display/cmap/License
2894------------------------------------------------------------------------
2895Although the license associated with the CMap resources clearly allows
2896changes to be made, we strongly discourage changes, especially when they
2897affect existing mappings. This is for reasons of compatibility. We do
2898welcome and encourage suggestions for additional mappings.
2899------------------------------------------------------------------------
2900 Format: http://dep.debian.net/deps/dep5
2901Upstream-Name: colord
2902Source: http://www.freedesktop.org/software/colord/
2903
2904Files: *
2905Copyright: © 2009-2011 Richard Hughes <richard@hughsie.com>
2906License: GPL-2+
2907
2908Files: libcolord/*
2909Copyright: © 2010-2011 Richard Huges <richard@hughsie.com>
2910License: LGPL-2.1+
2911
2912Files: libcolord/colord.h
2913Copyright: © 2010-2011 Richard Hughes <richard@hughsie.com>
2914License: GPL-2+
2915
2916Files: libcolord/cd-color.h
2917Copyright: © 2010 Richard Hughes <richard@hughsie.com>
2918License: GPL-2+
2919
2920Files: examples/*
2921Copyright: © 2011 Richard Hughes <richard@hughsie.com>
2922License: LGPL-2.1+
2923
2924Files: doc/api/dbus/spec-to-docbook.xsl
2925Copyright: © 2007 William Jon McCann
2926License: GPL-2+
2927
2928Files: debian/*
2929Copyright: 2011 Christopher James Halse Rogers <raof@ubuntu.com>
2930License: GPL-2+
2931
2932License: GPL-2+
2933 This package is free software; you can redistribute it and/or modify
2934 it under the terms of the GNU General Public License as published by
2935 the Free Software Foundation; either version 2 of the License, or
2936 (at your option) any later version.
2937 .
2938 This package is distributed in the hope that it will be useful,
2939 but WITHOUT ANY WARRANTY; without even the implied warranty of
2940 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2941 GNU General Public License for more details.
2942 .
2943 You should have received a copy of the GNU General Public License
2944 along with this program. If not, see <http://www.gnu.org/licenses/>
2945 .
2946 On Debian systems, the complete text of the GNU General
2947 Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
2948
2949License: LGPL-2.1+
2950 This library is free software; you can redistribute it and/or
2951 modify it under the terms of the GNU Lesser General Public
2952 License as published by the Free Software Foundation; either
2953 version 2.1 of the License, or (at your option) any later version.
2954 .
2955 This library is distributed in the hope that it will be useful,
2956 but WITHOUT ANY WARRANTY; without even the implied warranty of
2957 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
2958 Lesser General Public License for more details.
2959 .
2960 You should have received a copy of the GNU Lesser General Public
2961 License along with this library; if not, write to the Free Software
2962 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
2963 This application implements the command-not-found spec at:
2964https://wiki.ubuntu.com/CommandNotFoundMagic
2965
2966If you want automatic prompts to install the package, set
2967COMMAND_NOT_FOUND_INSTALL_PROMPT in your environment.
2968
2969To use it in bash, please add the following line to your .bashrc file:
2970. /etc/bash_command_not_found
2971
2972To use it in zsh, please add the following line to your .zshrc file:
2973. /etc/zsh_command_not_found
2974Note that it overrides the preexec and precmd functions, in case you have
2975defined your own.
2976 This package was debianized by Michael Vogt <michael.vogt@ubuntu.com> on
2977Fri, 31 May 2005 10:10:41 +0100.
2978
2979It was downloaded via bzr from
2980https://code.launchpad.net/~zkrynicki/command-not-found/main
2981
2982The ubuntu source is at:
2983https://code.edge.launchpad.net/~ubuntu-core-dev/command-not-found/ubuntu
2984
2985Upstream Author: Zygmunt Krynicki <zkrynicki@gmail.com>
2986 Michael Vogt <michael.vogt@ubuntu.com>
2987
2988Copyright: GPL, see /usr/share/common-licenses/GPL
2989
2990 This package was debianized by Michael Vogt <michael.vogt@ubuntu.com> on
2991Fri, 31 May 2005 10:10:41 +0100.
2992
2993It was downloaded via bzr from
2994https://code.launchpad.net/~zkrynicki/command-not-found/main
2995
2996The ubuntu source is at:
2997https://code.edge.launchpad.net/~ubuntu-core-dev/command-not-found/ubuntu
2998
2999Upstream Author: Zygmunt Krynicki <zkrynicki@gmail.com>
3000 Michael Vogt <michael.vogt@ubuntu.com>
3001
3002Copyright: GPL, see /usr/share/common-licenses/GPL
3003
3004 This package was debianized by Thierry Reding <thierry@gilfi.de> on
3005Fri, 18 Aug 2006 09:46:24 +0200.
3006
3007It was downloaded from http://xorg.freedesktop.org/releases/individual/app.
3008
3009Upstream author: David Reveman <davidr@novell.com>
3010Contributors:
3011 Radek Doulik <rodo@novell.com>
3012 Jeremy C. Reed <reed@reedmedia.net>
3013 Dan Winship <danw@novell.com>
3014 Kristian Høgsberg <krh@redhat.com>
3015
3016------------------------------------------------------------------------------
3017
3018The original source tarball was repackaged to remove the following generated
3019and/or unused files:
3020
3021 kde/window-decorator/*.moc.cpp
3022 kde/window-decorator/KWinInterface_skel.cpp
3023 po/*.gmo
3024
3025------------------------------------------------------------------------------
3026
3027Copyright:
3028
3029This software is copyright © 2005, 2006 Novell, Inc.
3030
3031You can redistribute this software and/or modify it under the terms of the GNU
3032General Public License as published by the Free Software Foundation; version 2
3033dated June, 1991.
3034
3035This program is distributed in the hope that it will be useful, but-
3036WITHOUT ANY WARRANTY; without even the implied warranty of
3037MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU-
3038General Public License for more details.
3039
3040------------------------------------------------------------------------------
3041
3042The convertProperty / convert_property and handleSelectionRequest /
3043handle_selection_request functions in 'src/display.c' and
3044'gtk/window-decorator/gtk-window-decorator.c' are taken from the source code
3045of fvwm2 and copyright © Matthias Clasen and Dominik Vogt.
3046
3047Parts of the code in 'src/window.c':
3048
3049 /* Ater gdk_window_constrain_size(), which is partially borrowed from fvwm.
3050 *
3051 * Copyright 1993, Robert Nation
3052 * You may use this code for any purpose, as long as the original
3053 * copyright remains in the source code and all documentation
3054 *
3055 * which in turn borrows parts of the algorithm from uwm
3056 */
3057
3058------------------------------------------------------------------------------
3059-- Plugins: --
3060--------------
3061
3062Skydome support for the 'cube' plugin was written by Mirco Müller
3063<macslow@bangang.de>.
3064
3065For the 'place' plugin:
3066
3067 /*
3068 * Copyright (C) 2001 Havoc Pennington
3069 * Copyright (C) 2002, 2003 Red Hat, Inc.
3070 * Copyright (C) 2003 Rob Adams
3071 * Copyright (C) 2005 Novell, Inc.
3072 *
3073 * This program is free software; you can redistribute it and/or
3074 * modify it under the terms of the GNU General Public License as
3075 * published by the Free Software Foundation; either version 2 of the
3076 * License, or (at your option) any later version.
3077 *
3078 * This program is distributed in the hope that it will be useful, but
3079 * WITHOUT ANY WARRANTY; without even the implied warranty of
3080 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
3081 * General Public License for more details.
3082 *
3083 * You should have received a copy of the GNU General Public License
3084 * along with this program; if not, write to the Free Software
3085 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
3086 * 02110-1301, USA.
3087 */
3088
3089The 'plane' plugin was written by Søren Sandmann <sandmann@redhat.com>:
3090
3091 /*
3092 * Copyright © 2006 Red Hat, Inc.
3093 *
3094 * Permission to use, copy, modify, distribute, and sell this software
3095 * and its documentation for any purpose is hereby granted without
3096 * fee, provided that the above copyright notice appear in all copies
3097 * and that both that copyright notice and this permission notice
3098 * appear in supporting documentation, and that the name of
3099 * Red Hat, Inc. not be used in advertising or publicity pertaining to
3100 * distribution of the software without specific, written prior permission.
3101 * Red Hat, Inc. makes no representations about the suitability of this
3102 * software for any purpose. It is provided "as is" without express or
3103 * implied warranty.
3104 *
3105 * RED HAT, INC. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
3106 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
3107 * NO EVENT SHALL RED HAT, INC. BE LIABLE FOR ANY SPECIAL, INDIRECT OR
3108 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
3109 * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
3110 * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
3111 * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
3112 *
3113 * Author: Søren Sandmann <sandmann@redhat.com>
3114 */
3115
3116------------------------------------------------------------------------------
3117-- Translations: --
3118-------------------
3119
3120The Finnish translation in 'po/fi.po' is copyright © 2003 SuSE Linux AG and ©
31212005 SUSE Linux Products GmbH.
3122
3123The Polish translation in 'po/pl.po' are copyright © 2005 SUSE Linux Products
3124GmbH.
3125
3126The makefile 'po/Makefile.in.in' is copyright © 1995, 1996, 1997 by Ulrich
3127Drepper <drepper@gnu.ai.mit.edu>.
3128
3129------------------------------------------------------------------------------
3130
3131The Debian packaging is copyright © 2006, 2007 by Thierry Reding
3132<thierry@gilfi.de> and is licensed under the GPL, see
3133`/usr/share/common-licenses/GPL'.
3134 compiz - OpenGL window and compositing manager
3135
3136Compiz is an OpenGL compositing manager that use GLX_EXT_texture_from_pixmap
3137for binding redirected top-level windows to texture objects. It has a flexible
3138plug-in system and it is designed to run well on most graphics hardware.
3139
3140David Reveman
3141davidr@novell.com
3142 Xorg Server Configuration
3143=========================
3144
3145In order for compiz to work you need to add the following to you server
3146configuration file (/etc/X11/xorg.conf):
3147
3148 + Enable the composite extension: locate the section named "Extensions" and
3149 add the following line:
3150
3151 Option "Composite" "enable"
3152
3153 If there is no section "Extensions" yet, you should add one that looks
3154 like this:
3155
3156 Section "Extensions"
3157 Option "Composite" "enable"
3158 EndSection
3159
3160 + Make XAA not hold any pixmaps in offscreen memory. This slows down compiz
3161 in many configurations. You can disable this by adding the following line
3162 to your "Device" section:
3163
3164 Option "XAANoOffscreenPixmaps" "true"
3165
3166Now restart your X server and login to your favorite session. After the
3167session has loaded completely, open a terminal window and type the following
3168command:
3169
3170 $ compiz --replace &
3171
3172Which will start compiz, make it replace the current window manager and
3173background the process so you can safely close the terminal again. If all went
3174well, compiz should start up and enable a whole bunch of desktop effects.
3175
3176 -- Thierry Reding <thierry@gilfi.de> Tue, 3 Oct 2006 14:12:26 +0200
3177
3178
3179General:
3180
3181* Session management
3182
3183* Various window management improvements
3184
3185* Window shade mode
3186
3187* Support for multiple desktops
3188
3189* Multi-screen support
3190
3191
3192KDE:
3193
3194* Remove glib dependency from place plugin
3195
3196* QT/KDE configuration plugin similar to the gconf plugin
3197
3198* QT/KDE decoration program
3199Repos Merger <guillaume@segu.in>
3200Repos Merger <reposmerger@opencompositing.org>
3201Sam Spilsbury <SmSpillaz@gmail.com>
3202Sam Spilsbury <sam.spilsbury@canonical.com>
3203Sam Spilsbury <smspillaz@gmail.com>
3204Scott Moreau <oreaus@gmail.com>
3205 This package was debianized by Sean Finney <seanius@debian.org>.
3206
3207It was downloaded from git://anongit.compiz-fusion.org/fusion/plugins-main
3208
3209Upstream Authors (Lead Developers, see AUTHORS for full list):
3210
3211 Danny Baumann <dannybaumann@web.de>
3212 David Reveman <davidr@novell.com>
3213 Dennis Kasprzyk <onestone@opencompositing.org>
3214 Erkin Bahceci <erkinbah@gmail.com>
3215 Guillaume Seguin - iXce <guillaume@segu.in>
3216 Kristian Lyngstøl <kristian@bohemians.org>
3217
3218License:
3219
3220 GPL, see `/usr/share/common-licenses/GPL'
3221
3222The Debian packaging is (C) 2007, sean finney <seanius@debian.org> and
3223is licensed under the GPL, see `/usr/share/common-licenses/GPL'.
3224 Christopher Williams <christopherw@verizon.net>
3225Danny Baumann <dannybaumann@web.de>
3226Dennis Kasprzyk <onestone@beryl-project.org>
3227Dennis Kasprzyk <onestone@opencompositing.org>
3228Didier Roche <didrocks@ubuntu.com>
3229Erkin Bahceci <erkinbah@gmail.com>
3230Guido Iribarren <guidoweb@guidoi.com.ar>
3231Guillaume Seguin <guillaume@segu.in>
3232Jigish Gohil <cyberorg@prime.(none)>
3233Kristian Lyngstøl <kristian@albus.(none)>
3234Robert Carr <racarr@gorbie.(none)>
3235Sam Spilsbury <SmSpillaz@gmail.com>
3236Sam Spilsbury <sam.spilsbury@canonical.com>
3237Sam Spilsbury <smspillaz@XPS-FEDORA.(none)>
3238Sam Spilsbury <smspillaz@XPS-UNITY.(none)>
3239Sam Spilsbury <smspillaz@gmail.com>
3240Scott Moreau <oreaus@gmail.com>
3241maniac <maniac>
3242 This package was debianized by Sean Finney <seanius@debian.org>.
3243
3244It was downloaded from git://anongit.compiz-fusion.org/fusion/compizconfig/compizconfig-backend-gconf
3245
3246Upstream Authors (Lead Developers, see AUTHORS for full list):
3247
3248 Danny Baumann <dannybaumann@web.de>
3249 David Reveman <davidr@novell.com>
3250 Dennis Kasprzyk <onestone@opencompositing.org>
3251 Erkin Bahceci <erkinbah@gmail.com>
3252 Guillaume Seguin - iXce <guillaume@segu.in>
3253 Kristian Lyngstøl <kristian@bohemians.org>
3254
3255License:
3256
3257 GPL, see `/usr/share/common-licenses/GPL'
3258
3259The Debian packaging is (C) 2007, sean finney <seanius@debian.org> and
3260is licensed under the GPL, see `/usr/share/common-licenses/GPL'.
3261
3262 Since the installation scripts of this package ask most of the Debconf
3263questions with low or medium priority, you may want to use
3264
3265dpkg-reconfigure console-setup
3266
3267in order to fine-tune your keyboard setup.
3268
3269Please notice that this package does not conflict with other packages
3270that configure the console.
3271
3272If 'kbd' and 'console-setup' are installed, then 'console-setup'
3273configures the font and the keyboard on the console and 'kbd' the rest
3274(i.e. NumLock state, keyboard repeat rate).
3275
3276If 'console-tools' and 'console-setup' are installed, then both
3277packages will try to configure the font and the keyboard. However
3278'console-setup' configures after 'console-tools' so its font and
3279keyboard will be used.
3280
3281If 'console-cyrillic' and 'console-setup' are installed, then both
3282packages will try to configure the font and the keyboard. However
3283'console-cyrillic configures after 'console-setup' so its font and
3284keyboard will be used. It is probably a good idea to uninstall
3285'console-cyrillic' because 'console-setup' provides better support.
3286
3287 -- Anton Zinoviev <zinoviev@debian.org>, Wed, 3 Jun 2009 00:51:02 +0300
3288 All console fonts are public domain by nature. The source BDF-fonts
3289are distributed under many different licenses, see in the file
3290copyright.fonts for details.
3291
3292Everything else in this package is
3293
3294Copyright (c) 1999,2000,2001,2002,2003,2006 Anton Zinoviev, zinoviev@debian.org
3295
3296It is distributed under terms of the GNU General Public License
3297version 2.0 or (at your choice) any later version.
3298
3299It is distributed in the hope that it will be useful, but WITHOUT ANY
3300WARRANTY; without even the implied warranty of MERCHANTABILITY or
3301FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
3302for more details.
3303
3304You should have received a copy of the GNU Lesser General Public
3305License along with this library; if not, write to the Free Software
3306Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
330702110-1301, USA
3308
3309On Debian GNU/Linux systems, the complete text of the GNU General
3310Public License can be found in `/usr/share/common-licenses/GPL'.
3311 William Jon McCann <william.jon.mccann@gmail.com>
3312 <?xml version="1.0" encoding="UTF-8"?>
3313<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3314<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 />
3315            <code class="email"><<a class="email" href="mailto:william.jon.mccann@gmail.com">william.jon.mccann@gmail.com</a>></code><br />
3316          </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>
3317 </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>
3318 ConsoleKit is a framework for keeping track of the various
3319 users, sessions, and seats present on a system. It
3320 provides a mechanism for software to react to changes of any of
3321 these items or of any of the metadata associated with them.
3322 </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>
3323 To be written.
3324 </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>
3325 To be written.
3326 </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>
3327A session is a collection of all processes that share knowledge of a
3328secret. In the typical (or ideal) case, these processes all originate
3329from a single common ancestor.
3330 </p><p>
3331As an implementation detail, for now, this secret should be stored in
3332the process environment by the session leader under the name
3333XDG_SESSION_COOKIE. When and if we are able to take advantage of a
3334mechanism in the underlying system to store session registration
3335information - we will. However, such a mechanism is not known at the
3336present time.
3337 </p><p>
3338Using an environment variable does have certain advantages. For one,
3339it is quite easy for a process to opt-out of a Session by simply
3340unsetting the XDG_SESSION_COOKIE variable.
3341 </p><p>
3342Limitations of using an environment variable implementation include
3343not being able to strictly limit visibility of the secret to a particular
3344process ancestry. So, it is not possible to enforce session boundaries
3345other than on a per-user basis. For example, we don't yet have a way
3346to prevent a process from moving between sessions owned by the same
3347user.
3348 </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>
3349The session leader is the process that requests that a new session be
3350opened. It does this by connecting to the D-Bus system bus and using
3351either org.freedesktop.ConsoleKit.Manager.OpenSession() or
3352org.freedesktop.ConsoleKit.Manager.OpenSessionWithParameters(). The session
3353that it registers will remain open until the connection to the system
3354bus is lost or it calls org.freedesktop.ConsoleKit.Manager.CloseSession().
3355 </p><p>
3356The session leader is the only process for which CloseSession() will
3357be allowed.
3358 </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>
3359A seat is a collection of sessions and a set of hardware (usually at
3360least a keyboard and mouse). Only one session may be active on a
3361seat at a time.
3362 </p><p>
3363At the present time, all Sessions that are considered "local" to
3364a system will be added the the first Seat and every other Session
3365will be added to its own Seat.
3366 </p><p>
3367True, hardware, multi-seat capabilities will be added in a later release.
3368 </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>
3369The session leader process is responsible for asking
3370ConsoleKit to open a new session. In this respect, it is
3371similar to the traditional POSIX user login accounting framework.
3372In the typical case, the session leader is either an immediate descendant of
3373a 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().
3374 </p><p>
3375If 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.
3376 </p><p>
3377At this point the session will be registered with ConsoleKit and a particular
3378set of information about the session will be stored along with it.
3379 </p><p>
3380ConsoleKit will decide, based on the information associated with the session, what Seat the session will be added to.
3381 </p><p>
3382It 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.
3383 </p><p>
3384The 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.
3385 </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:
3386 </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:
3387 </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:
3388 </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:
3389 </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:
3390 </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:
3391 </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:
3392 </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>
3393 ConsoleKit provides a D-Bus API for programs to obtain information about the
3394 users, sessions, and seats that are present on a system.
3395 </p><p>
3396 Please see the other sections of this manual for an introduction to
3397 these concepts.
3398 </p><p>
3399 This API is not yet stable and is likely to change in the future.
3400 </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> ()
3401<a class="link" href="#Manager.CanRestart">CanRestart</a> (out 'b' can_restart)
3402<a class="link" href="#Manager.Stop">Stop</a> ()
3403<a class="link" href="#Manager.CanStop">CanStop</a> (out 'b' can_stop)
3404<a class="link" href="#Manager.OpenSession">OpenSession</a> (out 's' cookie)
3405<a class="link" href="#Manager.OpenSessionWithParameters">OpenSessionWithParameters</a> (in 'a(sv)' parameters,
3406 out 's' cookie)
3407<a class="link" href="#Manager.CloseSession">CloseSession</a> (in 's' cookie,
3408 out 'b' result)
3409<a class="link" href="#Manager.GetSeats">GetSeats</a> (out 'ao' seats)
3410<a class="link" href="#Manager.GetSessions">GetSessions</a> (out 'ao' sessions)
3411<a class="link" href="#Manager.GetSessionForCookie">GetSessionForCookie</a> (in 's' cookie,
3412 out 'o' ssid)
3413<a class="link" href="#Manager.GetSessionForUnixProcess">GetSessionForUnixProcess</a> (in 'u' pid,
3414 out 'o' ssid)
3415<a class="link" href="#Manager.GetCurrentSession">GetCurrentSession</a> (out 'o' ssid)
3416<a class="link" href="#Manager.GetSessionsForUnixUser">GetSessionsForUnixUser</a> (in 'u' uid,
3417 out 'ao' sessions)
3418<a class="link" href="#Manager.GetSessionsForUser">GetSessionsForUser</a> (in 'u' uid,
3419 out 'ao' sessions)
3420<a class="link" href="#Manager.GetSystemIdleHint">GetSystemIdleHint</a> (out 'b' idle_hint)
3421<a class="link" href="#Manager.GetSystemIdleSinceHint">GetSystemIdleSinceHint</a> (out 's' iso8601_datetime)
3422</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)
3423<a class="link" href="#Manager::SeatRemoved">SeatRemoved</a> ('o' sid)
3424<a class="link" href="#Manager::SystemIdleHintChanged">SystemIdleHintChanged</a> ('b' hint)
3425</pre></div><div class="refsect1" title="Implemented Interfaces"><a id="idp3075152"></a><h2>Implemented Interfaces</h2><p>
3426 Objects implementing org.freedesktop.ConsoleKit.Manager also implements
3427 org.freedesktop.DBus.Introspectable,
3428 org.freedesktop.DBus.Properties
3429 </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>
3430 be created for the calling process. The properties of this new Session are set automatically
3431 from information collected about the calling process.
3432 </p><p>This new session exists until the calling process disconnects from the system bus or
3433 calls <a class="link" href="#Manager.CloseSession"><code class="function">CloseSession()</code></a>.
3434 </p><p>It is the responsibility of the calling process to set the environment variable
3435 XDG_SESSION_COOKIE to the value of the returned cookie. This cookie should only
3436 be made available to child processes of the caller so that they may be identified
3437 as members of this session.
3438 </p><p>See this simple example:
3439 </p><div class="informalexample"><pre class="programlisting">
3440 DBusError error;
3441 DBusMessage *message;
3442 DBusMessage *reply;
3443
3444 message = dbus_message_new_method_call ("org.freedesktop.ConsoleKit",
3445 "/org/freedesktop/ConsoleKit/Manager",
3446 "org.freedesktop.ConsoleKit.Manager",
3447 "OpenSession");
3448 if (message == NULL) {
3449 goto out;
3450 }
3451
3452 dbus_error_init (&error);
3453 reply = dbus_connection_send_with_reply_and_block (connector->connection,
3454 message,
3455 -1,
3456 &error);
3457 if (reply == NULL) {
3458 goto out;
3459 }
3460
3461 dbus_error_init (&error);
3462 if (! dbus_message_get_args (reply,
3463 &error,
3464 DBUS_TYPE_STRING, &cookie,
3465 DBUS_TYPE_INVALID)) {
3466 goto out;
3467 }
3468
3469 </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>
3470See also:
3471<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,
3472 out 's' cookie)</pre><p>This method requests that a new <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Session</a>
3473 be created for the calling process. The properties of this new Session are from the
3474 parameters provided.
3475 </p><p>This new session exists until the calling process disconnects from the system bus or
3476 calls <a class="link" href="#Manager.CloseSession"><code class="function">CloseSession()</code></a>.
3477 </p><p>It is the responsibility of the calling process to set the environment variable
3478 XDG_SESSION_COOKIE to the value of the returned cookie. This cookie should only
3479 be made available to child processes of the caller so that they may be identified
3480 as members of this session.
3481 </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>
3482See also:
3483<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,
3484 out 'b' result)</pre><p>This method is used to close the session identified by the supplied cookie.
3485 </p><p>The session can only be closed by the same process that opened the session.
3486 </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>
3487 that are currently present on the system.</p><p>Each Seat ID is an D-Bus object path for the object that implements the
3488 <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>
3489See also:
3490<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>
3491 that are currently present on the system.</p><p>Each Session ID is an D-Bus object path for the object that implements the
3492 <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>
3493See also:
3494<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,
3495 out 'o' ssid)</pre><p>Returns the session ID that is associated with the specified cookie.
3496 </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,
3497 out 'o' ssid)</pre><p>Attempts to determine the session ID for the specified
3498 POSIX process ID (pid).
3499 </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.
3500 </p><p>See this example of using dbus-send:
3501 </p><div class="informalexample"><pre class="programlisting">
3502 dbus-send --system --dest=org.freedesktop.ConsoleKit \
3503 --type=method_call --print-reply --reply-timeout=2000 \
3504 /org/freedesktop/ConsoleKit/Manager \
3505 org.freedesktop.ConsoleKit.Manager.GetCurrentSession
3506 </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,
3507 out 'ao' sessions)</pre><p>This gets a list of all the <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Sessions</a>
3508 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
3509 <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,
3510 out 'ao' sessions)</pre><p>This gets a list of all the <a class="link" href="#Session" title="org.freedesktop.ConsoleKit.Session">Sessions</a>
3511 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
3512 <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
3513
3514 <a class="link" href="#Manager.GetSessionsForUnixUser"><code class="function">GetSessionsForUnixUser</code></a>
3515instead.</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>
3516 property of every open session is TRUE or if there are no open sessions.
3517 </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
3518 the time of the last change of the system-idle-hint.
3519 </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.
3520 </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.
3521 </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.
3522 </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)
3523<a class="link" href="#Seat.GetSessions">GetSessions</a> (out 'ao' sessions)
3524<a class="link" href="#Seat.GetDevices">GetDevices</a> (out 'a(ss)' devices)
3525<a class="link" href="#Seat.GetActiveSession">GetActiveSession</a> (out 'o' ssid)
3526<a class="link" href="#Seat.CanActivateSessions">CanActivateSessions</a> (out 'b' can_activate)
3527<a class="link" href="#Seat.ActivateSession">ActivateSession</a> (in 'o' ssid)
3528</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)
3529<a class="link" href="#Seat::SessionAdded">SessionAdded</a> ('o' ssid)
3530<a class="link" href="#Seat::SessionRemoved">SessionRemoved</a> ('o' ssid)
3531<a class="link" href="#Seat::DeviceAdded">DeviceAdded</a> ('(ss)' device)
3532<a class="link" href="#Seat::DeviceRemoved">DeviceRemoved</a> ('(ss)' device)
3533</pre></div><div class="refsect1" title="Implemented Interfaces"><a id="idp3233192"></a><h2>Implemented Interfaces</h2><p>
3534 Objects implementing org.freedesktop.ConsoleKit.Seat also implements
3535 org.freedesktop.DBus.Introspectable,
3536 org.freedesktop.DBus.Properties
3537 </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
3538least a keyboard and mouse). Only one session may be active on a
3539seat 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>
3540 that are currently attached to this seat.</p><p>Each Session ID is an D-Bus object path for the object that implements the
3541 <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
3542 that are currently associated with this seat.</p><p>Each device is an D-Bus structure that represents
3543 the device type and the device id.
3544 </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
3545 cases, if successful, this will cause the session to
3546 become visible and take control of the hardware that is
3547 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>
3548See also:
3549<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)
3550<a class="link" href="#Session.GetSeatId">GetSeatId</a> (out 'o' sid)
3551<a class="link" href="#Session.GetSessionType">GetSessionType</a> (out 's' type)
3552<a class="link" href="#Session.GetUser">GetUser</a> (out 'u' uid)
3553<a class="link" href="#Session.GetUnixUser">GetUnixUser</a> (out 'u' uid)
3554<a class="link" href="#Session.GetX11Display">GetX11Display</a> (out 's' display)
3555<a class="link" href="#Session.GetX11DisplayDevice">GetX11DisplayDevice</a> (out 's' x11_display_device)
3556<a class="link" href="#Session.GetDisplayDevice">GetDisplayDevice</a> (out 's' display_device)
3557<a class="link" href="#Session.GetRemoteHostName">GetRemoteHostName</a> (out 's' remote_host_name)
3558<a class="link" href="#Session.GetLoginSessionId">GetLoginSessionId</a> (out 's' login_session_id)
3559<a class="link" href="#Session.IsActive">IsActive</a> (out 'b' active)
3560<a class="link" href="#Session.IsLocal">IsLocal</a> (out 'b' local)
3561<a class="link" href="#Session.GetCreationTime">GetCreationTime</a> (out 's' iso8601_datetime)
3562<a class="link" href="#Session.Activate">Activate</a> ()
3563<a class="link" href="#Session.Lock">Lock</a> ()
3564<a class="link" href="#Session.Unlock">Unlock</a> ()
3565<a class="link" href="#Session.GetIdleHint">GetIdleHint</a> (out 'b' idle_hint)
3566<a class="link" href="#Session.GetIdleSinceHint">GetIdleSinceHint</a> (out 's' iso8601_datetime)
3567<a class="link" href="#Session.SetIdleHint">SetIdleHint</a> (in 'b' idle_hint)
3568</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)
3569<a class="link" href="#Session::IdleHintChanged">IdleHintChanged</a> ('b' hint)
3570<a class="link" href="#Session::Lock">Lock</a> ()
3571<a class="link" href="#Session::Unlock">Unlock</a> ()
3572</pre></div><div class="refsect1" title="Implemented Interfaces"><a id="idp3318352"></a><h2>Implemented Interfaces</h2><p>
3573 Objects implementing org.freedesktop.ConsoleKit.Session also implements
3574 org.freedesktop.DBus.Introspectable,
3575 org.freedesktop.DBus.Properties
3576 </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'
3577<a class="link" href="#Session:user">'user'</a> readwrite 'u'
3578<a class="link" href="#Session:session-type">'session-type'</a> readwrite 's'
3579<a class="link" href="#Session:remote-host-name">'remote-host-name'</a> readwrite 's'
3580<a class="link" href="#Session:display-device">'display-device'</a> readwrite 's'
3581<a class="link" href="#Session:x11-display">'x11-display'</a> readwrite 's'
3582<a class="link" href="#Session:x11-display-device">'x11-display-device'</a> readwrite 's'
3583<a class="link" href="#Session:active">'active'</a> readwrite 'b'
3584<a class="link" href="#Session:is-local">'is-local'</a> readwrite 'b'
3585<a class="link" href="#Session:idle-hint">'idle-hint'</a> readwrite 'b'
3586</pre></div><div class="refsect1" title="Description"><a id="idp3323368"></a><h2>Description</h2><p>Session objects represent and store information
3587 related to a user session.
3588 </p><p>The properties associated with the Session
3589 specifically refer to the properties of the "session leader".
3590 </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
3591 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>
3592See also:
3593<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.
3594 It is probably best to avoid this until we do.
3595 </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>
3596See also:
3597<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
3598
3599 <a class="link" href="#Session.GetUnixUser"><code class="function">GetUnixUser</code></a>
3600instead.</p></div><p>
3601See also:
3602<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>
3603See also:
3604<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
3605 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>
3606See also:
3607<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
3608 X11 display for the session is connected to. If there is no x11-display set then this value
3609 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>
3610See also:
3611<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
3612 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>
3613See also:
3614<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.
3615 </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>
3616See also:
3617<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
3618 underlying system uses to enforce session boundaries. If there is no login session ID
3619 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
3620 it is attached to.</p><p>If the session is not attached to a seat this value is undefined.
3621 </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>
3622See also:
3623<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.
3624 It was originally used as a way to identify XDMCP sessions that originate
3625 from a remote system.
3626 </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>
3627See also:
3628<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
3629 the time that the session was opened.
3630 </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
3631 cases, if successful, this will cause the session to
3632 become visible and become active on the seat that it
3633 is attached to.</p><p>
3634See also:
3635<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>
3636 signal to be emitted for this session.
3637 </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>
3638See also:
3639<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>
3640 signal to be emitted for this session.
3641 </p><p>This can be used by login managers to unlock a session before it is
3642 re-activated during fast-user-switching.
3643 </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>
3644See also:
3645<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>
3646 property.
3647 </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>
3648See also:
3649<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
3650 the time of the last change of the idle-hint.
3651 </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
3652 it is idle.
3653 </p><p>Use of this method is restricted to the user
3654 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'
3655</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'
3656</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
3657
3658 <a class="link" href="#Session:unix-user"><code class="literal">unix-user</code></a>
3659instead.</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'
3660</pre><p>The type of the session.</p><p>Warning: we haven't yet defined the allowed values for this property.
3661 It is probably best to avoid this until we do.
3662 </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'
3663</pre><p>The remote host name for the session.
3664 </p><p>This will be set in situations where the session is
3665 opened and controlled from a remote system.
3666 </p><p>For example, this value will be set when the
3667 session is created from an SSH or XDMCP connection.
3668 </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'
3669</pre><p>The display device (aka TTY) that the
3670 session is connected to.
3671 </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'
3672</pre><p>Value of the X11 DISPLAY for this session
3673 if one is present.
3674 </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'
3675</pre><p>
3676 The display device (aka TTY) that the X11 display for the
3677 session is connected to. If there is no x11-display set then
3678 this value is undefined.
3679 </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'
3680</pre><p>
3681 Whether the session is active on the Seat that
3682 it is attached to.</p><p>If the session is not attached to a seat this value is undefined.
3683 </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'
3684</pre><p>
3685 Whether the session is local</p><p>FIXME: we need to come up with a concrete definition for this value.
3686 It was originally used as a way to identify XDMCP sessions that originate
3687 from a remote system.
3688 </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'
3689</pre><p>
3690 This is a hint used to indicate that the session may be idle.
3691 </p><p>
3692 For sessions with a <a class="link" href="#Session:x11-display"><code class="literal">x11-display</code></a> set (ie. graphical
3693 sessions), it is up to each session to delegate the
3694 responsibility for updating this value. Typically, the
3695 screensaver will set this.
3696 </p><p>However, for non-graphical sessions with a <a class="link" href="#Session:display-device"><code class="literal">display-device</code></a> set
3697 the Session object itself will periodically update this value based
3698 on the activity detected on the display-device itself.
3699 </p><p>
3700 This should not be considered authoritative.
3701 </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>
3702 What is ConsoleKit?
3703===================
3704
3705ConsoleKit is a framework for defining and tracking users, login
3706sessions, and seats.
3707
3708What is a seat?
3709===============
3710
3711A seat is a collection of sessions and a set of hardware (usually at
3712least a keyboard and mouse). Only one session may be active on a
3713seat at a time.
3714
3715What is a session?
3716==================
3717
3718A session is a collection of all processes that originate from a single
3719common ancestor and retain knowledge of a secret. As an implementation
3720detail, this secret may be stored in the process environment by the
3721login manager under the name XDG_SESSION_COOKIE.
3722
3723More Information
3724================
3725
3726http://www.freedesktop.org/wiki/Software/ConsoleKit
3727
3728Discussion takes place on the HAL list.
3729http://lists.freedesktop.org/mailman/listinfo/hal
3730 ConsoleKit for Debian
3731---------------------
3732
3733ConsoleKit allows programs to track seats and sessions. It either needs
3734integration into the login manager, like gdm, or it can go through a pam
3735module. Install the package libpam-ck-connector for that.
3736
3737 -- Michael Biebl <biebl@debian.org> Thu, 29 Mar 2007 01:38:27 +0200
3738 TODO
3739====
3740
3741 - Patch all login managers to open CK sessions
3742
3743 - Make a registration interface for per-session
3744 idle time delegates
3745
3746 - Report idle time per Seat
3747
3748 - Establish what session-types should be
3749
3750 - Improve the ck-list-sessions interface
3751
3752 - Complete the documentation
3753
3754 - Make openssh report sessions correctly
3755 Not as easy as just using the PAM module.
3756
3757 - Figure out how to register activation handlers
3758
3759 - Use a configuration file for defining how to add sessions to seats
3760 This package was debianized by Michael Biebl <biebl@debian.org> on
3761Thu, 29 Mar 2007 01:38:27 +0200.
3762
3763It was downloaded from http://people.freedesktop.org/~mccann/dist/.
3764
3765Upstream Author:
3766 William Jon McCann <mccann@jhu.edu>
3767
3768Copyright:
3769 Copyright (C) 2006 William Jon McCann <mccann@jhu.edu>
3770
3771License: GPL v2 or later
3772
3773 This package is free software; you can redistribute it and/or modify
3774 it under the terms of the GNU General Public License as published by
3775 the Free Software Foundation; either version 2 of the License, or
3776 (at your option) any later version.
3777
3778 This package is distributed in the hope that it will be useful,
3779 but WITHOUT ANY WARRANTY; without even the implied warranty of
3780 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3781 GNU General Public License for more details.
3782
3783 You should have received a copy of the GNU General Public License
3784 along with this package; if not, write to the Free Software
3785 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
3786
3787On Debian systems, the complete text of the GNU General
3788Public License can be found in `/usr/share/common-licenses/GPL-2'.
3789
3790===============================================================================
3791
3792libck-connector/*
3793pam-ck-connector/*
3794
3795Copyright:
3796 Copyright (c) 2007 David Zeuthen <davidz@redhat.com>
3797 Copyright (c) 2007 William Jon McCann <mccann@jhu.edu>
3798
3799License: MIT license
3800
3801 Permission is hereby granted, free of charge, to any person
3802 obtaining a copy of this software and associated documentation
3803 files (the "Software"), to deal in the Software without
3804 restriction, including without limitation the rights to use,
3805 copy, modify, merge, publish, distribute, sublicense, and/or sell
3806 copies of the Software, and to permit persons to whom the
3807 Software is furnished to do so, subject to the following
3808 conditions:
3809
3810 The above copyright notice and this permission notice shall be
3811 included in all copies or substantial portions of the Software.
3812
3813 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
3814 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
3815 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
3816 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
3817 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
3818 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
3819 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
3820 OTHER DEALINGS IN THE SOFTWARE.
3821
3822===============================================================================
3823
3824The Debian packaging is (C) 2007, Michael Biebl <biebl@debian.org> and
3825is licensed under the GPL, see above.
3826
3827 Here are the names of the programs in this package,
3828each followed by the name(s) of its author(s).
3829
3830arch: David MacKenzie, Karel Zak
3831base64: Simon Josefsson
3832basename: David MacKenzie
3833cat: Torbjörn Granlund, Richard M. Stallman
3834chcon: Russell Coker, Jim Meyering
3835chgrp: David MacKenzie, Jim Meyering
3836chmod: David MacKenzie, Jim Meyering
3837chown: David MacKenzie, Jim Meyering
3838chroot: Roland McGrath
3839cksum: Q. Frank Xia
3840comm: Richard M. Stallman, David MacKenzie
3841cp: Torbjörn Granlund, David MacKenzie, Jim Meyering
3842csplit: Stuart Kemp, David MacKenzie
3843cut: David M. Ihnat, David MacKenzie, Jim Meyering
3844date: David MacKenzie
3845dd: Paul Rubin, David MacKenzie, Stuart Kemp
3846df: Torbjörn Granlund, David MacKenzie, Paul Eggert
3847dir: Richard M. Stallman, David MacKenzie
3848dircolors: H. Peter Anvin
3849dirname: David MacKenzie, Jim Meyering
3850du: Torbjörn Granlund, David MacKenzie, Paul Eggert, Jim Meyering
3851echo: Brian Fox, Chet Ramey
3852env: Richard Mlynarik, David MacKenzie
3853expand: David MacKenzie
3854expr: Mike Parker, James Youngman, Paul Eggert
3855factor: Paul Rubin
3856false: Jim Meyering
3857fmt: Ross Paterson
3858fold: David MacKenzie
3859ginstall: David MacKenzie
3860groups: David MacKenzie, James Youngman
3861head: David MacKenzie, Jim Meyering
3862hostid: Jim Meyering
3863hostname: Jim Meyering
3864id: Arnold Robbins, David MacKenzie
3865join: Mike Haertel
3866kill: Paul Eggert
3867link: Michael Stone
3868ln: Mike Parker, David MacKenzie
3869logname: FIXME: unknown
3870ls: Richard M. Stallman, David MacKenzie
3871md5sum: Ulrich Drepper, Scott Miller, David Madore
3872mkdir: David MacKenzie
3873mkfifo: David MacKenzie
3874mknod: David MacKenzie
3875mktemp: Jim Meyering, Eric Blake
3876mv: Mike Parker, David MacKenzie, Jim Meyering
3877nice: David MacKenzie
3878nl: Scott Bartram, David MacKenzie
3879nohup: Jim Meyering
3880nproc: Giuseppe Scrivano
3881od: Jim Meyering
3882paste: David M. Ihnat, David MacKenzie
3883pathchk: Paul Eggert, David MacKenzie, Jim Meyering
3884pinky: Joseph Arceneaux, David MacKenzie, Kaveh Ghazi
3885pr: Pete TerMaat, Roland Huebner
3886printenv: David MacKenzie, Richard Mlynarik
3887printf: David MacKenzie
3888ptx: François Pinard
3889pwd: Jim Meyering
3890readlink: Dmitry V. Levin
3891rm: Paul Rubin, David MacKenzie, Richard M. Stallman, Jim Meyering
3892rmdir: David MacKenzie
3893runcon: Russell Coker
3894seq: Ulrich Drepper
3895sha1sum: Ulrich Drepper, Scott Miller, David Madore
3896sha224sum: Ulrich Drepper, Scott Miller, David Madore
3897sha256sum: Ulrich Drepper, Scott Miller, David Madore
3898sha384sum: Ulrich Drepper, Scott Miller, David Madore
3899sha512sum: Ulrich Drepper, Scott Miller, David Madore
3900shred: Colin Plumb
3901shuf: Paul Eggert
3902sleep: Jim Meyering, Paul Eggert
3903sort: Mike Haertel, Paul Eggert
3904split: Torbjörn Granlund, Richard M. Stallman
3905stat: Michael Meskes
3906stdbuf: Pádraig Brady
3907stty: David MacKenzie
3908su: David MacKenzie
3909sum: Kayvan Aghaiepour, David MacKenzie
3910sync: Jim Meyering
3911tac: Jay Lepreau, David MacKenzie
3912tail: Paul Rubin, David MacKenzie, Ian Lance Taylor, Jim Meyering
3913tee: Mike Parker, Richard M. Stallman, David MacKenzie
3914test: Kevin Braunsdorf, Matthew Bradburn
3915timeout: Pádraig Brady
3916touch: Paul Rubin, Arnold Robbins, Jim Kingdon, David MacKenzie, Randy Smith
3917tr: Jim Meyering
3918true: Jim Meyering
3919truncate: Pádraig Brady
3920tsort: Mark Kettenis
3921tty: David MacKenzie
3922uname: David MacKenzie
3923unexpand: David MacKenzie
3924uniq: Richard M. Stallman, David MacKenzie
3925unlink: Michael Stone
3926uptime: Joseph Arceneaux, David MacKenzie, Kaveh Ghazi
3927users: Joseph Arceneaux, David MacKenzie
3928vdir: Richard M. Stallman, David MacKenzie
3929wc: Paul Rubin, David MacKenzie
3930who: Joseph Arceneaux, David MacKenzie, Michael Stone
3931whoami: Richard Mlynarik
3932yes: David MacKenzie
3933
3934;; Local Variables:
3935;; coding: utf-8
3936;; End:
3937
3938 This is the Debian GNU/Linux packaged version of the GNU core
3939utilities.
3940
3941This package is maintained by Michael Stone <mstone@debian.org> and
3942built from sources obtained from:
3943 ftp://ftp.gnu.org/gnu/coreutils/coreutils-8.13.tar.gz
3944
3945This debian package was first created by Michael Stone <mstone@debian.org>,
3946from coreutils 4.5.1.
3947
3948Changes:
3949 * added Debian GNU/Linux package maintenance system files
3950 * at times, bug fixes awaiting inclusion in the upstream source
3951
3952
3953Authors
3954=======
3955
3956See the file AUTHORS.
3957
3958
3959Copyright Holders and License
3960=============================
3961
3962lib/fts.c
3963---------
3964
3965 Copyright (C) 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
3966
3967 This program is free software: you can redistribute it and/or modify
3968 it under the terms of the GNU General Public License as published by
3969 the Free Software Foundation; either version 3 of the License, or
3970 (at your option) any later version.
3971
3972 This program is distributed in the hope that it will be useful,
3973 but WITHOUT ANY WARRANTY; without even the implied warranty of
3974 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3975 GNU General Public License for more details.
3976
3977 You should have received a copy of the GNU General Public License
3978 along with this program. If not, see <http://www.gnu.org/licenses/>. */
3979
3980/*-
3981 * Copyright (c) 1990, 1993, 1994
3982 * The Regents of the University of California. All rights reserved.
3983 *
3984 * Redistribution and use in source and binary forms, with or without
3985 * modification, are permitted provided that the following conditions
3986 * are met:
3987 * 1. Redistributions of source code must retain the above copyright
3988 * notice, this list of conditions and the following disclaimer.
3989 * 2. Redistributions in binary form must reproduce the above copyright
3990 * notice, this list of conditions and the following disclaimer in the
3991 * documentation and/or other materials provided with the distribution.
3992 * 4. Neither the name of the University nor the names of its contributors
3993 * may be used to endorse or promote products derived from this software
3994 * without specific prior written permission.
3995 *
3996 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
3997 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
3998 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
3999 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
4000 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
4001 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
4002 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
4003 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
4004 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
4005 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
4006 * SUCH DAMAGE.
4007 */
4008
4009
4010lib/fts_.h
4011----------
4012
4013 Copyright (C) 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
4014
4015 This program is free software: you can redistribute it and/or modify
4016 it under the terms of the GNU General Public License as published by
4017 the Free Software Foundation; either version 3 of the License, or
4018 (at your option) any later version.
4019
4020 This program is distributed in the hope that it will be useful,
4021 but WITHOUT ANY WARRANTY; without even the implied warranty of
4022 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4023 GNU General Public License for more details.
4024
4025 You should have received a copy of the GNU General Public License
4026 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4027
4028/*
4029 * Copyright (c) 1989, 1993
4030 * The Regents of the University of California. All rights reserved.
4031 *
4032 * Redistribution and use in source and binary forms, with or without
4033 * modification, are permitted provided that the following conditions
4034 * are met:
4035 * 1. Redistributions of source code must retain the above copyright
4036 * notice, this list of conditions and the following disclaimer.
4037 * 2. Redistributions in binary form must reproduce the above copyright
4038 * notice, this list of conditions and the following disclaimer in the
4039 * documentation and/or other materials provided with the distribution.
4040 * 4. Neither the name of the University nor the names of its contributors
4041 * may be used to endorse or promote products derived from this software
4042 * without specific prior written permission.
4043 *
4044 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
4045 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
4046 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
4047 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
4048 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
4049 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
4050 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
4051 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
4052 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
4053 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
4054 * SUCH DAMAGE.
4055
4056
4057lib/rand-isaac.[ch]
4058-------------------
4059
4060 Copyright (C) 1999-2006 Free Software Foundation, Inc.
4061 Copyright (C) 1997, 1998, 1999 Colin Plumb.
4062
4063 This program is free software: you can redistribute it and/or modify
4064 it under the terms of the GNU General Public License as published by
4065 the Free Software Foundation, either version 3 of the License, or
4066 (at your option) any later version.
4067
4068 This program is distributed in the hope that it will be useful,
4069 but WITHOUT ANY WARRANTY; without even the implied warranty of
4070 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4071 GNU General Public License for more details.
4072
4073 You should have received a copy of the GNU General Public License
4074 along with this program. If not, see <http://www.gnu.org/licenses/>.
4075
4076
4077lib/inet_ntop.c
4078---------------
4079
4080 Copyright (C) 2005, 2006 Free Software Foundation, Inc.
4081
4082 This program is free software; you can redistribute it and/or modify
4083 it under the terms of the GNU General Public License as published by
4084 the Free Software Foundation; either version 3, or (at your option)
4085 any later version.
4086
4087 This program is distributed in the hope that it will be useful,
4088 but WITHOUT ANY WARRANTY; without even the implied warranty of
4089 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4090 GNU General Public License for more details.
4091
4092 You should have received a copy of the GNU General Public License
4093 along with this program; if not, write to the Free Software Foundation,
4094 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
4095
4096/*
4097 * Copyright (c) 1996-1999 by Internet Software Consortium.
4098 *
4099 * Permission to use, copy, modify, and distribute this software for any
4100 * purpose with or without fee is hereby granted, provided that the above
4101 * copyright notice and this permission notice appear in all copies.
4102 *
4103 * THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
4104 * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
4105 * OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
4106 * CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
4107 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
4108 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
4109 * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
4110 * SOFTWARE.
4111 */
4112
4113
4114m4/autobuild.m4
4115---------------
4116dnl Copyright (C) 2004, 2006, 2007 Free Software Foundation, Inc.
4117dnl This file is free software; the Free Software Foundation
4118dnl gives unlimited permission to copy and/or distribute it,
4119dnl with or without modifications, as long as this notice is preserved.
4120
4121dnl From Simon Josefsson
4122
4123
4124src/cut.c
4125---------
4126
4127 Copyright (C) 1997-2007 Free Software Foundation, Inc.
4128 Copyright (C) 1984 David M. Ihnat
4129
4130 This program is free software: you can redistribute it and/or modify
4131 it under the terms of the GNU General Public License as published by
4132 the Free Software Foundation, either version 3 of the License, or
4133 (at your option) any later version.
4134
4135 This program is distributed in the hope that it will be useful,
4136 but WITHOUT ANY WARRANTY; without even the implied warranty of
4137 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4138 GNU General Public License for more details.
4139
4140 You should have received a copy of the GNU General Public License
4141 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4142
4143
4144src/dircolors.c
4145---------------
4146
4147 Copyright (C) 1996-2007 Free Software Foundation, Inc.
4148 Copyright (C) 1994, 1995, 1997, 1998, 1999, 2000 H. Peter Anvin
4149
4150 This program is free software: you can redistribute it and/or modify
4151 it under the terms of the GNU General Public License as published by
4152 the Free Software Foundation, either version 3 of the License, or
4153 (at your option) any later version.
4154
4155 This program is distributed in the hope that it will be useful,
4156 but WITHOUT ANY WARRANTY; without even the implied warranty of
4157 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4158 GNU General Public License for more details.
4159
4160 You should have received a copy of the GNU General Public License
4161 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4162
4163
4164src/paste.c
4165-----------
4166
4167 Copyright (C) 1997-2005 Free Software Foundation, Inc.
4168 Copyright (C) 1984 David M. Ihnat
4169
4170 This program is free software: you can redistribute it and/or modify
4171 it under the terms of the GNU General Public License as published by
4172 the Free Software Foundation, either version 3 of the License, or
4173 (at your option) any later version.
4174
4175 This program is distributed in the hope that it will be useful,
4176 but WITHOUT ANY WARRANTY; without even the implied warranty of
4177 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4178 GNU General Public License for more details.
4179
4180 You should have received a copy of the GNU General Public License
4181 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4182
4183
4184src/shred.c
4185-----------
4186
4187 Copyright (C) 1999-2007 Free Software Foundation, Inc.
4188 Copyright (C) 1997, 1998, 1999 Colin Plumb.
4189
4190 This program is free software: you can redistribute it and/or modify
4191 it under the terms of the GNU General Public License as published by
4192 the Free Software Foundation, either version 3 of the License, or
4193 (at your option) any later version.
4194
4195 This program is distributed in the hope that it will be useful,
4196 but WITHOUT ANY WARRANTY; without even the implied warranty of
4197 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4198 GNU General Public License for more details.
4199
4200 You should have received a copy of the GNU General Public License
4201 along with this program. If not, see <http://www.gnu.org/licenses/>.
4202
4203
4204doc/coreutils.texi (The GNU Coreutils Manual)
4205---------------------------------------------
4206
4207Copyright @copyright{} 1994-1996, 2000-2008 Free Software Foundation, Inc.
4208
4209Permission is granted to copy, distribute and/or modify this document
4210under the terms of the GNU Free Documentation License, Version 1.2 or
4211any later version published by the Free Software Foundation; with no
4212Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
4213Texts. A copy of the license is included in the section entitled ``GNU
4214Free Documentation License''.
4215
4216
4217all other files
4218---------------
4219
4220Copyright (C) 1984-2008 Free Software Foundation, Inc.
4221
4222 This program is free software: you can redistribute it and/or modify
4223 it under the terms of the GNU General Public License as published by
4224 the Free Software Foundation, either version 3 of the License, or
4225 (at your option) any later version.
4226
4227 This program is distributed in the hope that it will be useful,
4228 but WITHOUT ANY WARRANTY; without even the implied warranty of
4229 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4230 GNU General Public License for more details.
4231
4232 You should have received a copy of the GNU General Public License
4233 along with this program. If not, see <http://www.gnu.org/licenses/>.
4234
4235On Debian systems, the complete text of the GNU General
4236Public License can be found in `/usr/share/common-licenses/GPL-3'.
4237 This is the Debian GNU/Linux prepackaged version of GNU cpio
4238(including mt).
4239
4240This package was put together by Clint Adams <schizo@debian.org>,
4241from sources obtained from ftp://ftp.gnu.org:/gnu/cpio
4242
4243GNU cpio is Copyright (C) 1990, 1991, 1992, 2001, 2003, 2004, 2005,
42442006, 2007 Free Software Foundation, Inc.
4245
4246This program is free software; you can redistribute it and/or modify
4247it under the terms of the GNU General Public License as published by
4248the Free Software Foundation; either version 3, or (at your option)
4249any later version.
4250
4251The text of the GPL can be found on Debian systems in
4252/usr/share/common-licenses/GPL-3 .
4253 The Debian GNU Compiler Collection Setup
4254 ========================================
4255
4256Abstract
4257--------
4258
4259Debian uses a default version of GCC for most packages; however, some
4260packages require another version. So, Debian allows several versions
4261of GCC to coexist on the same system, and selects the default version
4262by means of the gcc-defaults package, which creates symbolic links as
4263appropriate.
4264
4265Versions of GCC present in Debian Squeeze
4266-----------------------------------------
4267
4268- GCC 4.3 is the default compiler for C, C++, Objective-C, Objective-C++,
4269 Ada, Fortran 95, and Java on all architectures. This package also
4270 provides libgcc1, libgcc2 (m68k) and libgcc4 (hppa) which contain the
4271 GCC intrinsics, and libstdc++6.
4272
4273- GCC 4.1 is the default compiler for D and Pascal.
4274
4275- GCC 3.4 is provided for the C, but is not the default for any language.
4276
4277- GCC 3.3 is not provided anymore; it is used to build libstdc++5 on
4278 the amd64 and i386 architectures. It is expected that libstdc++5 is
4279 not available anymore for the release following Lenny.
4280
4281- GCC 2.95 and GCC 2.7.2.3 were removed for the release of Lenny.
4282
4283How are the default compilers selected?
4284---------------------------------------
4285
4286Starting in Debian 3.0, there is now a gcc-defaults package set. This
4287creates the actual packages for gcc, gnat, g++, gobjc, chill, gcj, gij,
4288gdc and gpc. These packages will depend on the corresponding default
4289compiler for that architecture. For Debian 4.0 for example, "gcc"
4290depends on "gcc-4.1", which means that the "gcc-4.1" package will
4291install a binary called "gcc-4.1", which is symlinked to in the "gcc"
4292package as "gcc".
4293
4294This may seem confusing, but what it allows you do to is install more
4295than one version of the GCC compiler collection at the same time,
4296making sure you are always using the one preferred for that
4297architecture. To use the other compiler, simply set CC=gcc-4.1, or
4298similar.
4299
4300The default compiler versions for Debian GNU/Linux on i386 are
4301(minor version numbers omitted):
4302
4303 cpp : cpp-4.6
4304 gcc : gcc-4.6
4305 g++ : g++-4.6
4306 gfortran : gfortran-4.6
4307 gcj : gcj-4.6
4308 gij : gij-4.6
4309 gobjc : gobjc-4.6
4310 gobjc++ : gobjc++-4.6
4311 gdc : gdc-4.6
4312
4313Documentation for the default compilers can be found in
4314
4315 /usr/share/doc/<compiler>-<package version>.
4316
4317Thanks to gcc-defaults, each architecture can choose its own preferred
4318compiler for each language, and that preference can change without
4319requiring a complete rebuild of both compiler packages for all
4320architectures.
4321
4322Practical implications
4323----------------------
4324
4325The most important practical implications are in the merging/linking
4326of object files built with different compilers; If you use the 4.1
4327C compiler, you should use the gcc-4.1 compiler driver for all your
4328work. When configuring sources, use
4329
4330 CC=gcc-4.1 ./configure <configure options> # bash
4331 setenv CC gcc-4.1; ./configure <options> # csh
4332
4333When calling make, use make CC=gcc-4.1.
4334
4335C Application Binary Interface
4336------------------------------
4337
4338Starting with Debian 4.0 (lenny), gcc-4.1 and newer compilers do
4339support the long double datatype with 128bit on the alpha, powerpc,
4340s390 and sparc architectures. Libraries and applications using this
4341datatype have to be rebuilt using the compiler versions in Lenny
4342unless these depend on libc6/libc6.1 and libstdc++6, which still have
4343compatibility with a 64bit long double datatype.
4344
4345gcc/g++/... are not handled using alternatives
4346----------------------------------------------
4347
4348The symlinks in /usr/bin (gcc, g++, ...) are not handled using the Debian
4349alternative mechanism. There are differences in the architecture specific
4350ABI on some architectures and the C++ ABI differs as well. Having the
4351symlinks managed by alternatives doesn't allow reliable builds with the
4352same major/minor version of the compiler. To use another compiler version,
4353set the appropriate environment variables as described above in the section
4354"Practical implications".
4355
4356C++ libraries
4357-------------
4358
4359To use the libstdc++ library for debugging (found in the
4360libstd++6-<GCC version>-dbg package), add /usr/lib/debug to your
4361LD_LIBRARY_PATH. For gdb to display the source you need to get the
4362correspondig gcc-X.Y source package, unpack the source and point gdb
4363to the location of the source (dir directive).
4364
4365C++ Application Binary Interface
4366--------------------------------
4367
4368Sometimes, the C++ ABI of GCC changes. It is impossible to link
4369object files that obey different ABIs into an executable. When the
4370ABI changes, Debian provides a new version of libstdc++ with a new
4371soname.
4372
4373Version 4 of the ABI was used by GCC 3.0 and 3.1; it is no longer
4374supported.
4375
4376Version 5 of the ABI is common to GCC 3.2 and 3.3; GCC 3.3
4377provides libstdc++5. It is only supported as a runtime library.
4378
4379Version 6 of the ABI is common to GCC 3.4 and later; GCC 4.3 provides
4380libstdc++6.
4381
4382Bugs
4383----
4384
4385Before submitting a bug, please read README.Bugs in this directory.
4386
4387Feedback appreciated
4388--------------------
4389
4390Feedback about this document is appreciated; preferably as a Severity:
4391wishlist bug against Package: gcc . For general discussions and
4392questions, subscribe and/or email the debian-gcc@lists.debian.org mailing
4393list.
4394
4395Maintainers of these packages
4396-----------------------------
4397
4398Matthias Klose <doko@debian.org>
4399Ray Dassen <jdassen@debian.org>
4400Philip Blundell <pb@debian.org> (arm-linux)
4401Jeff Bailey <jbailey@nisa.net> (hurd-i386)
4402Joel Baker <fenton@debian.org> (netbsd-i386)
4403Ben Collins <bcollins@debian.org> (sparc-linux)
4404Falk Hueffner <falk@debian.org> (alpha-linux)
4405Randolph Chung <tausq@debian.org> (ia64-linux, hppa-linux)
4406Thiemo Seufer <ths@networkno.de> (mips*-linux)
4407Dan Jacobowitz <dan@debian.org> (powerpc-linux)
4408Gerhard Tonn <GerhardTonn@swol.de> (s390-linux)
4409Roman Zippel <zippel@linux-m68k.org> (m68k-linux)
4410Ludovic Brenta <ludovic.brenta@insalien.org> (gnat)
4411Arthur Loiret <arthur.loiret@gmail.com> (gdc)
4412
4413===============================================================================
4414
4415 gcc-defaults is Copyright (C) 2000, 2001, 2006, 2009 Debian.
4416
4417These scripts are free software; you can redistribute it and/or modify it
4418under the terms of the GNU General Public License as published by the
4419Free Software Foundation; either version 2, or (at your option) any
4420later version.
4421
4422On Debian GNU/Linux systems, the complete text of the GNU General
4423Public License can be found in `/usr/share/common-licenses/GPL'.
4424
4425The c89 and c99 man pages are taken from netbsd:
4426
4427Copyright (c) 1999 The NetBSD Foundation, Inc.
4428All rights reserved.
4429
4430Redistribution and use in source and binary forms, with or without
4431modification, are permitted provided that the following conditions
4432are met:
44331. Redistributions of source code must retain the above copyright
4434 notice, this list of conditions and the following disclaimer.
44352. Redistributions in binary form must reproduce the above copyright
4436 notice, this list of conditions and the following disclaimer in the
4437 documentation and/or other materials provided with the distribution.
44383. All advertising materials mentioning features or use of this software
4439 must display the following acknowledgement:
4440 This product includes software developed by the NetBSD
4441 Foundation, Inc. and its contributors.
44424. Neither the name of The NetBSD Foundation nor the names of its
4443 contributors may be used to endorse or promote products derived
4444 from this software without specific prior written permission.
4445
4446THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
4447``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
4448TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
4449PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
4450BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
4451CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
4452SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
4453INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
4454CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
4455ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
4456POSSIBILITY OF SUCH DAMAGE.
4457 Format-Specification: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=166
4458Upstream-Name: crda
4459Upstream-Contact: Luis R. Rodriguez <mcgrof@gmail.com>
4460Source: git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/crda.git
4461
4462Files: *
4463Copyright: 2008, Luis R. Rodriguez <mcgrof@gmail.com>
4464 2008, Johannes Berg <johannes@sipsolutions.net>
4465 2008, Michael Green <Michael.Green@Atheros.com>
4466License: ISC
4467
4468Files: nl80211.h
4469Copyright: 2006-2008 Johannes Berg <johannes@sipsolutions.net>
4470 2008 Michael Wu <flamingice@sourmilk.net>
4471 2008 Luis Carlos Cobo <luisca@cozybit.com>
4472 2008 Michael Buesch <mb@bu3sch.de>
4473 2008 Luis R. Rodriguez <lrodriguez@atheros.com>
4474 2008 Jouni Malinen <jouni.malinen@atheros.com>
4475 2008 Colin McCabe <colin@cozybit.com>
4476License: ISC
4477
4478Files: debian/*
4479Copyright: 2009, Kel Modderman <kel@otaku42.de>
4480 2011, Stefan Lippers-Hollmann <s.l-h@gmx.de>
4481License: ISC
4482
4483License: ISC
4484 Permission to use, copy, modify, and/or distribute this software for any
4485 purpose with or without fee is hereby granted, provided that the above
4486 copyright notice and this permission notice appear in all copies.
4487 .
4488 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
4489 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
4490 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
4491 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
4492 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
4493 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
4494 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
4495 $Id: FEATURES,v 2.1 1993/12/28 08:34:43 vixie Exp $
4496
4497Features of Vixie's cron relative to BSD 4.[23] and SysV crons:
4498
4499-- Environment variables can be set in each crontab. SHELL, USER,
4500 LOGNAME, and HOME are set from the user's passwd entry; all except
4501 USER can be changed in the crontab. PATH is especially useful to
4502 set there. TZ can be set, but cron ignores it other than passing
4503 it on through to the commands it runs. Format is
4504
4505 variable=value
4506
4507 Blanks surrounding the '=' will be eaten; other blanks in value are
4508 okay. Leading or trailing blanks can be preserved by quoting, single
4509 or double quotes are okay, just so they match.
4510
4511 PATH=.:/bin:/usr/bin
4512 SHELL=/bin/sh
4513 FOOBAR = this is a long blanky example
4514
4515 Above, FOOBAR would get "this is a long blanky example" as its value.
4516
4517 SHELL and HOME will be used when it's time to run a command; if
4518 you don't set them, HOME defaults to your /etc/passwd entry
4519 and SHELL defaults to /bin/sh.
4520
4521 MAILTO, if set to the login name of a user on your system, will be the
4522 person that cron mails the output of commands in that crontab. This is
4523 useful if you decide on BINMAIL when configuring cron.h, since binmail
4524 doesn't know anything about aliasing.
4525
4526-- Weekdays can be specified by name. Case is not significant, but only
4527 the first three letters should be specified.
4528
4529-- Months can likewise be specified by name. Three letters only.
4530
4531-- Ranges and lists can be mixed. Standard crons won't allow '1,3-5'.
4532
4533-- Ranges can specify 'step' values. '10-16/2' is like '10,12,14,16'.
4534
4535-- Sunday is both day 0 and day 7 -- apparently BSD and ATT disagree
4536 about this.
4537
4538-- Each user gets their own crontab file. This is a win over BSD 4.2,
4539 where only root has one, and over BSD 4.3, where they made the crontab
4540 format incompatible and although the commands can be run by non-root
4541 uid's, root is still the only one who can edit the crontab file. This
4542 feature mimics the SysV cron.
4543
4544-- The 'crontab' command is loosely compatible with SysV, but has more
4545 options which just generally make more sense. Running crontab with
4546 no arguments will print a cute little summary of the command syntax.
4547
4548-- Comments and blank lines are allowed in the crontab file. Comments
4549 must be on a line by themselves; leading whitespace is ignored, and
4550 a '#' introduces the comment.
4551
4552-- (big win) If the `crontab' command changes anything in any crontab,
4553 the 'cron' daemon will reload all the tables before running the
4554 next iteration. In some crons, you have to kill and restart the
4555 daemon whenever you change a crontab. In other crons, the crontab
4556 file is reread and reparsed every minute even if it didn't change.
4557
4558-- In order to support the automatic reload, the crontab files are not
4559 readable or writable except by 'crontab' or 'cron'. This is not a
4560 problem, since 'crontab' will let you do pretty much whatever you
4561 want to your own crontab, or if you are root, to anybody's crontab.
4562
4563-- If any output is generated by a command (on stdout OR stderr), it will
4564 be mailed to the owner of the crontab that contained the command (or
4565 MAILTO, see discussion of environment variables, above). The headers
4566 of the mail message will include the command that was run, and a
4567 complete list of the environment that was passed to it, which will
4568 contain (at least) the USER (LOGNAME on SysV), HOME, and SHELL.
4569
4570-- the dom/dow situation is odd. '* * 1,15 * Sun' will run on the
4571 first and fifteenth AND every Sunday; '* * * * Sun' will run *only*
4572 on Sundays; '* * 1,15 * *' will run *only* the 1st and 15th. this
4573 is why we keep 'e->dow_star' and 'e->dom_star'. I didn't think up
4574 this behaviour; it's how cron has always worked but the documentation
4575 hasn't been very clear. I have been told that some AT&T crons do not
4576 act this way and do the more reasonable thing, which is (IMHO) to "or"
4577 the various field-matches together. In that sense this cron may not
4578 be completely similar to some AT&T crons.
4579 #/* Copyright 1988,1990,1993 by Paul Vixie
4580# * All rights reserved
4581# *
4582# * Distribute freely, except: don't remove my name from the source or
4583# * documentation (don't take credit for my work), mark your changes (don't
4584# * get me blamed for your possible bugs), don't alter or remove this
4585# * notice. May be sold if buildable source is provided to buyer. No
4586# * warrantee of any kind, express or implied, is included with this
4587# * software; use at your own risk, responsibility for damages (if any) to
4588# * anyone resulting from the use of this software rests entirely with the
4589# * user.
4590# *
4591# * Send bug reports, bug fixes, enhancements, requests, flames, etc., and
4592# * I'll try to keep a version up to date. I can be reached as follows:
4593# * Paul Vixie <paul@vix.com> uunet!decwrl!vixie!paul
4594# */
4595
4596Vixie Cron V3.0
4597December 27, 1993
4598[V2.2 was some time in 1992]
4599[V2.1 was May 29, 1991]
4600[V2.0 was July 5, 1990]
4601[V2.0-beta was December 9, 1988]
4602[V1.0 was May 6, 1987]
4603Paul Vixie
4604
4605[Note from Debian cron maintainer: This is the original README from
4606the the vixie-cron package. The location of many cron files has been
4607changed in order to comply with Debian policy and common sense -- look
4608in the cron(8), crontab(1) and crontab(5) man pages for more info, as
4609well as the README.Debian file in this directory.]
4610
4611This is a version of 'cron' that is known to run on BSD 4.[23] systems. It
4612is functionally based on the SysV cron, which means that each user can have
4613their own crontab file (all crontab files are stored in a read-protected
4614directory, usually /var/cron/tabs). No direct support is provided for
4615'at'; you can continue to run 'atrun' from the crontab as you have been
4616doing. If you don't have atrun (i.e., System V) you are in trouble.
4617
4618A messages is logged each time a command is executed; also, the files
4619"allow" and "deny" in /var/cron can be used to control access to the
4620"crontab" command (which installs crontabs). It hasn't been tested on
4621SysV, although some effort has gone into making the port an easy one.
4622
4623This is more or less the copyright that USENET contributed software usually
4624has. Since ATT couldn't use this version if they had to freely distribute
4625source, and since I'd love to see them use it, I'll offer some rediculously
4626low license fee just to have them take it. In the unlikely event that they
4627do this, I will continue to support and distribute the pseudo-PD version, so
4628please, don't flame me for wanting my work to see a wider distribution.
4629
4630To use this: Sorry, folks, there is no cutesy 'Configure' script. You'll
4631have to go edit a couple of files... So, here's the checklist:
4632
4633 Read all the FEATURES, INSTALL, and CONVERSION files
4634 Edit config.h
4635 Edit Makefile
4636 (both of these files have instructions inside; note that
4637 some things in config.h are definable in Makefile and are
4638 therefore surrounded by #ifndef...#endif)
4639 'make'
4640 'su' and 'make install'
4641 (you may have to install the man pages by hand)
4642 kill your existing cron process
4643 (actually you can run your existing cron if you want, but why?)
4644 build new crontabs using /usr/lib/{crontab,crontab.local}
4645 (either put them all in "root"'s crontab, or divide it up
4646 and rip out all the 'su' commands, collapse the lengthy
4647 lists into ranges with steps -- basically, this step is
4648 as much work as you want to make it)
4649 start up the new cron
4650 (must be done as root)
4651 watch it. test it with 'crontab -r' and watch the daemon track your
4652 changes.
4653 if you like it, change your /etc/{rc,rc.local} to use it instead of
4654 the old one.
4655
4656$Id: README,v 2.3 1993/12/28 08:34:43 vixie Exp $
4657 cron for DEBIAN
4658----------------------
4659
4660This is the Debian GNU/Linux prepackaged and heavily modified version
4661of Paul Vixie's cron subsystem.
4662
4663Debian's cron development is being done on Alioth:
4664http://anonscm.debian.org/gitweb/?p=pkg-cron/cron.git
4665
4666This package was put together by Ian Jackson <iwj10@cus.cam.ac.uk>,
4667from the standard sources to 3.0pl1, as posted to comp.sources.unix.
4668Ian obtained them from
4669src.doc.ic.ac.uk:/usenet/comp.sources.unix/volume27/vixie-cron.
4670
4671Debian's cron version introduces a significant number of changes:
4672 * Support for /etc/cron.d (drop-in dir for package crontabs)
4673 * Debian-specific file locations and commands
4674 * PAM support
4675 * SELinux support
4676 * auditlog support
4677 * DST and other time-related changes/fixes
4678 * SGID crontab(1) instead of SUID root
4679 * numerous other smaller features and fixes.
4680
4681Users are STRONGLY advised to carefully check the man pages crontab(1)
4682and crontab(5). System administrators should also read cron(8).
4683
4684File locations that are different than that indicated in
4685the cron distributions README:
4686
4687user crontabs: /var/spool/cron/crontabs/*
4688log file: Check your syslog settings, facility "cron"
4689allow file: /etc/cron.allow
4690deny file: /etc/cron.deny
4691
4692This package is now maintained by Javier Fernández-Sanguino Peña
4693<jfs@computer.org> and Christian Kastner <debian@kvr.at>.
4694
4695Historical note: The old subversion repository from before the
4696migration to git can be found here:
4697 http://svn.debian.org/wsvn/pkg-cron
4698 To ease coordination with anacron, the invocation of the run-parts for
4699the /etc/cron.daily, /etc/cron.weekly, and /etc/cron.monthly directories
4700was changed to the form
4701
4702 test -e /usr/sbin/anacron || run-parts --report /etc/cron.daily
4703
4704What this means is that if anacron has been installed, it will
4705be responsible for running those scripts. This is the standard
4706configuration of anacron: if you simply install both cron and anacron,
4707things will work as expected.
4708
4709However, if you have modified your anacron configuration
4710(/etc/anacrontab), you may need to re-adjust it in order to accommodate
4711this change.
4712
4713 Format: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=173
4714Upstream-Name: vixie-cron
4715Ustream-Contact: Paul Vixie <paul@vix.com>
4716Source:
4717 The original source for this package could be obtained from
4718 ftp://ftp.vix.com/pub/vixie/cron-3.0, although that link appears to have gone
4719 down.
4720
4721Files: *
4722Copyright: 1988, 1990, 1993, 1994, Paul Vixie <paul@vix.com>
4723 1994, Ian Jackson <ian@davenant.greenend.org.uk>
4724 1996-2005, Steve Greenland <stevegr@debian.org>
4725 2005-2006, 2008-2010, Javier Fernández-Sanguino Peña <jfs@debian.org>
4726 2010-2011, Christian Kastner <debian@kvr.at>
4727 Numerous contributions via the Debian BTS copyright their respective authors
4728License: Paul Vixie's license
4729
4730Files: database.c
4731Copyright: 1988, 1990, 1993, 1994 Paul Vixie <paul@vix.com>
4732 1996-2005, Steve Greenland <stevegr@debian.org>
4733 2003, Clint Adams <schizo@debian.org>
4734 2010-2011, Christian Kastner <debian@kvr.at>
4735 2011, Red Hat, Inc.
4736License: Paul Vixie's license and GPL-2+ and ISC
4737
4738Files: debian/examples/cron-stats.pl
4739Copyright: 2006, Javier Fernández-Sanguino Peña <jfs@debian.org>
4740License: GPL-2+
4741
4742Files: debian/examples/cron-tasks-review.sh
4743Copyright: 2011, Javier Fernández-Sanguino Peña <jfs@debian.org>
4744License: GPL-2+
4745
4746Files: debian/examples/crontab2english.pl
4747Copyright: 2001, Sean M. Burke
4748License: Artistic
4749
4750License: Paul Vixie's license
4751 Distribute freely, except: don't remove my name from the source or
4752 documentation (don't take credit for my work), mark your changes (don't
4753 get me blamed for your possible bugs), don't alter or remove this
4754 notice. May be sold if buildable source is provided to buyer. No
4755 warranty of any kind, express or implied, is included with this
4756 software; use at your own risk, responsibility for damages (if any) to
4757 anyone resulting from the use of this software rests entirely with the
4758 user.
4759
4760License: GPL-2+
4761 This package is free software; you can redistribute it and/or modify
4762 it under the terms of the GNU General Public License as published by
4763 the Free Software Foundation; either version 2 of the License, or
4764 (at your option) any later version.
4765 .
4766 This package is distributed in the hope that it will be useful,
4767 but WITHOUT ANY WARRANTY; without even the implied warranty of
4768 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4769 GNU General Public License for more details.
4770 .
4771 You should have received a copy of the GNU General Public License
4772 along with this program. If not, see <http://www.gnu.org/licenses/>
4773 .
4774 On Debian systems, the complete text of the GNU General
4775 Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
4776
4777License: Artistic
4778 This program is free software; you can redistribute it and/or modify it
4779 under the terms of the "Artistic License" which comes with Debian.
4780 .
4781 THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
4782 WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES
4783 OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
4784 .
4785 On Debian systems, the complete text of the Artistic License
4786 can be found in "/usr/share/common-licenses/Artistic".
4787
4788License: ISC
4789 Permission to use, copy, modify, and distribute this software for any
4790 purpose with or without fee is hereby granted, provided that the above
4791 copyright notice and this permission notice appear in all copies.
4792 .
4793 THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
4794 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
4795 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR
4796 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
4797 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
4798 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
4799 OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
4800 9,136 DEBUG: Could not instantiate Handler subclass __builtin__.DvbUsbFirmwareHandler from name DvbUsbFirmwareHandler
4801Traceback (most recent call last):
4802 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4803 desc = inst.name()
4804 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4805 self._package_defaults()
4806 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4807 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4808 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4809 raise ValueError('package %s does not exist' % package)
4810ValueError: package linux-firmware-nonfree does not exist
48112013-04-09 19:57:29,153 DEBUG: loading custom handler /usr/share/jockey/handlers/pvr-omap4.py
48122013-04-09 19:57:29,215 WARNING: modinfo for module omapdrm_pvr failed: ERROR: modinfo: could not find module omapdrm_pvr
4813
48142013-04-09 19:57:29,265 DEBUG: Instantiated Handler subclass __builtin__.PVROmap4Driver from name PVROmap4Driver
48152013-04-09 19:57:31,063 DEBUG: XorgDriverHandler(omapdrm_pvr, pvr-omap4, None): Disabling as package is not compatible with Q-LTS X.org
48162013-04-09 19:57:31,064 DEBUG: PowerVR SGX proprietary graphics driver for OMAP 4 not available
48172013-04-09 19:57:31,065 DEBUG: loading custom handler /usr/share/jockey/handlers/cdv.py
48182013-04-09 19:57:31,124 WARNING: modinfo for module cedarview_gfx failed: ERROR: modinfo: could not find module cedarview_gfx
4819
48202013-04-09 19:57:31,125 DEBUG: Instantiated Handler subclass __builtin__.CdvDriver from name CdvDriver
48212013-04-09 19:57:31,126 DEBUG: cdv.available: falling back to default
48222013-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
48232013-04-09 19:57:32,670 DEBUG: Intel Cedarview graphics driver not available
48242013-04-09 19:57:32,670 DEBUG: loading custom handler /usr/share/jockey/handlers/madwifi.py
48252013-04-09 19:57:32,712 WARNING: modinfo for module ath_pci failed: ERROR: modinfo: could not find module ath_pci
4826
48272013-04-09 19:57:32,714 DEBUG: Instantiated Handler subclass __builtin__.MadwifiHandler from name MadwifiHandler
48282013-04-09 19:57:32,714 DEBUG: Alternate Atheros "madwifi" driver availability undetermined, adding to pool
48292013-04-09 19:57:32,715 DEBUG: loading custom handler /usr/share/jockey/handlers/nvidia.py
48302013-04-09 19:57:32,792 WARNING: modinfo for module nvidia_96 failed: ERROR: modinfo: could not find module nvidia_96
4831
48322013-04-09 19:57:32,828 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver96 from name NvidiaDriver96
48332013-04-09 19:57:32,837 DEBUG: nvidia.available: falling back to default
48342013-04-09 19:57:34,435 DEBUG: XorgDriverHandler(nvidia_96, nvidia-96, None): Disabling as package is not compatible with Q-LTS X.org
48352013-04-09 19:57:34,436 DEBUG: NVIDIA accelerated graphics driver not available
48362013-04-09 19:57:34,470 WARNING: modinfo for module nvidia_current failed: ERROR: modinfo: could not find module nvidia_current
4837
48382013-04-09 19:57:34,520 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriverCurrent from name NvidiaDriverCurrent
48392013-04-09 19:57:34,522 DEBUG: nvidia.available: falling back to default
48402013-04-09 19:57:36,224 DEBUG: XorgDriverHandler(nvidia_current, nvidia-current, None): Disabling as package is not compatible with Q-LTS X.org
48412013-04-09 19:57:36,226 DEBUG: NVIDIA accelerated graphics driver not available
48422013-04-09 19:57:36,260 WARNING: modinfo for module nvidia_current_updates failed: ERROR: modinfo: could not find module nvidia_current_updates
4843
48442013-04-09 19:57:36,296 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriverCurrentUpdates from name NvidiaDriverCurrentUpdates
48452013-04-09 19:57:36,303 DEBUG: nvidia.available: falling back to default
48462013-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
48472013-04-09 19:57:37,878 DEBUG: NVIDIA accelerated graphics driver (post-release updates) not available
48482013-04-09 19:57:37,915 WARNING: modinfo for module nvidia_96_updates failed: ERROR: modinfo: could not find module nvidia_96_updates
4849
48502013-04-09 19:57:37,952 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver96Updates from name NvidiaDriver96Updates
48512013-04-09 19:57:37,954 DEBUG: nvidia.available: falling back to default
48522013-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
48532013-04-09 19:57:39,617 DEBUG: NVIDIA accelerated graphics driver (post-release updates) not available
48542013-04-09 19:57:39,671 WARNING: modinfo for module nvidia_173_updates failed: ERROR: modinfo: could not find module nvidia_173_updates
4855
48562013-04-09 19:57:39,724 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver173Updates from name NvidiaDriver173Updates
48572013-04-09 19:57:39,733 DEBUG: nvidia.available: falling back to default
48582013-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
48592013-04-09 19:57:41,466 DEBUG: NVIDIA accelerated graphics driver (post-release updates) not available
48602013-04-09 19:57:41,507 WARNING: modinfo for module nvidia_173 failed: ERROR: modinfo: could not find module nvidia_173
4861
48622013-04-09 19:57:41,569 DEBUG: Instantiated Handler subclass __builtin__.NvidiaDriver173 from name NvidiaDriver173
48632013-04-09 19:57:41,584 DEBUG: nvidia.available: falling back to default
48642013-04-09 19:57:43,666 DEBUG: XorgDriverHandler(nvidia_173, nvidia-173, None): Disabling as package is not compatible with Q-LTS X.org
48652013-04-09 19:57:43,667 DEBUG: NVIDIA accelerated graphics driver not available
48662013-04-09 19:57:43,722 WARNING: modinfo for module nvidia_experimental_310 failed: ERROR: modinfo: could not find module nvidia_experimental_310
4867
48682013-04-09 19:57:43,968 DEBUG: Could not instantiate Handler subclass __builtin__.NvidiaDriverExperimental310 from name NvidiaDriverExperimental310
4869Traceback (most recent call last):
4870 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4871 desc = inst.name()
4872 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4873 self._package_defaults()
4874 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4875 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4876 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4877 raise ValueError('package %s does not exist' % package)
4878ValueError: package nvidia-experimental-310 does not exist
48792013-04-09 19:57:44,020 WARNING: modinfo for module nvidia_experimental_304 failed: ERROR: modinfo: could not find module nvidia_experimental_304
4880
48812013-04-09 19:57:44,200 DEBUG: Could not instantiate Handler subclass __builtin__.NvidiaDriverExperimental304 from name NvidiaDriverExperimental304
4882Traceback (most recent call last):
4883 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4884 desc = inst.name()
4885 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4886 self._package_defaults()
4887 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4888 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4889 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4890 raise ValueError('package %s does not exist' % package)
4891ValueError: package nvidia-experimental-304 does not exist
48922013-04-09 19:57:44,201 DEBUG: loading custom handler /usr/share/jockey/handlers/sl_modem.py
48932013-04-09 19:57:44,360 DEBUG: Instantiated Handler subclass __builtin__.SlModem from name SlModem
48942013-04-09 19:57:44,767 DEBUG: Software modem not available
48952013-04-09 19:57:44,768 DEBUG: loading custom handler /usr/share/jockey/handlers/fglrx.py
48962013-04-09 19:57:44,824 WARNING: modinfo for module fglrx_updates failed: ERROR: modinfo: could not find module fglrx_updates
4897
48982013-04-09 19:57:44,865 DEBUG: Instantiated Handler subclass __builtin__.FglrxDriverUpdate from name FglrxDriverUpdate
48992013-04-09 19:57:44,866 DEBUG: fglrx.available: falling back to default
49002013-04-09 19:57:46,399 DEBUG: XorgDriverHandler(fglrx_updates, fglrx-updates, None): Disabling as package is not compatible with Q-LTS X.org
49012013-04-09 19:57:46,400 DEBUG: ATI/AMD proprietary FGLRX graphics driver (post-release updates) not available
49022013-04-09 19:57:46,441 WARNING: modinfo for module fglrx_experimental_9 failed: ERROR: modinfo: could not find module fglrx_experimental_9
4903
49042013-04-09 19:57:46,634 DEBUG: Could not instantiate Handler subclass __builtin__.FglrxDriverExperimental9 from name FglrxDriverExperimental9
4905Traceback (most recent call last):
4906 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
4907 desc = inst.name()
4908 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
4909 self._package_defaults()
4910 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
4911 (distro_name, distro_desc) = OSLib.inst.package_description(self.package)
4912 File "/usr/lib/python2.7/dist-packages/jockey/oslib.py", line 216, in package_description
4913 raise ValueError('package %s does not exist' % package)
4914ValueError: package fglrx-experimental-9 does not exist
49152013-04-09 19:57:46,679 WARNING: modinfo for module fglrx failed: ERROR: modinfo: could not find module fglrx
4916
49172013-04-09 19:57:46,720 DEBUG: Instantiated Handler subclass __builtin__.FglrxDriver from name FglrxDriver
49182013-04-09 19:57:46,721 DEBUG: fglrx.available: falling back to default
49192013-04-09 19:57:48,530 DEBUG: XorgDriverHandler(fglrx, fglrx, None): Disabling as package is not compatible with Q-LTS X.org
49202013-04-09 19:57:48,531 DEBUG: ATI/AMD proprietary FGLRX graphics driver not available
49212013-04-09 19:57:48,532 DEBUG: loading custom handler /usr/share/jockey/handlers/vmware-client.py
49222013-04-09 19:57:48,607 WARNING: modinfo for module vmxnet failed: ERROR: modinfo: could not find module vmxnet
4923
49242013-04-09 19:57:48,612 DEBUG: Instantiated Handler subclass __builtin__.VmwareClientHandler from name VmwareClientHandler
49252013-04-09 19:57:48,774 DEBUG: VMWare Client Tools not available
49262013-04-09 19:57:48,778 DEBUG: all custom handlers loaded
49272013-04-09 19:57:48,779 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007110sv00000000sd00000000bc06sc80i00')
49282013-04-09 19:57:53,682 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'input:b0019v0000p0005e0000-e0,5,kramlsfw0,')
49292013-04-09 19:57:53,764 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
49302013-04-09 19:57:54,630 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
49312013-04-09 19:57:54,635 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0800:')
49322013-04-09 19:57:54,636 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007113sv00000000sd00000000bc06sc80i00')
49332013-04-09 19:57:54,684 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'i2c_piix4'}
49342013-04-09 19:57:54,685 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'i2c_piix4', 'jockey_handler': 'KernelModuleHandler'}
49352013-04-09 19:57:54,685 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v0000104Cd0000AC51sv00001028sd000000B1bc06sc07i00')
49362013-04-09 19:57:54,843 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket'}
49372013-04-09 19:57:54,844 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket', 'jockey_handler': 'KernelModuleHandler'}
49382013-04-09 19:57:54,844 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket'}
49392013-04-09 19:57:54,845 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'yenta_socket', 'jockey_handler': 'KernelModuleHandler'}
49402013-04-09 19:57:54,845 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:dell-laptop')
49412013-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')
49422013-04-09 19:57:54,854 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
49432013-04-09 19:57:54,855 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
49442013-04-09 19:57:54,859 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
49452013-04-09 19:57:54,860 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
49462013-04-09 19:57:54,860 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:eisa')
49472013-04-09 19:57:54,865 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'usb:v1D6Bp0001d0305dc09dsc00dp00ic09isc00ip00')
49482013-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')
49492013-04-09 19:57:55,030 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
49502013-04-09 19:57:55,031 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
49512013-04-09 19:57:55,043 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
49522013-04-09 19:57:55,044 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
49532013-04-09 19:57:55,044 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:regulatory')
49542013-04-09 19:57:55,056 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:LNXSYSTM:')
49552013-04-09 19:57:55,056 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:pcspkr')
49562013-04-09 19:57:55,065 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'pcspkr'}
49572013-04-09 19:57:55,066 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'pcspkr', 'jockey_handler': 'KernelModuleHandler'}
49582013-04-09 19:57:55,066 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'snd_pcsp'}
49592013-04-09 19:57:55,070 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'snd_pcsp', 'jockey_handler': 'KernelModuleHandler'}
49602013-04-09 19:57:55,070 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:dock')
49612013-04-09 19:57:55,078 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007111sv00000000sd00000000bc01sc01i80')
49622013-04-09 19:57:55,124 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0C04:')
49632013-04-09 19:57:55,125 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0401:')
49642013-04-09 19:57:55,126 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v000010ECd00008180sv00001737sd00000019bc02sc00i00')
49652013-04-09 19:57:55,221 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'rtl8180'}
49662013-04-09 19:57:55,222 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'rtl8180', 'jockey_handler': 'KernelModuleHandler'}
49672013-04-09 19:57:55,222 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0501:')
49682013-04-09 19:57:55,223 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0F13:')
49692013-04-09 19:57:55,227 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0B00:')
49702013-04-09 19:57:55,228 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00001002d00004C46sv00001028sd000000B1bc03sc00i00')
49712013-04-09 19:57:59,415 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'aty128fb'}
49722013-04-09 19:57:59,420 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'aty128fb', 'jockey_handler': 'KernelModuleHandler'}
49732013-04-09 19:57:59,420 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0100:')
49742013-04-09 19:57:59,421 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'serio:ty05pr00id00ex00')
49752013-04-09 19:57:59,515 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'psmouse'}
49762013-04-09 19:57:59,524 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'psmouse', 'jockey_handler': 'KernelModuleHandler'}
49772013-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')
49782013-04-09 19:57:59,525 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
49792013-04-09 19:57:59,526 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
49802013-04-09 19:57:59,526 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
49812013-04-09 19:57:59,527 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
49822013-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')
49832013-04-09 19:57:59,535 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
49842013-04-09 19:57:59,536 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
49852013-04-09 19:57:59,536 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'joydev'}
49862013-04-09 19:57:59,537 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'joydev', 'jockey_handler': 'KernelModuleHandler'}
49872013-04-09 19:57:59,537 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'joydev'}
49882013-04-09 19:57:59,538 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'joydev', 'jockey_handler': 'KernelModuleHandler'}
49892013-04-09 19:57:59,538 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
49902013-04-09 19:57:59,543 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
49912013-04-09 19:57:59,544 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0000:')
49922013-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:')
49932013-04-09 19:57:59,721 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v0000125Dd00001998sv00001028sd000000B1bc04sc01i00')
49942013-04-09 19:57:59,767 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'snd_maestro3'}
49952013-04-09 19:57:59,767 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'snd_maestro3', 'jockey_handler': 'KernelModuleHandler'}
49962013-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')
49972013-04-09 19:57:59,769 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
49982013-04-09 19:57:59,769 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
49992013-04-09 19:57:59,770 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
50002013-04-09 19:57:59,770 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
50012013-04-09 19:57:59,771 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0C01:')
50022013-04-09 19:57:59,776 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007112sv00000000sd00000000bc0Csc03i00')
50032013-04-09 19:57:59,831 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00004220sv0000103Csd000012F5bc02sc80i00')
50042013-04-09 19:57:59,890 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'ipw2200'}
50052013-04-09 19:57:59,895 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'ipw2200', 'jockey_handler': 'KernelModuleHandler'}
50062013-04-09 19:57:59,895 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0200:')
50072013-04-09 19:57:59,896 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:Fixed MDIO bus')
50082013-04-09 19:57:59,903 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'pci:v00008086d00007191sv00000000sd00000000bc06sc04i00')
50092013-04-09 19:57:59,950 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'shpchp'}
50102013-04-09 19:57:59,955 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'shpchp', 'jockey_handler': 'KernelModuleHandler'}
50112013-04-09 19:57:59,956 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0700:')
50122013-04-09 19:57:59,956 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:dcdbas')
50132013-04-09 19:57:59,963 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'platform:microcode')
50142013-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')
50152013-04-09 19:58:00,064 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'microcode'}
50162013-04-09 19:58:00,065 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'microcode', 'jockey_handler': 'KernelModuleHandler'}
50172013-04-09 19:58:00,066 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'serio:ty01pr00id00ex00')
50182013-04-09 19:58:00,072 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'serio_raw'}
50192013-04-09 19:58:00,073 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'serio_raw', 'jockey_handler': 'KernelModuleHandler'}
50202013-04-09 19:58:00,073 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'psmouse'}
50212013-04-09 19:58:00,074 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'psmouse', 'jockey_handler': 'KernelModuleHandler'}
50222013-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')
50232013-04-09 19:58:00,079 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'evbug'}
50242013-04-09 19:58:00,080 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'evbug', 'jockey_handler': 'KernelModuleHandler'}
50252013-04-09 19:58:00,080 DEBUG: searching handler for driver ID {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid'}
50262013-04-09 19:58:00,081 DEBUG: no corresponding handler available for {'driver_type': 'kernel_module', 'kernel_module': 'mac_hid', 'jockey_handler': 'KernelModuleHandler'}
50272013-04-09 19:58:00,081 DEBUG: querying driver db <jockey.detection.LocalKernelModulesDriverDB instance at 0x995eb6c> about HardwareID('modalias', 'acpi:PNP0303:')
50282013-04-09 19:58:00,082 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007110sv00000000sd00000000bc06sc80i00')
50292013-04-09 19:58:00,082 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'input:b0019v0000p0005e0000-e0,5,kramlsfw0,')
50302013-04-09 19:58:00,083 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0800:')
50312013-04-09 19:58:00,087 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007113sv00000000sd00000000bc06sc80i00')
50322013-04-09 19:58:00,088 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v0000104Cd0000AC51sv00001028sd000000B1bc06sc07i00')
50332013-04-09 19:58:00,088 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:dell-laptop')
50342013-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')
50352013-04-09 19:58:00,089 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:eisa')
50362013-04-09 19:58:00,090 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'usb:v1D6Bp0001d0305dc09dsc00dp00ic09isc00ip00')
50372013-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')
50382013-04-09 19:58:00,090 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:regulatory')
50392013-04-09 19:58:00,091 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:LNXSYSTM:')
50402013-04-09 19:58:00,096 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:pcspkr')
50412013-04-09 19:58:00,096 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:dock')
50422013-04-09 19:58:00,096 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007111sv00000000sd00000000bc01sc01i80')
50432013-04-09 19:58:00,097 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0C04:')
50442013-04-09 19:58:00,097 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0401:')
50452013-04-09 19:58:00,098 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v000010ECd00008180sv00001737sd00000019bc02sc00i00')
50462013-04-09 19:58:00,098 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0501:')
50472013-04-09 19:58:00,098 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0F13:')
50482013-04-09 19:58:00,103 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0B00:')
50492013-04-09 19:58:00,104 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00001002d00004C46sv00001028sd000000B1bc03sc00i00')
50502013-04-09 19:58:00,104 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0100:')
50512013-04-09 19:58:00,104 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'serio:ty05pr00id00ex00')
50522013-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')
50532013-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')
50542013-04-09 19:58:00,106 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0000:')
50552013-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:')
50562013-04-09 19:58:00,106 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v0000125Dd00001998sv00001028sd000000B1bc04sc01i00')
50572013-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')
50582013-04-09 19:58:00,117 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0C01:')
50592013-04-09 19:58:00,118 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007112sv00000000sd00000000bc0Csc03i00')
50602013-04-09 19:58:00,118 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00004220sv0000103Csd000012F5bc02sc80i00')
50612013-04-09 19:58:00,119 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0200:')
50622013-04-09 19:58:00,123 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:Fixed MDIO bus')
50632013-04-09 19:58:00,124 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'pci:v00008086d00007191sv00000000sd00000000bc06sc04i00')
50642013-04-09 19:58:00,124 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0700:')
50652013-04-09 19:58:00,124 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:dcdbas')
50662013-04-09 19:58:00,125 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'platform:microcode')
50672013-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')
50682013-04-09 19:58:00,126 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'serio:ty01pr00id00ex00')
50692013-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')
50702013-04-09 19:58:00,126 DEBUG: querying driver db <jockey.detection.OpenPrintingDriverDB instance at 0x99666ec> about HardwareID('modalias', 'acpi:PNP0303:')
50712013-04-09 19:58:24,976 DEBUG: Shutting down
50722013-04-09 19:58:35,331 DEBUG: updating <jockey.detection.LocalKernelModulesDriverDB instance at 0x910bb6c>
50732013-04-09 19:58:42,531 DEBUG: reading modalias file /lib/modules/3.5.0-23-generic/modules.alias
50742013-04-09 19:58:43,513 DEBUG: reading modalias file /usr/share/jockey/modaliases/b43
50752013-04-09 19:58:43,521 DEBUG: reading modalias file /usr/share/jockey/modaliases/disable-upstream-nvidia
50762013-04-09 19:58:44,179 DEBUG: loading custom handler /usr/share/jockey/handlers/broadcom_wl.py
50772013-04-09 19:58:44,288 WARNING: modinfo for module wl failed: ERROR: modinfo: could not find module wl
5078
50792013-04-09 19:58:44,476 DEBUG: Instantiated Handler subclass __builtin__.BroadcomWLHandler from name BroadcomWLHandler
50802013-04-09 19:58:44,478 DEBUG: Broadcom STA wireless driver availability undetermined, adding to pool
50812013-04-09 19:58:44,479 DEBUG: loading custom handler /usr/share/jockey/handlers/dvb_usb_firmware.py
50822013-04-09 19:58:44,730 DEBUG: Could not instantiate Handler subclass __builtin__.DvbUsbFirmwareHandler from name DvbUsbFirmwareHandler
5083Traceback (most recent call last):
5084 File "/usr/lib/python2.7/dist-packages/jockey/detection.py", line 972, in get_handlers
5085 desc = inst.name()
5086 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 108, in name
5087 self._package_defaults()
5088 File "/usr/lib/python2.7/dist-packages/jockey/handlers.py", line 93, in _package_defaults
5089 (distro_name, distro_desc) = Ousing GnuPG keys for LUKS dm-crypt devices in Debian
5090----------------------------------------------------
5091
5092The Debian cryptsetup package provides the keyscript decrypt_gnupg for setups
5093with a GnuPG encrypted LUKS keyfile.
5094
5095The following example assumes that you store the encrypted keyfile in
5096/etc/keys/cryptkey.gpg. LUKS device is /dev/<luks_device>.
5097
5098First, you'll have to create the encrypted keyfile:
5099
5100# dd if=/dev/random bs=1 count=256 | gpg --no-options --no-random-seed-file \
5101 --no-default-keyring --keyring /dev/null --secret-keyring /dev/null \
5102 --trustdb-name /dev/null --symmetric --output /etc/keys/cryptkey.gpg
5103
5104Next the LUKS device needs to be formated with the key. For that, the
5105decrypt_gnupg keyscript can be used:
5106
5107# /lib/cryptsetup/scripts/decrypt_gnupg /etc/keys/crytpkey.gpg | \
5108 cryptsetup --key-file=- luksFormat /dev/<luks_device>
5109
5110In order to unlock the encrypted LUKS device automatically during boot process,
5111add the following to /etc/crypttab:
5112
5113cdev1 /dev/<luks_device> /etc/keys/cryptkey.gpg luks,keyscript=decrypt_gnupg
5114
5115encrypted root filesystem with GnuPG key
5116----------------------------------------
5117
5118In case that you want to encrypt the root filesystem with a GnuPG encrypted key,
5119the provided initramfs hooks should do all additionally required work for you
5120when the initramfs is created or updated.
5121
5122Be warned though, that the GnuPG key for encrypted root is copied to the
5123initramfs by the initramfs cryptgnupg hook. If you don't want your GnuPG key
5124inside the initramfs, you should take a look at the initramfs cryptgnupg hook,
5125which is located at /usr/share/initramfs-tools/hooks/cryptgnupg.
5126 decrypt_keyctl
5127==============
5128
5129A passphrase caching script to be used in /etc/crypttab on Debian and Ubuntu.
5130When there are multiple cryptsetup (either plain or LUKS) volumes with the same
5131passphrase, it is an unnecessary task to input the passphrase more than once.
5132
5133Just add this script as keyscript to your /etc/crypttab and it will cache the
5134passphrase of all cryptab entries with the same identifier.
5135
5136Either copy decrypt_keyctl into the default search path for keyscripts from
5137cryptsetup /lib/cryptdisks/scripts/. So you can just write keyscript=decrypt_keyctl
5138in /etc/crypttab, or use a random path of your choice and give the full path
5139e.g keyscript=/sbin/decrypt_keyctl.
5140
5141
5142Requirements
5143------------
5144
5145 - Debian cryptsetup package with /etc/crypttab handling and keyscript option
5146 - Tested with Debian Lenny, Squeeze and Sid
5147 - Installed and working keyutils package (keyctl)
5148 - Needs CONFIG_KEYS=y in your kernel configuration
5149
5150
5151What For?
5152---------
5153
5154The current state for dm-crypt in Linux is that it is single threaded, thus
5155every dm-crypt mapping only uses a single core for crypto operations.
5156To use the full power of your many-core processor it is thus necessary to split
5157the dm-crypt device. For Linux software raid arrays the easiest segmentation is to
5158just put the dm-crypt layer below the software raid layer.
5159
5160But with a 5 disk raid5 it is a rather daunting task to input the passphrase five
5161times.
5162This is what this keyscripts solve for you.
5163
5164
5165Usage
5166-----
5167
5168Best shown by example:
5169 - 5 disks
5170 - Linux software raid5
5171
5172Layer:
5173 sda sdb sdc ... sde
5174 +-----------+ +-----------+
5175 | LUKS | | LUKS |
5176 | +-------+ | | +-------+ |
5177 | | RAID5 | | | | RAID5 | |
5178 | | ... | | | | ... | |
5179
5180Crypttab Entries:
5181
5182<target> <source> <keyfile> <options>
5183sda_crypt /dev/sda2 main_data_raid luks,keyscript=decrypt_keyctl
5184sdb_crypt /dev/sdb2 main_data_raid luks,keyscript=decrypt_keyctl
5185...
5186sde_crypt /dev/sde2 main_data_raid luks,keyscript=decrypt_keyctl
5187
5188
5189How does it work
5190----------------
5191
5192Crypttab Interface:
5193A keyscript is added to options including a keyfile definition as third
5194parameter in the crypttab file. The keyscript is called with the keyfile as the
5195first and only parameter. Additionally there are a few environment variables
5196set but currently are not used by this keyscript (man 5 crypttab for exact
5197description).
5198
5199Keyscript:
5200Keyctl_keyscript uses the Linux kernel keyring facility to securly cache
5201passphrases between multiple invocations.
5202The keyfile parameter from cryptab is used to find the same passphrase between
5203multiple invocations.
5204
5205Currently the cache timeout is 60 seconds and not configurable (please report a
5206bug if it is too low for you).
5207
5208
5209Problems
5210--------
5211
5212 - Passphrase is piped between processes and could end up in unsecured
5213 memory, thus later swapped to disk!
5214 => Use of cryptoswap recommend!
5215
5216
5217Hints
5218-----
5219
5220To remove all traces of this keyscript you may want to cleanup the keyring
5221completely with the following command afterwards:
5222 sudo keyctl clear @u
5223 Format: http://dep.debian.net/deps/dep5/
5224Upstream-Contact: Milan Broz <mbroz@redhat.com>
5225Source: http://code.google.com/p/cryptsetup
5226
5227Files: *
5228Copyright: © 2004 Christophe Saout <christophe@saout.de>
5229 © 2004-2008 Clemens Fruhwirth <clemens@endorphin.org>
5230 © 2008-2010 Milan Broz <mbroz@redhat.com>
5231License: GPL-2+
5232
5233Files: debian/*
5234Copyright: © 2004-2005 Wesley W. Terpstra <terpstra@debian.org>
5235 © 2005-2006 Michael Gebetsroither <michael.geb@gmx.at>
5236 © 2006-2008 David Härdeman <david@hardeman.nu>
5237 © 2005-2010 Jonas Meurer <jonas@freesources.org>
5238License: GPL-2+
5239
5240Files: debian/askpass.c debian/passdev.c
5241Copyright: © 2008 David Härdeman <david@hardeman.nu>
5242License: GPL-2+
5243
5244Files: debian/README.openct
5245Copyright: © 2008 Daniel Baumann <baumann@swiss-it.ch>
5246License: GPL-2+
5247
5248Files: debian/README.opensc
5249Copyright: © 2008 Benjamin Kiessling <benjaminkiessling@bttec.org>
5250License: GPL-2+
5251
5252Files: debian/README.remote
5253Copyright: © 2009 <debian@x.ray.net>
5254License: GPL-2+
5255
5256Files: debian/scripts/cryptdisks_start
5257Copyright: © 2007 Jon Dowland <jon@alcopop.org>
5258License: GPL-2+
5259
5260Files: debian/scripts/luksformat
5261Copyright: © 2005 Canonical Ltd.
5262License: GPL-2+
5263 This package is free software; you can redistribute it and/or modify
5264 it under the terms of the GNU General Public License as published by
5265 the Free Software Foundation; either version 2 of the License, or
5266 (at your option) any later version.
5267 .
5268 This package is distributed in the hope that it will be useful,
5269 but WITHOUT ANY WARRANTY; without even the implied warranty of
5270 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
5271 GNU General Public License for more details.
5272 .
5273 You should have received a copy of the GNU General Public License
5274 along with this package; if not, write to the Free Software
5275 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
5276 .
5277 On Debian systems, the complete text of the GNU General Public
5278 License v2 can be found in `/usr/share/common-licenses/GPL-2'.
5279 Format: http://dep.debian.net/deps/dep5/
5280Upstream-Contact: Milan Broz <mbroz@redhat.com>
5281Source: http://code.google.com/p/cryptsetup
5282
5283Files: *
5284Copyright: © 2004 Christophe Saout <christophe@saout.de>
5285 © 2004-2008 Clemens Fruhwirth <clemens@endorphin.org>
5286 © 2008-2010 Milan Broz <mbroz@redhat.com>
5287License: GPL-2+
5288
5289Files: debian/*
5290Copyright: © 2004-2005 Wesley W. Terpstra <terpstra@debian.org>
5291 © 2005-2006 Michael Gebetsroither <michael.geb@gmx.at>
5292 © 2006-2008 David Härdeman <david@hardeman.nu>
5293 © 2005-2010 Jonas Meurer <jonas@freesources.org>
5294License: GPL-2+
5295
5296Files: debian/askpass.c debian/passdev.c
5297Copyright: © 2008 David Härdeman <david@hardeman.nu>
5298License: GPL-2+
5299
5300Files: debian/README.openct
5301Copyright: © 2008 Daniel Baumann <baumann@swiss-it.ch>
5302License: GPL-2+
5303
5304Files: debian/README.opensc
5305Copyright: © 2008 Benjamin Kiessling <benjaminkiessling@bttec.org>
5306License: GPL-2+
5307
5308Files: debian/README.remote
5309Copyright: © 2009 <debian@x.ray.net>
5310License: GPL-2+
5311
5312Files: debian/scripts/cryptdisks_start
5313Copyright: © 2007 Jon Dowland <jon@alcopop.org>
5314License: GPL-2+
5315
5316Files: debian/scripts/luksformat
5317Copyright: © 2005 Canonical Ltd.
5318License: GPL-2+
5319 This package is free software; you can redistribute it and/or modify
5320 it under the terms of the GNU General Public License as published by
5321 the Free Software Foundation; either version 2 of the License, or
5322 (at your option) any later version.
5323 .
5324 This package is distributed in the hope that it will be useful,
5325 but WITHOUT ANY WARRANTY; without even the implied warranty of
5326 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
5327 GNU General Public License for more details.
5328 .
5329 You should have received a copy of the GNU General Public License
5330 along with this package; if not, write to the Free Software
5331 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
5332 .
5333 On Debian systems, the complete text of the GNU General Public
5334 License v2 can be found in `/usr/share/common-licenses/GPL-2'.
5335 CREDITS.txt - 2010-03-13
5336------------------------
5337
5338Few projects are completed by one person, and CUPS is no exception. We'd
5339like to thank the following individuals for their contributions:
5340
5341 Nathaniel Barbour - Lots of testing and feedback.
5342 N. Becker - setsid().
5343 Philippe Combes - French localization and buttons script.
5344 Jean-Eric Cuendet - GhostScript filters for CUPS.
5345 Van Dang - HTTP and IPP policeman.
5346 L. Peter Deutsch - MD5 code.
5347 Dr. ZP Han - setgid()/setuid().
5348 Guy Harris - *BSD shared libraries and lots of other
5349 fixes.
5350 Bjoern Jacke - I18N stuff.
5351 Wang Jian - CUPS RPM corrections.
5352 Roderick Johnstone - Beta tester of the millenium.
5353 Till Kamppeter - Bug fixes, beta testing, evangelism.
5354 I–aki Larra–aga - Basque localization.
5355 Kenshi Muto - Japanese localization, patches, and
5356 testing.
5357 Tomohiro Kato - Japanese localization.
5358 Kiko - Bug fixes.
5359 Sergey V. Kovalyov - ESP Print Pro and CUPS beta tester.
5360 Marek Laane - Estonian translation.
5361 Mark Lawrence - Microsoft interoperability testing.
5362 Jeff Licquia - Bug fixes, beta testing, evangelism.
5363 Jason McMullan - Original CUPS RPM distributions.
5364 Wes Morgan - *BSD fixes.
5365 Daniel Nylander - Swedish localization.
5366 Niklas 'Nille' ÂkerstrÅ¡m - Swedish localization.
5367 Giulio Orsero - Bug fixes and testing.
5368 Michal Osowiecki - Polish localization.
5369 Citra Paska - Indonesian localization.
5370 Kurt Pfeifle - Bug fixes, beta testing, evangelism.
5371 Vincenzo Reale - Italian localization.
5372 Petter Reinholdtsen - HP-UX compiler stuff.
5373 Juan Pablo Gonz‡lez Riopedre - Spanish localization.
5374 Opher Shachar - Hebrew localization.
5375 Stuart Stevens - HP JetDirect IPP information.
5376 Andrea Suatoni - IRIX desktop integration and testing.
5377 Teppo Turliainen - Finnish localization.
5378 Tim Waugh - Lots of patches, testing, and Linux
5379 integration.
5380 Yugami - LDAP browsing support.
5381
5382If I've missed someone, please let me know by sending an email to
5383"msweet@apple.com".
5384 Debian users,
5385
5386For making clear your printing problem, I need some information.
5387
53881. Please describe your CUPS version/revision. This will be written
5389 automatically if you use Debian bug system tools.
53902. Please describe Your printer vendor and model, and how to connect (usb,
5391 parallel, serial, lpd, ipp, http, socket, smb).
53923. Please attach your /etc/cups/printers.conf (only about problematic printer)
53934. Set LogLeveld as "debug" in your /etc/cups/cupsd.conf and reload by
5394 /etc/init.d/cups reload. After you do something causes a problem,
5395 please attach gzippped your /var/log/cups/error_log.
53965. Please attach gzipped PPD file in /etc/cups/ppd/.
5397
5398Before you report...
53991. If you use gs as filter, please check /usr/bin/gs indicates gs-esp.
5400 gs-gnu doesn't support some drivers. If gs indicates gs-gnu, please
5401 change by 'update-alternatives --config gs'.
54022. Please don't set severity to 'grave' or 'critical' if you couldn't success
5403 to print out. I usually test by my printer, then upload. (it means at
5404 least I can success to print out)
5405 I promise to look over your report. Please use 'important' for
5406 "I can't print out by my printer!".
5407
5408Thanks,
5409--
5410Kenshi Muto
5411kmuto@debian.org
5412
5413
5414
5415
5416
5417
5418 Sent when a successful AVRCP connection has been made
5419 to the remote device.
5420
5421 Disconnected() {deprecated}
5422
5423 Sent when the AVRCP connection to the remote device
5424 has been disconnected.
5425
5426Properties
5427
5428 boolean Connected [readonly]
5429 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5430Upstream-Name: CUPS
5431Upstream-Contact: Michael Sweet <msweet@apple.com>
5432Source: ftp://ftp.easysw.com/pub/cups/
5433
5434Files: *
5435Copyright: Copyright 2007-2011 by Apple Inc.
5436License: GPL-2 with exceptions
5437 This program is free software; you can redistribute it and/or modify
5438 it under the terms of the GNU General Public License as published by
5439 the Free Software Foundation, version 2 of the License.
5440 .
5441 The full text of the GPL is distributed as in
5442 /usr/share/common-licenses/GPL-2 on Debian systems.
5443 .
5444 In addition, as the copyright holder of CUPS, Apple Inc. grants
5445 the following special exceptions:
5446 .
5447 1. Apple Operating System Development License Exception;
5448 .
5449 a. Software that is developed by any person or entity
5450 for an Apple Operating System ("Apple OS-Developed
5451 Software"), including but not limited to Apple and
5452 third party printer drivers, filters, and backends
5453 for an Apple Operating System, that is linked to the
5454 CUPS imaging library or based on any sample filters
5455 or backends provided with CUPS shall not be
5456 considered to be a derivative work or collective work
5457 based on the CUPS program and is exempt from the
5458 mandatory source code release clauses of the GNU GPL.
5459 You may therefore distribute linked combinations of
5460 the CUPS imaging library with Apple OS-Developed
5461 Software without releasing the source code of the
5462 Apple OS-Developed Software. You may also use sample
5463 filters and backends provided with CUPS to develop
5464 Apple OS-Developed Software without releasing the
5465 source code of the Apple OS-Developed Software.
5466 .
5467 b. An Apple Operating System means any operating system
5468 software developed and/or marketed by Apple Computer,
5469 Inc., including but not limited to all existing
5470 releases and versions of Apple's Darwin, Mac OS X,
5471 and Mac OS X Server products and all follow-on
5472 releases and future versions thereof.
5473 .
5474 c. This exception is only available for Apple
5475 OS-Developed Software and does not apply to software
5476 that is distributed for use on other operating
5477 systems.
5478 .
5479 d. All CUPS software that falls under this license
5480 exception have the following text at the top of each
5481 source file:
5482 .
5483 This file is subject to the Apple OS-Developed
5484 Software exception.
5485 .
5486 2. OpenSSL Toolkit License Exception;
5487 .
5488 a. Apple Inc. explicitly allows the compilation and
5489 distribution of the CUPS software with the OpenSSL
5490 Toolkit.
5491 .
5492 No developer is required to provide these exceptions in a
5493 derived work.
5494
5495Files: cups/* filters/*
5496Copyright: Copyright 2007-2011 by Apple Inc.
5497License: LGPL-2 with exceptions
5498 This program is free software; you can redistribute it and/or modify it
5499 under the terms of the GNU Library General Public License as published
5500 by the Free Software Foundation, version 2 of the License.
5501 .
5502 The full text of the GPL is distributed as in
5503 /usr/share/common-licenses/GPL-2 on Debian systems.
5504 .
5505 The same exceptions as above apply.
5506 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5507Upstream-Name: CUPS
5508Upstream-Contact: Michael Sweet <msweet@apple.com>
5509Source: ftp://ftp.easysw.com/pub/cups/
5510
5511Files: *
5512Copyright: Copyright 2007-2011 by Apple Inc.
5513License: GPL-2 with exceptions
5514 This program is free software; you can redistribute it and/or modify
5515 it under the terms of the GNU General Public License as published by
5516 the Free Software Foundation, version 2 of the License.
5517 .
5518 The full text of the GPL is distributed as in
5519 /usr/share/common-licenses/GPL-2 on Debian systems.
5520 .
5521 In addition, as the copyright holder of CUPS, Apple Inc. grants
5522 the following special exceptions:
5523 .
5524 1. Apple Operating System Development License Exception;
5525 .
5526 a. Software that is developed by any person or entity
5527 for an Apple Operating System ("Apple OS-Developed
5528 Software"), including but not limited to Apple and
5529 third party printer drivers, filters, and backends
5530 for an Apple Operating System, that is linked to the
5531 CUPS imaging library or based on any sample filters
5532 or backends provided with CUPS shall not be
5533 considered to be a derivative work or collective work
5534 based on the CUPS program and is exempt from the
5535 mandatory source code release clauses of the GNU GPL.
5536 You may therefore distribute linked combinations of
5537 the CUPS imaging library with Apple OS-Developed
5538 Software without releasing the source code of the
5539 Apple OS-Developed Software. You may also use sample
5540 filters and backends provided with CUPS to develop
5541 Apple OS-Developed Software without releasing the
5542 source code of the Apple OS-Developed Software.
5543 .
5544 b. An Apple Operating System means any operating system
5545 software developed and/or marketed by Apple Computer,
5546 Inc., including but not limited to all existing
5547 releases and versions of Apple's Darwin, Mac OS X,
5548 and Mac OS X Server products and all follow-on
5549 releases and future versions thereof.
5550 .
5551 c. This exception is only available for Apple
5552 OS-Developed Software and does not apply to software
5553 that is distributed for use on other operating
5554 systems.
5555 .
5556 d. All CUPS software that falls under this license
5557 exception have the following text at the top of each
5558 source file:
5559 .
5560 This file is subject to the Apple OS-Developed
5561 Software exception.
5562 .
5563 2. OpenSSL Toolkit License Exception;
5564 .
5565 a. Apple Inc. explicitly allows the compilation and
5566 distribution of the CUPS software with the OpenSSL
5567 Toolkit.
5568 .
5569 No developer is required to provide these exceptions in a
5570 derived work.
5571
5572Files: cups/* filters/*
5573Copyright: Copyright 2007-2011 by Apple Inc.
5574License: LGPL-2 with exceptions
5575 This program is free software; you can redistribute it and/or modify it
5576 under the terms of the GNU Library General Public License as published
5577 by the Free Software Foundation, version 2 of the License.
5578 .
5579 The full text of the GPL is distributed as in
5580 /usr/share/common-licenses/GPL-2 on Debian systems.
5581 .
5582 The same exceptions as above apply.
5583 Till Kamppeter, OpenPrinting/Canonical (till.kamppeter@gmail.com)
5584Michael Sweet, Apple (msweet@apple.com)
5585Koji Otani, BBR Inc. (sho@bbr.jp)
5586Tobias Hoffmann (th55@gmx.de)
5587Lars Uebernickel, Canonical (lars@uebernic.de)
5588Robert Sander (robert.sander@epigenomics.com)
5589Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5590Upstream-Name: CUPS
5591Upstream-Contact: Michael Sweet <msweet@apple.com>
5592Source: ftp://ftp.easysw.com/pub/cups/
5593
5594Files: *
5595Copyright: Copyright 2007-2011 by Apple Inc.
5596License: GPL-2 with exceptions
5597 This program is free software; you can redistribute it and/or modify
5598 it under the terms of the GNU General Public License as published by
5599 the Free Software Foundation, version 2 of the License.
5600 .
5601 The full text of the GPL is distributed as in
5602 /usr/share/common-licenses/GPL-2 on Debian systems.
5603 .
5604 In addition, as the copyright holder of CUPS, Apple Inc. grants
5605 the following special exceptions:
5606 .
5607 1. Apple Operating System Development License Exception;
5608 .
5609 a. Software that is developed by any person or entity
5610 for an Apple Operating System ("Apple OS-Developed
5611 Software"), including but not limited to Apple and
5612 third party printer drivers, filters, and backends
5613 for an Apple Operating System, that is linked to the
5614 CUPS imaging library or based on any sample filters
5615 or backends provided with CUPS shall not be
5616 considered to be a derivative work or collective work
5617 based on the CUPS program and is exempt from the
5618 mandatory source code release clauses of the GNU GPL.
5619 You may therefore distribute linked combinations of
5620 the CUPS imaging library with Apple OS-Developed
5621 Software without releasing the source code of the
5622 Apple OS-Developed Software. You may also use sample
5623 filters and backends provided with CUPS to develop
5624 Apple OS-Developed Software without releasing the
5625 source code of the Apple OS-Developed Software.
5626 .
5627 b. An Apple Operating System means any operating system
5628 software developed and/or marketed by Apple Computer,
5629 Inc., including but not limited to all existing
5630 releases and versions of Apple's Darwin, Mac OS X,
5631 and Mac OS X Server products and all follow-on
5632 releases and future versions thereof.
5633 .
5634 c. This exception is only available for Apple
5635 OS-Developed Software and does not apply to software
5636 that is distributed for use on other operating
5637 systems.
5638 .
5639 d. All CUPS software that falls under this license
5640 exception have the following text at the top of each
5641 source file:
5642 .
5643 This file is subject to the Apple OS-Developed
5644 Software exception.
5645 .
5646 2. OpenSSL Toolkit License Exception;
5647 .
5648 a. Apple Inc. explicitly allows the compilation and
5649 distribution of the CUPS software with the OpenSSL
5650 Toolkit.
5651 .
5652 No developer is required to provide these exceptions in a
5653 derived work.
5654
5655Files: cups/* filters/*
5656Copyright: Copyright 2007-2011 by Apple Inc.
5657License: LGPL-2 with exceptions
5658 This program is free software; you can redistribute it and/or modify it
5659 under the terms of the GNU Library General Public License as published
5660 by the Free Software Foundation, version 2 of the License.
5661 .
5662 The full text of the GPL is distributed as in
5663 /usr/share/common-licenses/GPL-2 on Debian systems.
5664 .
5665 The same exceptions as above apply.
5666 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
5667Upstream-Name: cups-filters
5668Upstream-Contact: OpenPrinting <printing-architecture@lists.linux-foundation.org>
5669Source: http://www.openprinting.org/download/cups-filters/
5670
5671Files: AUTHORS.txt
5672 CHANGES.txt
5673 acloacl.m4
5674 configure
5675 install-sh
5676 debian/*
5677Copyright: 2012, Till Kamppeter <till.kamppeter@gmail.com>
5678License: GPL-2+
5679
5680Files: debian/local/textonly* debian/local/text.convs
5681Copyright: 2003-2006 Red Hat, Inc.
5682 2003-2006 Tim Waugh <twaugh@redhat.com>
5683License: GPL-2
5684
5685Files: config.h.in
5686 configure.in
5687 INSTALL.txt
5688 LICENSE.txt
5689 README.txt
5690 Makedefs.in
5691 Makefile
5692 backend/*
5693 config-scripts/*
5694 scripting/*
5695 filter/commandtoescpx.c
5696 filter/commandtopclx.c
5697 filter/common.c
5698 filter/common.h
5699 filter/cupsfilters.convs
5700 filter/cupsfilters.types
5701 filter/Dependencies
5702 filter/escp.h
5703 filter/imagetoraster.c
5704 filter/Makefile
5705 filter/pcl-common.c
5706 filter/pcl-common.h
5707 filter/pcl.h
5708 filter/pdftops.c
5709 filter/pdfutils.c
5710 filter/pdfutils.h
5711 filter/rastertoescpx.c
5712 filter/rastertopclx.c
5713 filter/textcommon.c
5714 filter/textcommon.h
5715Copyright: 2007-2011, Apple Inc.
5716 1997-2007, Easy Software Products.
5717License: GPL-2
5718
5719Files: cupsfilters/*
5720Copyright: 2007-2011, Apple Inc.
5721 1997-2007, Easy Software Products.
5722License: LGPL-2
5723
5724Files: filter/fontembed/*
5725 filter/pdf.utf-8.heavy
5726 filter/pdf.utf-8.simple
5727 filter/pdfutils.c
5728 filter/pdfutils.h
5729 filter/test_pdf1.c
5730 filter/test_pdf2.c
5731 filter/texttopdf.c
5732Copyright: 2008, Tobias Hoffmann.
5733 2007, Apple Inc.
5734 1993-2007, Easy Software Products.
5735License: GPL-2
5736
5737Files: filter/pstopdf.in
5738Copyright: 2003, Robert Sander <robert.sander@epigenomics.com>
5739 2008-2012, Till Kamppeter <till.kamppeter@gmail.com>
5740License: GPL-2
5741
5742Files: filter/imagetopdf.c
5743Copyright: 1993-2006, Easy Software Products.
5744 2006-2007, BBR Inc.
5745License: GPL-2
5746
5747Files: filter/banner.c
5748 filter/banner.h
5749 filter/bannertopdf.c
5750 filter/classified
5751 filter/confidential
5752 filter/default.pdf
5753 filter/default-testpage.pdf
5754 filter/pdf.cxx
5755 filter/pdf.h
5756 filter/secret
5757 filter/standard
5758 filter/testprint
5759 filter/topsecret
5760 filter/unclassified
5761Copyright: 2012, Canonical Ltd.
5762License: GPL-3
5763
5764Files: pdftoopvp/*
5765 pdftopdf/*
5766 filter/pdftoraster.cxx
5767 ppd/HP-PhotoSmart_Pro_B8300-hpijs-pdftoijs.ppd
5768Copyright: Copyright 2006-2011, BBR Inc. All rights reserved.
5769License: Expat
5770
5771Files: filter/pdftoijs.cxx
5772Copyright: 2008, BBR Inc. All rights reserved.
5773 2008, Tobias Hoffmann
5774License: Expat
5775
5776License: GPL-2
5777 This program may be distributed and/or modified under the terms of the
5778 version 2 of the GNU General Public License as published by the Free
5779 Software Foundation (the "GPL").
5780 .
5781 When distributed under the terms of the GPL, this program is
5782 distributed in the hope that it will be useful, but WITHOUT ANY
5783 WARRANTY; without even the implied warranty of MERCHANTABILITY or
5784 FITNESS FOR A PARTICULAR PURPOSE. See the GPL for more details.
5785 .
5786 On Debian systems the GNU General Public License (GPL) version 2 is
5787 located in '/usr/share/common-licenses/GPL-2'.
5788 .
5789 You should have received a copy of the GNU General Public License along
5790 with this program. If not, see <http://www.gnu.org/licenses/>.
5791
5792License: GPL-2+
5793 This program may be distributed and/or modified under the terms of the
5794 GNU General Public License as published by the Free Software Foundation
5795 (the "GPL"); either version 2 of the GPL, or (at your option) any later
5796 version.
5797 .
5798 When distributed under the terms of the GPL, this program is
5799 distributed in the hope that it will be useful, but WITHOUT ANY
5800 WARRANTY; without even the implied warranty of MERCHANTABILITY or
5801 FITNESS FOR A PARTICULAR PURPOSE. See the GPL for more details.
5802 .
5803 On Debian systems the GNU General Public License (GPL) version 2 is
5804 located in '/usr/share/common-licenses/GPL-2'.
5805 .
5806 You should have received a copy of the GNU General Public License along
5807 with this program. If not, see <http://www.gnu.org/licenses/>.
5808
5809License: GPL-3
5810 This program may be distributed and/or modified under the terms of the
5811 version 3 of the GNU General Public License as published by the Free
5812 Software Foundation (the "GPL").
5813 .
5814 When distributed under the terms of the GPL, this program is
5815 distributed in the hope that it will be useful, but WITHOUT ANY
5816 WARRANTY; without even the implied warranty of MERCHANTABILITY or
5817 FITNESS FOR A PARTICULAR PURPOSE. See the GPL for more details.
5818 .
5819 On Debian systems the GNU General Public License (GPL) version 2 is
5820 located in '/usr/share/common-licenses/GPL-3'.
5821 .
5822 You should have received a copy of the GNU General Public License along
5823 with this program. If not, see <http://www.gnu.org/licenses/>.
5824
5825License: LGPL-2
5826 The libcupsfilters library is provided under the terms of version 2 of
5827 the GNU Library General Public License. This program is distributed in
5828 the hope that it will be useful, but WITHOUT ANY WARRANTY; without
5829 even the implied warranty of MERCHANTABILITY or FITNESS FOR A
5830 PARTICULAR PURPOSE.
5831 .
5832 On Debian systems the GNU Library General Public License (GPL) version 2 is
5833 located in '/usr/share/common-licenses/LGPL-2'.
5834 .
5835 You should have received a copy of the GNU Library General Public License along
5836 with this program. If not, see <http://www.gnu.org/licenses/>.
5837
5838License: Expat
5839 Permission is hereby granted, free of charge, to any person obtaining
5840 a copy of this software and associated documentation files (the
5841 "Software"), to deal in the Software without restriction, including
5842 without limitation the rights to use, copy, modify, merge, publish,
5843 distribute, sublicense, and/or sell copies of the Software, and to
5844 permit persons to whom the Software is furnished to do so, subject to
5845 the following conditions:
5846 .
5847 The above copyright notice and this permission notice shall be
5848 included in all copies or substantial portions of the Software.
5849 .
5850 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
5851 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
5852 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
5853 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
5854 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
5855 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
5856 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
5857 Building with the diet libc
5858---------------------------
5859
5860This package optionally can be built with the diet libc instead of the
5861glibc to provide small statically linked programs. The resulting package
5862has no dependency on any other package.
5863
5864To use the diet libc, make sure the latest versions of the dietlibc-dev
5865package is installed, and set DEB_BUILD_OPTIONS=diet in the environment
5866when building the package, e.g.:
5867
5868 # apt-get install dietlibc-dev
5869 $ DEB_BUILD_OPTIONS=diet fakeroot apt-get source -b dash
5870
5871 -- Gerrit Pape <pape@smarden.org>, Wed, 23 Jun 2004 05:11:20 +0000
5872 Dash sources for Debian
5873-----------------------
5874
5875The dash Debian package sources are available through git, and
5876through 'apt-get source dash'. Getting the sources through git
5877should be preferred:
5878
5879 # apt-get install git # if not yet done
5880
5881 $ git clone http://smarden.org/git/dash.git/
5882 $ cd dash
5883
5884After cloning the repository, you have checked out the debian-sid
5885branch, ready to be used by dpkg-buildpackage, e.g.
5886
5887 $ dpkg-buildpackage -i -rfakeroot -uc -us
5888
5889If you want to make changes in the ./debian/ subdirectory, this is the
5890correct branch to work on. After making changes, document them in
5891debian/changelog, and commit through 'git add' and 'git commit', or 'git
5892commit -a', or similar. If you think the changes should be incorporated
5893into the standard Debian package, create the patch[es] through 'git
5894format-patch', and send them to the Debian Bug Tracking System, e.g.
5895
5896 $ vi debian/rules
5897 $ debchange -pi
5898 $ git commit -a
5899 $ git format-patch HEAD^
5900
5901
5902If you want to make changes to the upstream dash sources, first checkout
5903the release+patches branch
5904
5905 $ git checkout -b release+patches origin/release+patches
5906
5907The release+patches branch holds patches on top of the current release
5908version that is packaged for Debian/unstable. The current release
5909version is available in the release branch. If you are interested, you
5910can checkout this branch too
5911
5912 $ git checkout -b release origin/release
5913
5914When releasing a new Debian package based on a new upstream release, the
5915release branch will be fastforwarded, and the release+patches branch is
5916rewound and rebased onto the new HEAD of the release branch. This is
5917done by, e.g.
5918
5919 $ git checkout release
5920 $ git merge v0.5.5
5921 $ git checkout release+patches
5922 $ git rebase release
5923
5924You generally don't need to do that, but beware that the release+patches
5925branch is rewound occasionally.
5926
5927After checking out the release+patches branch, make the desired changes
5928to the upstream sources, and commit them. To integrate the changes into
5929the Debian package, extract these changes, and change to the debian-sid
5930branch (Note: the file extension for the patches is '.diff', use 'git
5931config --add format.suffix .diff' to make that the default)
5932
5933 $ git format-patch release..release+patches
5934 $ git checkout debian-sid
5935
5936Now move the extracted patches into the debian/diff/ directory, add a
5937meaningful message to debian/changelog, and commit the changes to the
5938debian-sid branch
5939
5940 $ mv ????-*.diff debian/diff/
5941 $ git add debian/diff
5942 $ debchange -pi
5943 $ git add debian/changelog
5944 $ git commit
5945
5946Again, if you think the changes should be incorporated into the standard
5947Debian package, create the patch[es] from the debian-sid branch through
5948'git format-patch', send them to the Debian Bug Tracking System.
5949
5950There's a mailing list to coordinate work on the dash packages, if
5951you're interested in helping please subscribe to the
5952<debian-package-dash> mailing list by sending an email to
5953<debian-package-dash-subscribe@list.smarden.org>.
5954
5955 -- Gerrit Pape <pape@smarden.org> Fri, 04 Jun 2010 00:22:12 +0000
5956
5957 This package was debianized by Mark W. Eichin eichin@kitten.gen.ma.us on
5958Mon, 24 Feb 1997 16:00:16 -0500.
5959
5960This package was re-ported from NetBSD and debianized by
5961Herbert Xu herbert@debian.org on Thu, 19 Jun 1997 19:29:16 +1000.
5962
5963This package was adopted by Gerrit Pape <pape@smarden.org> on
5964Fri, 28 May 2004 18:38:18 +0000.
5965
5966It was downloaded from http://gondor.apana.org.au/~herbert/dash/files/
5967
5968Copyright:
5969
5970Copyright (c) 1989-1994
5971 The Regents of the University of California. All rights reserved.
5972Copyright (c) 1997 Christos Zoulas. All rights reserved.
5973Copyright (c) 1997-2005
5974 Herbert Xu <herbert@gondor.apana.org.au>. All rights reserved.
5975
5976This code is derived from software contributed to Berkeley by Kenneth Almquist.
5977
5978
5979Redistribution and use in source and binary forms, with or without
5980modification, are permitted provided that the following conditions
5981are met:
59821. Redistributions of source code must retain the above copyright
5983 notice, this list of conditions and the following disclaimer.
59842. Redistributions in binary form must reproduce the above copyright
5985 notice, this list of conditions and the following disclaimer in the
5986 documentation and/or other materials provided with the distribution.
59873. Neither the name of the University nor the names of its contributors
5988 may be used to endorse or promote products derived from this software
5989 without specific prior written permission.
5990
5991THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
5992ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
5993IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
5994ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
5995FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
5996DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
5997OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
5998HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
5999LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
6000OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
6001SUCH DAMAGE.
6002
6003mksignames.c:
6004
6005This file is not directly linked with dash. However, its output is.
6006
6007Copyright (C) 1992 Free Software Foundation, Inc.
6008
6009This file is part of GNU Bash, the Bourne Again SHell.
6010
6011Bash is free software; you can redistribute it and/or modify it under
6012the terms of the GNU General Public License as published by the Free
6013Software Foundation; either version 2, or (at your option) any later
6014version.
6015
6016Bash is distributed in the hope that it will be useful, but WITHOUT ANY
6017WARRANTY; without even the implied warranty of MERCHANTABILITY or
6018FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
6019for more details.
6020
6021You should have received a copy of the GNU General Public License with
6022your Debian GNU/Linux system, in /usr/share/common-licenses/GPL, or with the
6023Debian GNU/Linux hello source package as the file COPYING. If not,
6024write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
6025Boston, MA 02111 USA.
6026
6027 This package was debianized by Colin Walters <walters@debian.org> on
6028Thu, 6 Mar 2003 18:01:37 -0500
6029
6030It was downloaded from http://www.freedesktop.org/software/dbus
6031
6032This package is dual-licensed under the Academic Free License version 2.1,
6033and the GPL version 2. For a description of the GPL, see
6034/usr/share/common-licenses/GPL-2 on your Debian system.
6035
6036Portions of the package are only licensed under the GPL (notably
6037tools/dbus-cleanup-sockets.c and test/decode-gcov.c ).
6038
6039The Academic Free License follows:
6040
6041The Academic Free License
6042v. 2.1
6043
6044This Academic Free License (the "License") applies to any original
6045work of authorship (the "Original Work") whose owner (the "Licensor")
6046has placed the following notice immediately following the copyright
6047notice for the Original Work:
6048
6049Licensed under the Academic Free License version 2.1
6050
60511) Grant of Copyright License. Licensor hereby grants You a
6052world-wide, royalty-free, non-exclusive, perpetual, sublicenseable
6053license to do the following:
6054
6055a) to reproduce the Original Work in copies;
6056
6057b) to prepare derivative works ("Derivative Works") based upon the Original Work;
6058
6059c) to distribute copies of the Original Work and Derivative Works to the public;
6060
6061d) to perform the Original Work publicly; and
6062
6063e) to display the Original Work publicly.
6064
60652) Grant of Patent License. Licensor hereby grants You a world-wide,
6066royalty-free, non-exclusive, perpetual, sublicenseable license, under
6067patent claims owned or controlled by the Licensor that are embodied in
6068the Original Work as furnished by the Licensor, to make, use, sell and
6069offer for sale the Original Work and Derivative Works.
6070
60713) Grant of Source Code License. The term "Source Code" means the
6072preferred form of the Original Work for making modifications to it and
6073all available documentation describing how to modify the Original
6074Work. Licensor hereby agrees to provide a machine-readable copy of the
6075Source Code of the Original Work along with each copy of the Original
6076Work that Licensor distributes. Licensor reserves the right to satisfy
6077this obligation by placing a machine-readable copy of the Source Code
6078in an information repository reasonably calculated to permit
6079inexpensive and convenient access by You for as long as Licensor
6080continues to distribute the Original Work, and by publishing the
6081address of that information repository in a notice immediately
6082following the copyright notice that applies to the Original Work.
6083
60844) Exclusions From License Grant. Neither the names of Licensor, nor
6085the names of any contributors to the Original Work, nor any of their
6086trademarks or service marks, may be used to endorse or promote
6087products derived from this Original Work without express prior written
6088permission of the Licensor. Nothing in this License shall be deemed to
6089grant any rights to trademarks, copyrights, patents, trade secrets or
6090any other intellectual property of Licensor except as expressly stated
6091herein. No patent license is granted to make, use, sell or offer to
6092sell embodiments of any patent claims other than the licensed claims
6093defined in Section 2. No right is granted to the trademarks of
6094Licensor even if such marks are included in the Original Work. Nothing
6095in this License shall be interpreted to prohibit Licensor from
6096licensing under different terms from this License any Original Work
6097that Licensor otherwise would have a right to license.
6098
60995) This section intentionally omitted.
6100
61016) Attribution Rights. You must retain, in the Source Code of any
6102Derivative Works that You create, all copyright, patent or trademark
6103notices from the Source Code of the Original Work, as well as any
6104notices of licensing and any descriptive text identified therein as an
6105"Attribution Notice." You must cause the Source Code for any
6106Derivative Works that You create to carry a prominent Attribution
6107Notice reasonably calculated to inform recipients that You have
6108modified the Original Work.
6109
61107) Warranty of Provenance and Disclaimer of Warranty. Licensor
6111warrants that the copyright in and to the Original Work and the patent
6112rights granted herein by Licensor are owned by the Licensor or are
6113sublicensed to You under the terms of this License with the permission
6114of the contributor(s) of those copyrights and patent rights. Except as
6115expressly stated in the immediately proceeding sentence, the Original
6116Work is provided under this License on an "AS IS" BASIS and WITHOUT
6117WARRANTY, either express or implied, including, without limitation,
6118the warranties of NON-INFRINGEMENT, MERCHANTABILITY or FITNESS FOR A
6119PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY OF THE ORIGINAL
6120WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an essential
6121part of this License. No license to Original Work is granted hereunder
6122except under this disclaimer.
6123
61248) Limitation of Liability. Under no circumstances and under no legal
6125theory, whether in tort (including negligence), contract, or
6126otherwise, shall the Licensor be liable to any person for any direct,
6127indirect, special, incidental, or consequential damages of any
6128character arising as a result of this License or the use of the
6129Original Work including, without limitation, damages for loss of
6130goodwill, work stoppage, computer failure or malfunction, or any and
6131all other commercial damages or losses. This limitation of liability
6132shall not apply to liability for death or personal injury resulting
6133from Licensor's negligence to the extent applicable law prohibits such
6134limitation. Some jurisdictions do not allow the exclusion or
6135limitation of incidental or consequential damages, so this exclusion
6136and limitation may not apply to You.
6137
61389) Acceptance and Termination. If You distribute copies of the
6139Original Work or a Derivative Work, You must make a reasonable effort
6140under the circumstances to obtain the express assent of recipients to
6141the terms of this License. Nothing else but this License (or another
6142written agreement between Licensor and You) grants You permission to
6143create Derivative Works based upon the Original Work or to exercise
6144any of the rights granted in Section 1 herein, and any attempt to do
6145so except under the terms of this License (or another written
6146agreement between Licensor and You) is expressly prohibited by
6147U.S. copyright law, the equivalent laws of other countries, and by
6148international treaty. Therefore, by exercising any of the rights
6149granted to You in Section 1 herein, You indicate Your acceptance of
6150this License and all of its terms and conditions.
6151
615210) Termination for Patent Action. This License shall terminate
6153automatically and You may no longer exercise any of the rights granted
6154to You by this License as of the date You commence an action,
6155including a cross-claim or counterclaim, against Licensor or any
6156licensee alleging that the Original Work infringes a patent. This
6157termination provision shall not apply for an action alleging patent
6158infringement by combinations of the Original Work with other software
6159or hardware.
6160
616111) Jurisdiction, Venue and Governing Law. Any action or suit relating
6162to this License may be brought only in the courts of a jurisdiction
6163wherein the Licensor resides or in which Licensor conducts its primary
6164business, and under the laws of that jurisdiction excluding its
6165conflict-of-law provisions. The application of the United Nations
6166Convention on Contracts for the International Sale of Goods is
6167expressly excluded. Any use of the Original Work outside the scope of
6168this License or after its termination shall be subject to the
6169requirements and penalties of the U.S. Copyright Act, 17 U.S.C. § 101
6170et seq., the equivalent laws of other countries, and international
6171treaty. This section shall survive the termination of this License.
6172
617312) Attorneys Fees. In any action to enforce the terms of this License
6174or seeking damages relating thereto, the prevailing party shall be
6175entitled to recover its costs and expenses, including, without
6176limitation, reasonable attorneys' fees and costs incurred in
6177connection with such action, including any appeal of such action. This
6178section shall survive the termination of this License.
6179
618013) Miscellaneous. This License represents the complete agreement
6181concerning the subject matter hereof. If any provision of this License
6182is held to be unenforceable, such provision shall be reformed only to
6183the extent necessary to make it enforceable.
6184
618514) Definition of "You" in This License. "You" throughout this
6186License, whether in upper or lower case, means an individual or a
6187legal entity exercising rights under, and complying with all of the
6188terms of, this License. For legal entities, "You" includes any entity
6189that controls, is controlled by, or is under common control with
6190you. For purposes of this definition, "control" means (i) the power,
6191direct or indirect, to cause the direction or management of such
6192entity, whether by contract or otherwise, or (ii) ownership of fifty
6193percent (50%) or more of the outstanding shares, or (iii) beneficial
6194ownership of such entity.
6195
619615) Right to Use. You may use the Original Work in all ways not
6197otherwise restricted or conditioned by this License or by law, and
6198Licensor promises not to interfere with or be responsible for such
6199uses by You.
6200
6201This license is Copyright (C) 2003-2004 Lawrence E. Rosen. All rights
6202reserved. Permission is hereby granted to copy and distribute this
6203license without modification. This license may not be modified without
6204the express written permission of its copyright owner.
6205
6206
6207--
6208END OF ACADEMIC FREE LICENSE. The following is intended to describe the essential
6209differences between the Academic Free License (AFL) version 1.0 and other
6210open source licenses:
6211
6212The Academic Free License is similar to the BSD, MIT, UoI/NCSA and Apache
6213licenses in many respects but it is intended to solve a few problems with
6214those licenses.
6215
6216* The AFL is written so as to make it clear what software is being
6217licensed (by the inclusion of a statement following the copyright notice
6218in the software). This way, the license functions better than a template
6219license. The BSD, MIT and UoI/NCSA licenses apply to unidentified software.
6220
6221* The AFL contains a complete copyright grant to the software. The BSD
6222and Apache licenses are vague and incomplete in that respect.
6223
6224* The AFL contains a complete patent grant to the software. The BSD, MIT,
6225UoI/NCSA and Apache licenses rely on an implied patent license and contain
6226no explicit patent grant.
6227
6228* The AFL makes it clear that no trademark rights are granted to the
6229licensor's trademarks. The Apache license contains such a provision, but the
6230BSD, MIT and UoI/NCSA licenses do not.
6231
6232* The AFL includes the warranty by the licensor that it either owns the
6233copyright or that it is distributing the software under a license. None of
6234the other licenses contain that warranty. All other warranties are disclaimed,
6235as is the case for the other licenses.
6236
6237* The AFL is itself copyrighted (with the right granted to copy and distribute
6238without modification). This ensures that the owner of the copyright to the
6239license will control changes. The Apache license contains a copyright notice,
6240but the BSD, MIT and UoI/NCSA licenses do not.
6241 This package was debianized by Colin Walters <walters@debian.org> on
6242Thu, 6 Mar 2003 18:01:37 -0500
6243
6244It was downloaded from http://www.freedesktop.org/software/dbus
6245
6246This package is dual-licensed under the Academic Free License version 2.1,
6247and the GPL version 2. For a description of the GPL, see
6248/usr/share/common-licenses/GPL-2 on your Debian system.
6249
6250Portions of the package are only licensed under the GPL (notably
6251tools/dbus-cleanup-sockets.c and test/decode-gcov.c ).
6252
6253The Academic Free License follows:
6254
6255The Academic Free License
6256v. 2.1
6257
6258This Academic Free License (the "License") applies to any original
6259work of authorship (the "Original Work") whose owner (the "Licensor")
6260has placed the following notice immediately following the copyright
6261notice for the Original Work:
6262
6263Licensed under the Academic Free License version 2.1
6264
62651) Grant of Copyright License. Licensor hereby grants You a
6266world-wide, royalty-free, non-exclusive, perpetual, sublicenseable
6267license to do the following:
6268
6269a) to reproduce the Original Work in copies;
6270
6271b) to prepare derivative works ("Derivative Works") based upon the Original Work;
6272
6273c) to distribute copies of the Original Work and Derivative Works to the public;
6274
6275d) to perform the Original Work publicly; and
6276
6277e) to display the Original Work publicly.
6278
62792) Grant of Patent License. Licensor hereby grants You a world-wide,
6280royalty-free, non-exclusive, perpetual, sublicenseable license, under
6281patent claims owned or controlled by the Licensor that are embodied in
6282the Original Work as furnished by the Licensor, to make, use, sell and
6283offer for sale the Original Work and Derivative Works.
6284
62853) Grant of Source Code License. The term "Source Code" means the
6286preferred form of the Original Work for making modifications to it and
6287all available documentation describing how to modify the Original
6288Work. Licensor hereby agrees to provide a machine-readable copy of the
6289Source Code of the Original Work along with each copy of the Original
6290Work that Licensor distributes. Licensor reserves the right to satisfy
6291this obligation by placing a machine-readable copy of the Source Code
6292in an information repository reasonably calculated to permit
6293inexpensive and convenient access by You for as long as Licensor
6294continues to distribute the Original Work, and by publishing the
6295address of that information repository in a notice immediately
6296following the copyright notice that applies to the Original Work.
6297
62984) Exclusions From License Grant. Neither the names of Licensor, nor
6299the names of any contributors to the Original Work, nor any of their
6300trademarks or service marks, may be used to endorse or promote
6301products derived from this Original Work without express prior written
6302permission of the Licensor. Nothing in this License shall be deemed to
6303grant any rights to trademarks, copyrights, patents, trade secrets or
6304any other intellectual property of Licensor except as expressly stated
6305herein. No patent license is granted to make, use, sell or offer to
6306sell embodiments of any patent claims other than the licensed claims
6307defined in Section 2. No right is granted to the trademarks of
6308Licensor even if such marks are included in the Original Work. Nothing
6309in this License shall be interpreted to prohibit Licensor from
6310licensing under different terms from this License any Original Work
6311that Licensor otherwise would have a right to license.
6312
63135) This section intentionally omitted.
6314
63156) Attribution Rights. You must retain, in the Source Code of any
6316Derivative Works that You create, all copyright, patent or trademark
6317notices from the Source Code of the Original Work, as well as any
6318notices of licensing and any descriptive text identified therein as an
6319"Attribution Notice." You must cause the Source Code for any
6320Derivative Works that You create to carry a prominent Attribution
6321Notice reasonably calculated to inform recipients that You have
6322modified the Original Work.
6323
63247) Warranty of Provenance and Disclaimer of Warranty. Licensor
6325warrants that the copyright in and to the Original Work and the patent
6326rights granted herein by Licensor are owned by the Licensor or are
6327sublicensed to You under the terms of this License with the permission
6328of the contributor(s) of those copyrights and patent rights. Except as
6329expressly stated in the immediately proceeding sentence, the Original
6330Work is provided under this License on an "AS IS" BASIS and WITHOUT
6331WARRANTY, either express or implied, including, without limitation,
6332the warranties of NON-INFRINGEMENT, MERCHANTABILITY or FITNESS FOR A
6333PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY OF THE ORIGINAL
6334WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an essential
6335part of this License. No license to Original Work is granted hereunder
6336except under this disclaimer.
6337
63388) Limitation of Liability. Under no circumstances and under no legal
6339theory, whether in tort (including negligence), contract, or
6340otherwise, shall the Licensor be liable to any person for any direct,
6341indirect, special, incidental, or consequential damages of any
6342character arising as a result of this License or the use of the
6343Original Work including, without limitation, damages for loss of
6344goodwill, work stoppage, computer failure or malfunction, or any and
6345all other commercial damages or losses. This limitation of liability
6346shall not apply to liability for death or personal injury resulting
6347from Licensor's negligence to the extent applicable law prohibits such
6348limitation. Some jurisdictions do not allow the exclusion or
6349limitation of incidental or consequential damages, so this exclusion
6350and limitation may not apply to You.
6351
63529) Acceptance and Termination. If You distribute copies of the
6353Original Work or a Derivative Work, You must make a reasonable effort
6354under the circumstances to obtain the express assent of recipients to
6355the terms of this License. Nothing else but this License (or another
6356written agreement between Licensor and You) grants You permission to
6357create Derivative Works based upon the Original Work or to exercise
6358any of the rights granted in Section 1 herein, and any attempt to do
6359so except under the terms of this License (or another written
6360agreement between Licensor and You) is expressly prohibited by
6361U.S. copyright law, the equivalent laws of other countries, and by
6362international treaty. Therefore, by exercising any of the rights
6363granted to You in Section 1 herein, You indicate Your acceptance of
6364this License and all of its terms and conditions.
6365
636610) Termination for Patent Action. This License shall terminate
6367automatically and You may no longer exercise any of the rights granted
6368to You by this License as of the date You commence an action,
6369including a cross-claim or counterclaim, against Licensor or any
6370licensee alleging that the Original Work infringes a patent. This
6371termination provision shall not apply for an action alleging patent
6372infringement by combinations of the Original Work with other software
6373or hardware.
6374
637511) Jurisdiction, Venue and Governing Law. Any action or suit relating
6376to this License may be brought only in the courts of a jurisdiction
6377wherein the Licensor resides or in which Licensor conducts its primary
6378business, and under the laws of that jurisdiction excluding its
6379conflict-of-law provisions. The application of the United Nations
6380Convention on Contracts for the International Sale of Goods is
6381expressly excluded. Any use of the Original Work outside the scope of
6382this License or after its termination shall be subject to the
6383requirements and penalties of the U.S. Copyright Act, 17 U.S.C. § 101
6384et seq., the equivalent laws of other countries, and international
6385treaty. This section shall survive the termination of this License.
6386
638712) Attorneys Fees. In any action to enforce the terms of this License
6388or seeking damages relating thereto, the prevailing party shall be
6389entitled to recover its costs and expenses, including, without
6390limitation, reasonable attorneys' fees and costs incurred in
6391connection with such action, including any appeal of such action. This
6392section shall survive the termination of this License.
6393
639413) Miscellaneous. This License represents the complete agreement
6395concerning the subject matter hereof. If any provision of this License
6396is held to be unenforceable, such provision shall be reformed only to
6397the extent necessary to make it enforceable.
6398
639914) Definition of "You" in This License. "You" throughout this
6400License, whether in upper or lower case, means an individual or a
6401legal entity exercising rights under, and complying with all of the
6402terms of, this License. For legal entities, "You" includes any entity
6403that controls, is controlled by, or is under common control with
6404you. For purposes of this definition, "control" means (i) the power,
6405direct or indirect, to cause the direction or management of such
6406entity, whether by contract or otherwise, or (ii) ownership of fifty
6407percent (50%) or more of the outstanding shares, or (iii) beneficial
6408ownership of such entity.
6409
641015) Right to Use. You may use the Original Work in all ways not
6411otherwise restricted or conditioned by this License or by law, and
6412Licensor promises not to interfere with or be responsible for such
6413uses by You.
6414
6415This license is Copyright (C) 2003-2004 Lawrence E. Rosen. All rights
6416reserved. Permission is hereby granted to copy and distribute this
6417license without modification. This license may not be modified without
6418the express written permission of its copyright owner.
6419
6420
6421--
6422END OF ACADEMIC FREE LICENSE. The following is intended to describe the essential
6423differences between the Academic Free License (AFL) version 1.0 and other
6424open source licenses:
6425
6426The Academic Free License is similar to the BSD, MIT, UoI/NCSA and Apache
6427licenses in many respects but it is intended to solve a few problems with
6428those licenses.
6429
6430* The AFL is written so as to make it clear what software is being
6431licensed (by the inclusion of a statement following the copyright notice
6432in the software). This way, the license functions better than a template
6433license. The BSD, MIT and UoI/NCSA licenses apply to unidentified software.
6434
6435* The AFL contains a complete copyright grant to the software. The BSD
6436and Apache licenses are vague and incomplete in that respect.
6437
6438* The AFL contains a complete patent grant to the software. The BSD, MIT,
6439UoI/NCSA and Apache licenses rely on an implied patent license and contain
6440no explicit patent grant.
6441
6442* The AFL makes it clear that no trademark rights are granted to the
6443licensor's trademarks. The Apache license contains such a provision, but the
6444BSD, MIT and UoI/NCSA licenses do not.
6445
6446* The AFL includes the warranty by the licensor that it either owns the
6447copyright or that it is distributing the software under a license. None of
6448the other licenses contain that warranty. All other warranties are disclaimed,
6449as is the case for the other licenses.
6450
6451* The AFL is itself copyrighted (with the right granted to copy and distribute
6452without modification). This ensures that the owner of the copyright to the
6453license will control changes. The Apache license contains a copyright notice,
6454but the BSD, MIT and UoI/NCSA licenses do not.
6455 Phil Nelson <philnelson@acm.org> wrote bc, including the number.c
6456source in the "lib" directory.
6457
6458Ken Pizzini <ken@gnu.org> wrote dc, making use of the lib/number.c
6459code that Phil Nelson wrote to handle the actual multiprecision
6460arithmetic.
6461 GNU bc version 1.06:
6462
6463Extra configuration options:
6464
6465 --with-readline tells bc to use the readline package that allows
6466 for editing input lines when run interactive.
6467
6468 --with-editline tells bc to use the BSD editline package that
6469 allows for editing input lines when run interactive.
6470
6471Extra make steps:
6472
6473 The simple make compiles a version of bc with fixed parameters
6474 for the recursive multiplication algorithm. The fixed parameter
6475 is the number of digits where a sequential algorithm is used
6476 instead of the recursive algorithm. It is set to a value that
6477 is known good on a couple of machines. (Sparc Ultra 10, Pentium
6478 II, 450.) I'm calling this point the crossover point.
6479
6480 To make a version of bc with a custom crossover point for your
6481 machine, do the following steps:
6482
6483 make timetest
6484 make
6485
6486 The timetest step takes a minimum of 10 minutes to complete.
6487
6488
6489-------- Original comp.sources.reviewed README --------
6490
6491Program: GNU bc
6492Author: Philip A. Nelson
6493E-mail: phil@cs.wwu.edu
6494OS: UNIX (BSD, System V, MINIX, POSIX)
6495Copying: GNU GPL version 2
6496Copyright holder: Free Software Foundation, Inc.
6497Version: bc version 1.01
6498Required: vsprintf and vfprintf routines.
6499Machines: It has been compiled and run on the following environments:
6500 BSD4.3 (VAX 11)
6501 MINIX 1.5 (IBM PC, both K&R and ANSI compilers)
6502 MINIX 1.5 (pc532)
6503 SUN-OS 4.1 (SUN 3 and SUN 4)
6504 SVR3V5 (Motorola 68K)
6505 SVR3.2 (3B2)
6506 SVR4.0.2 (a 386 box)
6507 ULTRIX 4.1 (DEC 5000)
6508 UTS (Amdahl)
6509
6510bc is an arbitrary precision numeric processing language. Syntax is
6511similar to C, but differs in many substantial areas. It supports
6512interactive execution of statements. bc is a utility included in the
6513POSIX P1003.2/D11 draft standard.
6514
6515This version was written to be a POSIX compliant bc processor with
6516several extensions to the draft standard. Option flags are available
6517to cause warning or rejection of the extensions to the POSIX standard.
6518For those who want only POSIX bc with no extensions, a grammar is
6519provided for exactly the language described in the POSIX document.
6520The grammar (sbc.y) comes from the POSIX document. The Makefile
6521contains rules to make sbc. (for Standard BC)
6522
6523Since the POSIX document does not specify how bc must be implemented,
6524this version does not use the historical method of having bc be a
6525compiler for the dc calculator. This version has a single executable
6526that both compiles the language and runs the a resulting "byte code".
6527The "byte code" is NOT the dc language.
6528
6529Also, included in the initial distribution is the library file
6530vfprintf.c for MINIX systems. My minix 1.5 did not have this file.
6531Also, you should verify that vsprintf.c works correctly on your
6532system.
6533
6534The extensions add some features I think are missing. The major
6535changes and additions for bc are (a) names are allowed to be full
6536identifiers ([a-z][a-z0-9_]*), (b) addition of the &&, ||, and !
6537operators, (c) allowing comparison and boolean operations in any
6538expression, (d) addition of an else clause to the if statement, (e)
6539addition of a new standard function "read()" that reads a number from
6540the standard input under program control, (f) passing of arrays as
6541parameters by variable, (g) addition of the "halt" statement that is
6542an executable statement unlike the quit (i.e. "if (1 == 0) quit" will
6543halt bc but "if (1 == 0) halt" will not halt bc.), and (h) the
6544addition of the special variable "last" that is assigned the value of
6545each print as the number is printed.
6546-----------------------------------------------------------------------
6547 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
6548<html>
6549<!-- Created on December 21, 2009 by texi2html 1.82
6550texi2html was written by:
6551 Lionel Cons <Lionel.Cons@cern.ch> (original author)
6552 Karl Berry <karl@freefriends.org>
6553 Olaf Bachmann <obachman@mathematik.uni-kl.de>
6554 and many others.
6555Maintained by: Many creative people.
6556Send bugs and suggestions to <texi2html-bug@nongnu.org>
6557-->
6558<head>
6559<title>dc, an arbitrary precision calculator</title>
6560
6561<meta name="description" content="dc, an arbitrary precision calculator">
6562<meta name="keywords" content="dc, an arbitrary precision calculator">
6563<meta name="resource-type" content="document">
6564<meta name="distribution" content="global">
6565<meta name="Generator" content="texi2html 1.82">
6566<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
6567<style type="text/css">
6568<!--
6569a.summary-letter {text-decoration: none}
6570blockquote.smallquotation {font-size: smaller}
6571pre.display {font-family: serif}
6572pre.format {font-family: serif}
6573pre.menu-comment {font-family: serif}
6574pre.menu-preformatted {font-family: serif}
6575pre.smalldisplay {font-family: serif; font-size: smaller}
6576pre.smallexample {font-size: smaller}
6577pre.smallformat {font-family: serif; font-size: smaller}
6578pre.smalllisp {font-size: smaller}
6579span.roman {font-family:serif; font-weight:normal;}
6580span.sansserif {font-family:sans-serif; font-weight:normal;}
6581ul.toc {list-style: none}
6582-->
6583</style>
6584
6585
6586</head>
6587
6588<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
6589
6590<p>This file documents <code>dc</code>, an arbitrary precision calculator.
6591</p>
6592<p>Published by the Free Software Foundation, Inc.
659351 Franklin Street, Fifth Floor
6594Boston, MA 02110-1301 USA
6595</p>
6596<p>Copyright (C) 1984, 1994, 1997, 1998, 2000, 2005, 2006 Free Software Foundation, Inc.
6597</p>
6598<p>Permission is granted to make and distribute verbatim copies of
6599this manual provided the copyright notice and this permission notice
6600are preserved on all copies.
6601</p>
6602
6603<p>Permission is granted to copy and distribute modified versions of this
6604manual under the conditions for verbatim copying, provided that the entire
6605resulting derived work is distributed under the terms of a permission
6606notice identical to this one.
6607</p>
6608<p>Permission is granted to copy and distribute translations of this manual
6609into another language, under the above conditions for modified versions,
6610except that this permission notice may be stated in a translation approved
6611by the Foundation.
6612</p>
6613
6614
6615<a name="Top"></a>
6616<table cellpadding="1" cellspacing="1" border="0">
6617<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6618<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6619<td valign="middle" align="left">[Index]</td>
6620<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6621</tr></table>
6622<h1 class="settitle">dc, an arbitrary precision calculator</h1>
6623
6624<table class="menu" border="0" cellspacing="0">
6625<tr><td align="left" valign="top"><a href="#Introduction">1. Introduction</a></td><td> </td><td align="left" valign="top"></td></tr>
6626<tr><td align="left" valign="top"><a href="#Invocation">2. Invocation</a></td><td> </td><td align="left" valign="top"></td></tr>
6627<tr><td align="left" valign="top"><a href="#Printing-Commands">3. Printing Commands</a></td><td> </td><td align="left" valign="top"></td></tr>
6628<tr><td align="left" valign="top"><a href="#Arithmetic">4. Arithmetic</a></td><td> </td><td align="left" valign="top"></td></tr>
6629<tr><td align="left" valign="top"><a href="#Stack-Control">5. Stack Control</a></td><td> </td><td align="left" valign="top"></td></tr>
6630<tr><td align="left" valign="top"><a href="#Registers">6. Registers</a></td><td> </td><td align="left" valign="top"></td></tr>
6631<tr><td align="left" valign="top"><a href="#Parameters">7. Parameters</a></td><td> </td><td align="left" valign="top"></td></tr>
6632<tr><td align="left" valign="top"><a href="#Strings">8. Strings</a></td><td> </td><td align="left" valign="top"></td></tr>
6633<tr><td align="left" valign="top"><a href="#Status-Inquiry">9. Status Inquiry</a></td><td> </td><td align="left" valign="top"></td></tr>
6634<tr><td align="left" valign="top"><a href="#Miscellaneous">10. Miscellaneous</a></td><td> </td><td align="left" valign="top"> Other commands
6635</td></tr>
6636<tr><td align="left" valign="top"><a href="#Reporting-bugs">11. Reporting bugs</a></td><td> </td><td align="left" valign="top"></td></tr>
6637</table>
6638
6639<hr size="1">
6640<a name="Introduction"></a>
6641<table cellpadding="1" cellspacing="1" border="0">
6642<tr><td valign="middle" align="left">[<a href="#Top" title="Previous section in reading order"> < </a>]</td>
6643<td valign="middle" align="left">[<a href="#Invocation" title="Next section in reading order"> > </a>]</td>
6644<td valign="middle" align="left"> </td>
6645<td valign="middle" align="left">[ << ]</td>
6646<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6647<td valign="middle" align="left">[<a href="#Invocation" title="Next chapter"> >> </a>]</td>
6648<td valign="middle" align="left"> </td>
6649<td valign="middle" align="left"> </td>
6650<td valign="middle" align="left"> </td>
6651<td valign="middle" align="left"> </td>
6652<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6653<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6654<td valign="middle" align="left">[Index]</td>
6655<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6656</tr></table>
6657<a name="Introduction-1"></a>
6658<h1 class="chapter">1. Introduction</h1>
6659
6660<p><code>dc</code> is a reverse-polish desk calculator
6661which supports unlimited precision arithmetic.
6662It also allows you to define and call macros.
6663Normally <code>dc</code> reads from the standard input;
6664if any command arguments are given to it, they are filenames,
6665and <code>dc</code> reads and executes the contents of the files
6666instead of reading from standard input.
6667All normal output is to standard output;
6668all error messages are written to standard error.
6669</p>
6670<p>To exit, use ‘<samp>q</samp>’.
6671<kbd>C-c</kbd>
6672(or whatever other keystroke your system uses to generate a <code>SIGINT</code>)
6673does not exit;
6674it is used to abort macros that are looping, etc.
6675</p>
6676<p>A reverse-polish calculator stores numbers on a stack.
6677Entering a number pushes it on the stack.
6678Arithmetic operations pop arguments off the stack and push the results.
6679</p>
6680<p>To enter a number in <code>dc</code>, type the digits (using upper
6681case letters <code>A</code> through <code>F</code> as "digits" when working
6682with input bases greater than ten),
6683with an optional decimal point.
6684Exponential notation is not supported.
6685To enter a negative number, begin the number with ‘<samp>_</samp>’.
6686‘<samp>-</samp>’ cannot be used for this, as it is a binary operator
6687for subtraction instead.
6688To enter two numbers in succession,
6689separate them with spaces or newlines;
6690these have no meaning as commands.
6691</p>
6692<hr size="6">
6693<a name="Invocation"></a>
6694<table cellpadding="1" cellspacing="1" border="0">
6695<tr><td valign="middle" align="left">[<a href="#Introduction" title="Previous section in reading order"> < </a>]</td>
6696<td valign="middle" align="left">[<a href="#Printing-Commands" title="Next section in reading order"> > </a>]</td>
6697<td valign="middle" align="left"> </td>
6698<td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6699<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6700<td valign="middle" align="left">[<a href="#Printing-Commands" title="Next chapter"> >> </a>]</td>
6701<td valign="middle" align="left"> </td>
6702<td valign="middle" align="left"> </td>
6703<td valign="middle" align="left"> </td>
6704<td valign="middle" align="left"> </td>
6705<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6706<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6707<td valign="middle" align="left">[Index]</td>
6708<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6709</tr></table>
6710<a name="Invocation-1"></a>
6711<h1 class="chapter">2. Invocation</h1>
6712
6713<p><code>dc</code> may be invoked with the following command-line options:
6714</p><dl compact="compact">
6715<dt> ‘<samp>-e <var>expr</var></samp>’</dt>
6716<dt> ‘<samp>--expression=<var>expr</var></samp>’</dt>
6717<dd><p>Evaluate <var>expr</var> as <code>dc</code> commands.
6718</p>
6719</dd>
6720<dt> ‘<samp>-f <var>file</var></samp>’</dt>
6721<dt> ‘<samp>--file=<var>file</var></samp>’</dt>
6722<dd><p>Read and evaluate <code>dc</code> commands from <var>file</var>.
6723</p>
6724</dd>
6725<dt> ‘<samp>-h</samp>’</dt>
6726<dt> ‘<samp>--help</samp>’</dt>
6727<dd><p>Print a usage message summarizing the command-line options, then exit.
6728</p>
6729</dd>
6730<dt> ‘<samp>-V</samp>’</dt>
6731<dt> ‘<samp>--version</samp>’</dt>
6732<dd><p>Print the version information for this program, then exit.
6733</p></dd>
6734</dl>
6735
6736<p>If any command-line parameters remain after processing the options,
6737these parameters are interpreted as additional <var>file</var>s whose
6738contents are read and evaluated.
6739A file name of <code>-</code> refers to the standard input stream.
6740If no <code>-e</code> option was specified, and no files were specified,
6741then the standard input will be read for commands to evaluate.
6742</p>
6743<hr size="6">
6744<a name="Printing-Commands"></a>
6745<table cellpadding="1" cellspacing="1" border="0">
6746<tr><td valign="middle" align="left">[<a href="#Invocation" title="Previous section in reading order"> < </a>]</td>
6747<td valign="middle" align="left">[<a href="#Arithmetic" title="Next section in reading order"> > </a>]</td>
6748<td valign="middle" align="left"> </td>
6749<td valign="middle" align="left">[<a href="#Invocation" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6750<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6751<td valign="middle" align="left">[<a href="#Arithmetic" title="Next chapter"> >> </a>]</td>
6752<td valign="middle" align="left"> </td>
6753<td valign="middle" align="left"> </td>
6754<td valign="middle" align="left"> </td>
6755<td valign="middle" align="left"> </td>
6756<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6757<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6758<td valign="middle" align="left">[Index]</td>
6759<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6760</tr></table>
6761<a name="Printing-Commands-1"></a>
6762<h1 class="chapter">3. Printing Commands</h1>
6763
6764<dl compact="compact">
6765<dt> ‘<samp>p</samp>’</dt>
6766<dd><p>Prints the value on the top of the stack,
6767without altering the stack.
6768A newline is printed after the value.
6769</p>
6770</dd>
6771<dt> ‘<samp>n</samp>’</dt>
6772<dd><p>Prints the value on the top of the stack, popping it off,
6773and does not print a newline after.
6774(This command is a GNU extension.)
6775</p>
6776</dd>
6777<dt> ‘<samp>P</samp>’</dt>
6778<dd><p>Pops off the value on top of the stack.
6779If it it a string, it is simply printed without a trailing newline.
6780Otherwise it is a number, and the integer portion of its absolute
6781value is printed out as a "base (UCHAR_MAX+1)" byte stream.
6782Assuming that (UCHAR_MAX+1) is 256
6783(as it is on most machines with 8-bit bytes),
6784the sequence
6785<code>KSK0k1/ _1Ss[ls*]Sxd0>x
6786[256~Ssd0<x]dsxx
6787sx[q]Sq[Lsd0>qaPlxx]dsxx
6788sx0sqLqsxLxLK+k</code>
6789could also accomplish this function.
6790(Much of the complexity of the above native-dc code is due
6791to the ~ computing the characters backwards,
6792and the desire to ensure that all registers wind up back
6793in their original states.)
6794(Details of the behavior with a number are a GNU extension.
6795Traditional <code>dc</code> happened to "support" similar functionality
6796for a limited range of inputs as an accidental side-effect of its
6797internal representation of numbers.)
6798</p>
6799</dd>
6800<dt> ‘<samp>f</samp>’</dt>
6801<dd><p>Prints the entire contents of the stack
6802without altering anything.
6803This is a good command to use if you are lost or want
6804to figure out what the effect of some command has been.
6805</p></dd>
6806</dl>
6807
6808<p>All numeric output is split to fit within 70 columns, by default.
6809When a number is broken up in this way, the split is indicated
6810by a "\" at the end of the to-be-continued output lines.
6811The column width at which output is split can be overridden
6812by setting the <var>DC_LINE_LENGTH</var> environment variable to
6813the desired width.
6814A <var>DC_LINE_LENGTH</var> of 0 (zero) disables the line-split
6815feature altogether.
6816Invalid values of <var>DC_LINE_LENGTH</var> are silently ignored.
6817(The <var>DC_LINE_LENGTH</var> variable is a GNU extension.)
6818</p>
6819<hr size="6">
6820<a name="Arithmetic"></a>
6821<table cellpadding="1" cellspacing="1" border="0">
6822<tr><td valign="middle" align="left">[<a href="#Printing-Commands" title="Previous section in reading order"> < </a>]</td>
6823<td valign="middle" align="left">[<a href="#Stack-Control" title="Next section in reading order"> > </a>]</td>
6824<td valign="middle" align="left"> </td>
6825<td valign="middle" align="left">[<a href="#Printing-Commands" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6826<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6827<td valign="middle" align="left">[<a href="#Stack-Control" title="Next chapter"> >> </a>]</td>
6828<td valign="middle" align="left"> </td>
6829<td valign="middle" align="left"> </td>
6830<td valign="middle" align="left"> </td>
6831<td valign="middle" align="left"> </td>
6832<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6833<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6834<td valign="middle" align="left">[Index]</td>
6835<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6836</tr></table>
6837<a name="Arithmetic-1"></a>
6838<h1 class="chapter">4. Arithmetic</h1>
6839
6840<dl compact="compact">
6841<dt> ‘<samp>+</samp>’</dt>
6842<dd><p>Pops two values off the stack, adds them, and pushes the result.
6843The precision of the result is determined only
6844by the values of the arguments, and is enough to be exact.
6845</p>
6846</dd>
6847<dt> ‘<samp>-</samp>’</dt>
6848<dd><p>Pops two values, subtracts the first one popped
6849from the second one popped, and pushes the result.
6850</p>
6851</dd>
6852<dt> ‘<samp>*</samp>’</dt>
6853<dd><p>Pops two values, multiplies them, and pushes the result.
6854The number of fraction digits in the result is the largest of
6855the precision value,
6856the number of fraction digits in the multiplier,
6857or the number of fraction digits in the multiplicand;
6858but in no event exceeding the number of digits required for
6859an exact result.
6860</p>
6861</dd>
6862<dt> ‘<samp>/</samp>’</dt>
6863<dd><p>Pops two values, divides the second one popped
6864from the first one popped, and pushes the result.
6865The number of fraction digits is specified by the precision value.
6866</p>
6867</dd>
6868<dt> ‘<samp>%</samp>’</dt>
6869<dd><p>Pops two values,
6870computes the remainder of the division that
6871the ‘<samp>/</samp>’ command would do,
6872and pushes that.
6873The value computed is the same as that computed by
6874the sequence <code>Sd dld/ Ld*-</code> .
6875</p>
6876</dd>
6877<dt> ‘<samp>~</samp>’</dt>
6878<dd><p>Pops two values,
6879divides the second one popped from the first one popped.
6880The quotient is pushed first, and the remainder is pushed next.
6881The number of fraction digits used in the division
6882is specified by the precision value.
6883(The sequence <code>SdSn lnld/ LnLd%</code> could also accomplish
6884this function, with slightly different error checking.)
6885(This command is a GNU extension.)
6886</p>
6887</dd>
6888<dt> ‘<samp>^</samp>’</dt>
6889<dd><p>Pops two values and exponentiates,
6890using the first value popped as the exponent
6891and the second popped as the base.
6892The fraction part of the exponent is ignored.
6893The precision value specifies the number of fraction
6894digits in the result.
6895</p>
6896</dd>
6897<dt> ‘<samp>|</samp>’</dt>
6898<dd><p>Pops three values and computes a modular exponentiation.
6899The first value popped is used as the reduction modulus;
6900this value must be a non-zero number,
6901and the result may not be accurate if the modulus
6902is not an integer.
6903The second popped is used as the exponent;
6904this value must be a non-negative number,
6905and any fractional part of this exponent will be ignored.
6906The third value popped is the base which gets exponentiated,
6907which should be an integer.
6908For small integers this is like the sequence <code>Sm^Lm%</code>,
6909but, unlike <code>^</code>,
6910this command will work with arbritrarily large exponents.
6911(This command is a GNU extension.)
6912</p>
6913</dd>
6914<dt> ‘<samp>v</samp>’</dt>
6915<dd><p>Pops one value, computes its square root, and pushes that.
6916The precision value specifies the number of fraction digits
6917in the result.
6918</p></dd>
6919</dl>
6920
6921<p>Most arithmetic operations are affected by the <em>precision value</em>,
6922which you can set with the ‘<samp>k</samp>’ command.
6923The default precision value is zero,
6924which means that all arithmetic except for
6925addition and subtraction produces integer results.
6926</p>
6927<hr size="6">
6928<a name="Stack-Control"></a>
6929<table cellpadding="1" cellspacing="1" border="0">
6930<tr><td valign="middle" align="left">[<a href="#Arithmetic" title="Previous section in reading order"> < </a>]</td>
6931<td valign="middle" align="left">[<a href="#Registers" title="Next section in reading order"> > </a>]</td>
6932<td valign="middle" align="left"> </td>
6933<td valign="middle" align="left">[<a href="#Arithmetic" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6934<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6935<td valign="middle" align="left">[<a href="#Registers" title="Next chapter"> >> </a>]</td>
6936<td valign="middle" align="left"> </td>
6937<td valign="middle" align="left"> </td>
6938<td valign="middle" align="left"> </td>
6939<td valign="middle" align="left"> </td>
6940<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6941<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6942<td valign="middle" align="left">[Index]</td>
6943<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6944</tr></table>
6945<a name="Stack-Control-1"></a>
6946<h1 class="chapter">5. Stack Control</h1>
6947
6948<dl compact="compact">
6949<dt> ‘<samp>c</samp>’</dt>
6950<dd><p>Clears the stack, rendering it empty.
6951</p>
6952</dd>
6953<dt> ‘<samp>d</samp>’</dt>
6954<dd><p>Duplicates the value on the top of the stack,
6955pushing another copy of it.
6956Thus, ‘<samp>4d*p</samp>’ computes 4 squared and prints it.
6957</p>
6958</dd>
6959<dt> ‘<samp>r</samp>’</dt>
6960<dd><p>Reverses the order of (swaps) the top two values on the stack.
6961(This can also be accomplished with the sequence <code>SaSbLaLb</code>.)
6962(This command is a GNU extension.)
6963</p></dd>
6964</dl>
6965
6966<hr size="6">
6967<a name="Registers"></a>
6968<table cellpadding="1" cellspacing="1" border="0">
6969<tr><td valign="middle" align="left">[<a href="#Stack-Control" title="Previous section in reading order"> < </a>]</td>
6970<td valign="middle" align="left">[<a href="#Parameters" title="Next section in reading order"> > </a>]</td>
6971<td valign="middle" align="left"> </td>
6972<td valign="middle" align="left">[<a href="#Stack-Control" title="Beginning of this chapter or previous chapter"> << </a>]</td>
6973<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
6974<td valign="middle" align="left">[<a href="#Parameters" title="Next chapter"> >> </a>]</td>
6975<td valign="middle" align="left"> </td>
6976<td valign="middle" align="left"> </td>
6977<td valign="middle" align="left"> </td>
6978<td valign="middle" align="left"> </td>
6979<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6980<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6981<td valign="middle" align="left">[Index]</td>
6982<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6983</tr></table>
6984<a name="Registers-1"></a>
6985<h1 class="chapter">6. Registers</h1>
6986
6987<p><code>dc</code> provides at least 256 memory registers<a name="DOCF1" href="#FOOT1">(1)</a>,
6988each named by a single character.
6989You can store a number in a register and retrieve it later.
6990</p>
6991<dl compact="compact">
6992<dt> ‘<samp>s<var>r</var></samp>’</dt>
6993<dd><p>Pop the value off the top of the stack and
6994store it into register <var>r</var>.
6995</p>
6996</dd>
6997<dt> ‘<samp>l<var>r</var></samp>’</dt>
6998<dd><p>Copy the value in register <var>r</var>,
6999and push it onto the stack.
7000This does not alter the contents of <var>r</var>.
7001</p>
7002<p>Each register also contains its own stack.
7003The current register value is the top of the register’s stack.
7004</p>
7005</dd>
7006<dt> ‘<samp>S<var>r</var></samp>’</dt>
7007<dd><p>Pop the value off the top of the (main) stack and
7008push it onto the stack of register <var>r</var>.
7009The previous value of the register becomes inaccessible.
7010</p>
7011</dd>
7012<dt> ‘<samp>L<var>r</var></samp>’</dt>
7013<dd><p>Pop the value off the top of register <var>r</var>’s stack
7014and push it onto the main stack.
7015The previous value in register <var>r</var>’s stack, if any,
7016is now accessible via the ‘<samp>l<var>r</var></samp>’ command.
7017</p></dd>
7018</dl>
7019
7020<hr size="6">
7021<a name="Parameters"></a>
7022<table cellpadding="1" cellspacing="1" border="0">
7023<tr><td valign="middle" align="left">[<a href="#Registers" title="Previous section in reading order"> < </a>]</td>
7024<td valign="middle" align="left">[<a href="#Strings" title="Next section in reading order"> > </a>]</td>
7025<td valign="middle" align="left"> </td>
7026<td valign="middle" align="left">[<a href="#Registers" title="Beginning of this chapter or previous chapter"> << </a>]</td>
7027<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
7028<td valign="middle" align="left">[<a href="#Strings" title="Next chapter"> >> </a>]</td>
7029<td valign="middle" align="left"> </td>
7030<td valign="middle" align="left"> </td>
7031<td valign="middle" align="left"> </td>
7032<td valign="middle" align="left"> </td>
7033<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7034<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7035<td valign="middle" align="left">[Index]</td>
7036<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7037</tr></table>
7038<a name="Parameters-1"></a>
7039<h1 class="chapter">7. Parameters</h1>
7040
7041<p><code>dc</code> has three parameters that control its operation:
7042the precision, the input radix, and the output radix.
7043The precision specifies the number of fraction digits
7044to keep in the result of most arithmetic operations.
7045The input radix controls the interpretation of numbers typed in;
7046<em>all</em> numbers typed in use this radix.
7047The output radix is used for printing numbers.
7048</p>
7049<p>The input and output radices are separate parameters;
7050you can make them unequal, which can be useful or confusing.
7051The input radix must be between 2 and 16 inclusive.
7052The output radix must be at least 2.
7053The precision must be zero or greater.
7054The precision is always measured in decimal digits,
7055regardless of the current input or output radix.
7056</p>
7057<dl compact="compact">
7058<dt> ‘<samp>i</samp>’</dt>
7059<dd><p>Pops the value off the top of the stack
7060and uses it to set the input radix.
7061</p>
7062</dd>
7063<dt> ‘<samp>o</samp>’</dt>
7064<dd><p>Pops the value off the top of the stack
7065and uses it to set the output radix.
7066</p>
7067</dd>
7068<dt> ‘<samp>k</samp>’</dt>
7069<dd><p>Pops the value off the top of the stack
7070and uses it to set the precision.
7071</p>
7072</dd>
7073<dt> ‘<samp>I</samp>’</dt>
7074<dd><p>Pushes the current input radix on the stack.
7075</p>
7076</dd>
7077<dt> ‘<samp>O</samp>’</dt>
7078<dd><p>Pushes the current output radix on the stack.
7079</p>
7080</dd>
7081<dt> ‘<samp>K</samp>’</dt>
7082<dd><p>Pushes the current precision on the stack.
7083</p>
7084</dd>
7085</dl>
7086
7087<hr size="6">
7088<a name="Strings"></a>
7089<table cellpadding="1" cellspacing="1" border="0">
7090<tr><td valign="middle" align="left">[<a href="#Parameters" title="Previous section in reading order"> < </a>]</td>
7091<td valign="middle" align="left">[<a href="#Status-Inquiry" title="Next section in reading order"> > </a>]</td>
7092<td valign="middle" align="left"> </td>
7093<td valign="middle" align="left">[<a href="#Parameters" title="Beginning of this chapter or previous chapter"> << </a>]</td>
7094<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
7095<td valign="middle" align="left">[<a href="#Status-Inquiry" title="Next chapter"> >> </a>]</td>
7096<td valign="middle" align="left"> </td>
7097<td valign="middle" align="left"> </td>
7098<td valign="middle" align="left"> </td>
7099<td valign="middle" align="left"> </td>
7100<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7101<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7102<td valign="middle" align="left">[Index]</td>
7103<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7104</tr></table>
7105<a name="Strings-1"></a>
7106<h1 class="chapter">8. Strings</h1>
7107
7108<p><code>dc</code> has a limited ability
7109to operate on strings as well as on numbers;
7110the only things you can do with strings are print them
7111and execute them as macros
7112(which means that the contents of the string are processed
7113as <code>dc</code> commands).
7114Both registers and the stack can hold strings,
7115and <code>dc</code> always knows whether any given object is
7116a string or a number.
7117Some commands such as arithmetic operations demand numbers
7118as arguments and print errors if given strings.
7119Other commands can accept either a number or a string;
7120for example, the ‘<samp>p</samp>’ command can accept either and prints the object
7121according to its type.
7122</p>
7123<dl compact="compact">
7124<dt> ‘<samp>[<var>characters</var>]</samp>’</dt>
7125<dd><p>Makes a string containing <var>characters</var> and pushes it on the stack.
7126For example, ‘<samp>[foo]P</samp>’ prints the characters ‘<samp>foo</samp>’
7127(with no newline).
7128Note that all square brackets (‘<samp>[</samp>’s and ‘<samp>]</samp>’s) must be balanced;
7129there is no mechanism provided for handling unbalanced square brackets.
7130</p>
7131</dd>
7132<dt> ‘<samp>a</samp>’</dt>
7133<dd><p>The mnemonic for this is somewhat erroneous: asciify.
7134The top-of-stack is popped.
7135If it was a number, then the low-order byte of this number
7136is converted into a 1-character string
7137and pushed onto the stack.
7138Otherwise the top-of-stack was a string,
7139and the first character of that string is pushed back.
7140(This command is a GNU extension.)
7141</p>
7142</dd>
7143<dt> ‘<samp>x</samp>’</dt>
7144<dd><p>Pops a value off the stack and executes it as a macro.
7145Normally it should be a string;
7146if it is a number, it is simply pushed back onto the stack.
7147For example, ‘<samp>[1p]x</samp>’ executes the macro ‘<samp>1p</samp>’,
7148which pushes 1 on the stack and prints ‘<samp>1</samp>’ on a separate line.
7149</p>
7150<p>Macros are most often stored in registers;
7151‘<samp>[1p]sa</samp>’ stores a macro to print ‘<samp>1</samp>’ into register ‘<samp>a</samp>’,
7152and ‘<samp>lax</samp>’ invokes the macro.
7153</p>
7154</dd>
7155<dt> ‘<samp>><var>r</var></samp>’</dt>
7156<dd><p>Pops two values off the stack and compares them
7157assuming they are numbers,
7158executing the contents of register <var>r</var> as a macro
7159if the original top-of-stack is greater.
7160Thus, ‘<samp>1 2>a</samp>’ will invoke register ‘<samp>a</samp>’’s contents
7161and ‘<samp>2 1>a</samp>’ will not.
7162</p>
7163</dd>
7164<dt> ‘<samp>!><var>r</var></samp>’</dt>
7165<dd><p>Similar but invokes the macro if the original top-of-stack is not greater
7166(is less than or equal to) what was the second-to-top.
7167</p>
7168</dd>
7169<dt> ‘<samp><<var>r</var></samp>’</dt>
7170<dd><p>Similar but invokes the macro if the original top-of-stack is less.
7171</p>
7172</dd>
7173<dt> ‘<samp>!<<var>r</var></samp>’</dt>
7174<dd><p>Similar but invokes the macro if the original top-of-stack is not less
7175(is greater than or equal to) what was the second-to-top.
7176</p>
7177</dd>
7178<dt> ‘<samp>=<var>r</var></samp>’</dt>
7179<dd><p>Similar but invokes the macro if the two numbers popped are equal.
7180</p>
7181</dd>
7182<dt> ‘<samp>!=<var>r</var></samp>’</dt>
7183<dd><p>Similar but invokes the macro if the two numbers popped are not equal.
7184</p>
7185</dd>
7186<dt> ‘<samp>?</samp>’</dt>
7187<dd><p>Reads a line from the terminal and executes it.
7188This command allows a macro to request input from the user.
7189</p>
7190</dd>
7191<dt> ‘<samp>q</samp>’</dt>
7192<dd><p>During the execution of a macro,
7193this command exits from the macro and also from the macro which invoked it.
7194If called from the top level,
7195or from a macro which was called directly from the top level,
7196the ‘<samp>q</samp>’ command will cause <code>dc</code> to exit.
7197</p>
7198</dd>
7199<dt> ‘<samp>Q</samp>’</dt>
7200<dd><p>Pops a value off the stack and uses it as a count
7201of levels of macro execution to be exited.
7202Thus, ‘<samp>3Q</samp>’ exits three levels.
7203</p></dd>
7204</dl>
7205
7206<hr size="6">
7207<a name="Status-Inquiry"></a>
7208<table cellpadding="1" cellspacing="1" border="0">
7209<tr><td valign="middle" align="left">[<a href="#Strings" title="Previous section in reading order"> < </a>]</td>
7210<td valign="middle" align="left">[<a href="#Miscellaneous" title="Next section in reading order"> > </a>]</td>
7211<td valign="middle" align="left"> </td>
7212<td valign="middle" align="left">[<a href="#Strings" title="Beginning of this chapter or previous chapter"> << </a>]</td>
7213<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
7214<td valign="middle" align="left">[<a href="#Miscellaneous" title="Next chapter"> >> </a>]</td>
7215<td valign="middle" align="left"> </td>
7216<td valign="middle" align="left"> </td>
7217<td valign="middle" align="left"> </td>
7218<td valign="middle" align="left"> </td>
7219<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7220<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7221<td valign="middle" align="left">[Index]</td>
7222<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7223</tr></table>
7224<a name="Status-Inquiry-1"></a>
7225<h1 class="chapter">9. Status Inquiry</h1>
7226
7227<dl compact="compact">
7228<dt> ‘<samp>Z</samp>’</dt>
7229<dd><p>Pops a value off the stack,
7230calculates the number of digits it has
7231(or number of characters, if it is a string)
7232and pushes that number.
7233</p>
7234<p>Note that the digit count for a number does
7235<em>not</em> include any leading zeros,
7236even if those appear to the right of the radix point.
7237This may seem a bit strange at first,
7238but it is compatable with historical implementations of <code>dc</code>,
7239and can be argued to be useful for computing the magnitude of a value:
7240<code>dSaXLaZ-</code> will compute the power-of-ten multiplier
7241which would be needed to shift the decimal point
7242to be immediately before the leftmost non-zero digit.
7243</p>
7244</dd>
7245<dt> ‘<samp>X</samp>’</dt>
7246<dd><p>Pops a value off the stack,
7247calculates the number of fraction digits it has,
7248and pushes that number.
7249For a string, the value pushed is
72500.
7251</p>
7252</dd>
7253<dt> ‘<samp>z</samp>’</dt>
7254<dd><p>Pushes the current stack depth:
7255the number of objects on the stack
7256before the execution of the ‘<samp>z</samp>’ command.
7257</p></dd>
7258</dl>
7259
7260<hr size="6">
7261<a name="Miscellaneous"></a>
7262<table cellpadding="1" cellspacing="1" border="0">
7263<tr><td valign="middle" align="left">[<a href="#Status-Inquiry" title="Previous section in reading order"> < </a>]</td>
7264<td valign="middle" align="left">[<a href="#Reporting-bugs" title="Next section in reading order"> > </a>]</td>
7265<td valign="middle" align="left"> </td>
7266<td valign="middle" align="left">[<a href="#Status-Inquiry" title="Beginning of this chapter or previous chapter"> << </a>]</td>
7267<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
7268<td valign="middle" align="left">[<a href="#Reporting-bugs" title="Next chapter"> >> </a>]</td>
7269<td valign="middle" align="left"> </td>
7270<td valign="middle" align="left"> </td>
7271<td valign="middle" align="left"> </td>
7272<td valign="middle" align="left"> </td>
7273<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7274<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7275<td valign="middle" align="left">[Index]</td>
7276<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7277</tr></table>
7278<a name="Miscellaneous-1"></a>
7279<h1 class="chapter">10. Miscellaneous</h1>
7280
7281<dl compact="compact">
7282<dt> ‘<samp>!</samp>’</dt>
7283<dd><p>Will run the rest of the line as a system command.
7284Note that parsing of the !<, !=, and !> commands take precidence,
7285so if you want to run a command starting with <, =, or > you will
7286need to add a space after the !.
7287</p>
7288</dd>
7289<dt> ‘<samp>#</samp>’</dt>
7290<dd><p>Will interpret the rest of the line as a comment.
7291(This command is a GNU extension.)
7292</p>
7293</dd>
7294<dt> ‘<samp>:<var>r</var></samp>’</dt>
7295<dd><p>Will pop the top two values off of the stack.
7296The old second-to-top value will be stored in the array <var>r</var>,
7297indexed by the old top-of-stack value.
7298</p>
7299</dd>
7300<dt> ‘<samp>;<var>r</var></samp>’</dt>
7301<dd><p>Pops the top-of-stack and uses it as an index into
7302the array <var>r</var>.
7303The selected value is then pushed onto the stack.
7304</p></dd>
7305</dl>
7306
7307<p>Note that each stacked instance of a register has its own
7308array associated with it.
7309Thus ‘<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>’
7310will print 1, because the 2 was stored in an instance of <var>0:a</var>
7311that was later popped.
7312</p>
7313<hr size="6">
7314<a name="Reporting-bugs"></a>
7315<table cellpadding="1" cellspacing="1" border="0">
7316<tr><td valign="middle" align="left">[<a href="#Miscellaneous" title="Previous section in reading order"> < </a>]</td>
7317<td valign="middle" align="left">[ > ]</td>
7318<td valign="middle" align="left"> </td>
7319<td valign="middle" align="left">[<a href="#Miscellaneous" title="Beginning of this chapter or previous chapter"> << </a>]</td>
7320<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
7321<td valign="middle" align="left">[ >> ]</td>
7322<td valign="middle" align="left"> </td>
7323<td valign="middle" align="left"> </td>
7324<td valign="middle" align="left"> </td>
7325<td valign="middle" align="left"> </td>
7326<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7327<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7328<td valign="middle" align="left">[Index]</td>
7329<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7330</tr></table>
7331<a name="Reporting-bugs-1"></a>
7332<h1 class="chapter">11. Reporting bugs</h1>
7333
7334<p>Email bug reports to <a href="mailto:bug-dc@gnu.org">bug-dc@gnu.org</a>.
7335</p><hr size="6">
7336<a name="SEC_Foot"></a>
7337<table cellpadding="1" cellspacing="1" border="0">
7338<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7339<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7340<td valign="middle" align="left">[Index]</td>
7341<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7342</tr></table>
7343<h1>Footnotes</h1>
7344<h3><a name="FOOT1" href="#DOCF1">(1)</a></h3>
7345<p>The
7346exact number of registers provided by <code>dc</code> depends
7347on the range of an <code>unsigned char</code> in the C compiler
7348used to create the <code>dc</code> executable.
7349</p><hr size="1">
7350<a name="SEC_Contents"></a>
7351<table cellpadding="1" cellspacing="1" border="0">
7352<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7353<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7354<td valign="middle" align="left">[Index]</td>
7355<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7356</tr></table>
7357<h1>Table of Contents</h1>
7358<div class="contents">
7359
7360<ul class="toc">
7361 <li><a name="toc-Introduction-1" href="#Introduction">1. Introduction</a></li>
7362 <li><a name="toc-Invocation-1" href="#Invocation">2. Invocation</a></li>
7363 <li><a name="toc-Printing-Commands-1" href="#Printing-Commands">3. Printing Commands</a></li>
7364 <li><a name="toc-Arithmetic-1" href="#Arithmetic">4. Arithmetic</a></li>
7365 <li><a name="toc-Stack-Control-1" href="#Stack-Control">5. Stack Control</a></li>
7366 <li><a name="toc-Registers-1" href="#Registers">6. Registers</a></li>
7367 <li><a name="toc-Parameters-1" href="#Parameters">7. Parameters</a></li>
7368 <li><a name="toc-Strings-1" href="#Strings">8. Strings</a></li>
7369 <li><a name="toc-Status-Inquiry-1" href="#Status-Inquiry">9. Status Inquiry</a></li>
7370 <li><a name="toc-Miscellaneous-1" href="#Miscellaneous">10. Miscellaneous</a></li>
7371 <li><a name="toc-Reporting-bugs-1" href="#Reporting-bugs">11. Reporting bugs</a></li>
7372</ul>
7373</div>
7374<hr size="1">
7375<a name="SEC_About"></a>
7376<table cellpadding="1" cellspacing="1" border="0">
7377<tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
7378<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
7379<td valign="middle" align="left">[Index]</td>
7380<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
7381</tr></table>
7382<h1>About This Document</h1>
7383<p>
7384 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>.
7385</p>
7386<p>
7387 The buttons in the navigation panels have the following meaning:
7388</p>
7389<table border="1">
7390 <tr>
7391 <th> Button </th>
7392 <th> Name </th>
7393 <th> Go to </th>
7394 <th> From 1.2.3 go to</th>
7395 </tr>
7396 <tr>
7397 <td align="center"> [ < ] </td>
7398 <td align="center">Back</td>
7399 <td>Previous section in reading order</td>
7400 <td>1.2.2</td>
7401 </tr>
7402 <tr>
7403 <td align="center"> [ > ] </td>
7404 <td align="center">Forward</td>
7405 <td>Next section in reading order</td>
7406 <td>1.2.4</td>
7407 </tr>
7408 <tr>
7409 <td align="center"> [ << ] </td>
7410 <td align="center">FastBack</td>
7411 <td>Beginning of this chapter or previous chapter</td>
7412 <td>1</td>
7413 </tr>
7414 <tr>
7415 <td align="center"> [ Up ] </td>
7416 <td align="center">Up</td>
7417 <td>Up section</td>
7418 <td>1.2</td>
7419 </tr>
7420 <tr>
7421 <td align="center"> [ >> ] </td>
7422 <td align="center">FastForward</td>
7423 <td>Next chapter</td>
7424 <td>2</td>
7425 </tr>
7426 <tr>
7427 <td align="center"> [Top] </td>
7428 <td align="center">Top</td>
7429 <td>Cover (top) of document</td>
7430 <td> </td>
7431 </tr>
7432 <tr>
7433 <td align="center"> [Contents] </td>
7434 <td align="center">Contents</td>
7435 <td>Table of contents</td>
7436 <td> </td>
7437 </tr>
7438 <tr>
7439 <td align="center"> [Index] </td>
7440 <td align="center">Index</td>
7441 <td>Index</td>
7442 <td> </td>
7443 </tr>
7444 <tr>
7445 <td align="center"> [ ? ] </td>
7446 <td align="center">About</td>
7447 <td>About (help)</td>
7448 <td> </td>
7449 </tr>
7450</table>
7451
7452<p>
7453 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:
7454</p>
7455
7456<ul>
7457 <li> 1. Section One
7458 <ul>
7459 <li>1.1 Subsection One-One
7460 <ul>
7461 <li>...</li>
7462 </ul>
7463 </li>
7464 <li>1.2 Subsection One-Two
7465 <ul>
7466 <li>1.2.1 Subsubsection One-Two-One</li>
7467 <li>1.2.2 Subsubsection One-Two-Two</li>
7468 <li>1.2.3 Subsubsection One-Two-Three
7469 <strong><== Current Position </strong></li>
7470 <li>1.2.4 Subsubsection One-Two-Four</li>
7471 </ul>
7472 </li>
7473 <li>1.3 Subsection One-Three
7474 <ul>
7475 <li>...</li>
7476 </ul>
7477 </li>
7478 <li>1.4 Subsection One-Four</li>
7479 </ul>
7480 </li>
7481</ul>
7482
7483<hr size="1">
7484<p>
7485 <font size="-1">
7486 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>.
7487 </font>
7488 <br>
7489
7490</p>
7491</body>
7492</html>
7493 Format: http://dep.debian.net/deps/dep5/
7494Upstream-Name: dconf
7495Upstream-Contact: Ryan Lortie <desrt@desrt.ca>
7496Source: http://ftp.gnome.org/pub/GNOME/sources/dconf
7497
7498Files: *
7499Copyright: 2008,2009 Ryan Lortie <desrt@desrt.ca>
7500 2010 Codethink Limited
7501License: LGPL-2+
7502
7503Files: dbus-1/dconf-dbus-1.*
7504 tests/gsettings.c tests/dbus1.c
7505Copyright: 2010 Canonical Limited
7506License: GPL-3+
7507
7508Files: debian/*
7509Copyright: 2010,2011 Canonical Limited
7510License: GPL-3
7511
7512License: LGPL-2+
7513 This program is free software: you can redistribute it and/or modify
7514 it under the terms of the GNU Lesser General Public License as published by
7515 the Free Software Foundation, either version 2 of the License, or
7516 (at your option) any later version.
7517 .
7518 This program is distributed in the hope that it will be useful,
7519 but WITHOUT ANY WARRANTY; without even the implied warranty of
7520 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7521 GNU General Public License for more details.
7522 .
7523 You should have received a copy of the GNU Lesser General Public License
7524 along with this program. If not, see <http://www.gnu.org/licenses/>.
7525 .
7526 On Debian systems, the full text of the GNU General Public License
7527 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7528
7529License: GPL-3
7530 This program is free software: you can redistribute it and/or modify
7531 it under the terms of the GNU General Public License as published by
7532 the Free Software Foundation, version 3 of the License.
7533 .
7534 This program is distributed in the hope that it will be useful,
7535 but WITHOUT ANY WARRANTY; without even the implied warranty of
7536 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7537 GNU General Public License for more details.
7538 .
7539 You should have received a copy of the GNU General Public License
7540 along with this program. If not, see <http://www.gnu.org/licenses/>.
7541 .
7542 On Debian systems, the full text of the GNU General Public License
7543 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7544
7545License: GPL-3+
7546 This program is free software: you can redistribute it and/or modify
7547 it under the terms of the GNU General Public License as published by
7548 the Free Software Foundation, either version 3 of the License, or
7549 (at your option) any later version.
7550 .
7551 This program is distributed in the hope that it will be useful,
7552 but WITHOUT ANY WARRANTY; without even the implied warranty of
7553 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7554 GNU General Public License for more details.
7555 .
7556 You should have received a copy of the GNU General Public License
7557 along with this program. If not, see <http://www.gnu.org/licenses/>.
7558 .
7559 On Debian systems, the full text of the GNU General Public License
7560 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7561
7562 Format: http://dep.debian.net/deps/dep5/
7563Upstream-Name: dconf
7564Upstream-Contact: Ryan Lortie <desrt@desrt.ca>
7565Source: http://ftp.gnome.org/pub/GNOME/sources/dconf
7566
7567Files: *
7568Copyright: 2008,2009 Ryan Lortie <desrt@desrt.ca>
7569 2010 Codethink Limited
7570License: LGPL-2+
7571
7572Files: dbus-1/dconf-dbus-1.*
7573 tests/gsettings.c tests/dbus1.c
7574Copyright: 2010 Canonical Limited
7575License: GPL-3+
7576
7577Files: debian/*
7578Copyright: 2010,2011 Canonical Limited
7579License: GPL-3
7580
7581License: LGPL-2+
7582 This program is free software: you can redistribute it and/or modify
7583 it under the terms of the GNU Lesser General Public License as published by
7584 the Free Software Foundation, either version 2 of the License, or
7585 (at your option) any later version.
7586 .
7587 This program is distributed in the hope that it will be useful,
7588 but WITHOUT ANY WARRANTY; without even the implied warranty of
7589 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7590 GNU General Public License for more details.
7591 .
7592 You should have received a copy of the GNU Lesser General Public License
7593 along with this program. If not, see <http://www.gnu.org/licenses/>.
7594 .
7595 On Debian systems, the full text of the GNU General Public License
7596 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7597
7598License: GPL-3
7599 This program is free software: you can redistribute it and/or modify
7600 it under the terms of the GNU General Public License as published by
7601 the Free Software Foundation, version 3 of the License.
7602 .
7603 This program is distributed in the hope that it will be useful,
7604 but WITHOUT ANY WARRANTY; without even the implied warranty of
7605 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7606 GNU General Public License for more details.
7607 .
7608 You should have received a copy of the GNU General Public License
7609 along with this program. If not, see <http://www.gnu.org/licenses/>.
7610 .
7611 On Debian systems, the full text of the GNU General Public License
7612 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7613
7614License: GPL-3+
7615 This program is free software: you can redistribute it and/or modify
7616 it under the terms of the GNU General Public License as published by
7617 the Free Software Foundation, either version 3 of the License, or
7618 (at your option) any later version.
7619 .
7620 This program is distributed in the hope that it will be useful,
7621 but WITHOUT ANY WARRANTY; without even the implied warranty of
7622 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7623 GNU General Public License for more details.
7624 .
7625 You should have received a copy of the GNU General Public License
7626 along with this program. If not, see <http://www.gnu.org/licenses/>.
7627 .
7628 On Debian systems, the full text of the GNU General Public License
7629 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7630
7631 If you're looking for documentation on debconf, install the debconf-doc
7632package and see debconf(7) and the other man pages in that package.
7633
7634That package also contains the full changelog for debconf, if anyone was
7635wondering. The changelog in this package is reduced to avoid bloating base
7636with all my years of changes.
7637
7638-- Joey Hess <joeyh@debian.org>
7639 Format: http://dep.debian.net/deps/dep5/
7640Source: native package
7641
7642Files: *
7643Copyright: 1999-2010 Joey Hess <joeyh@debian.org>
7644 2003 Tomohiro KUBOTA <kubota@debian.org>
7645 2004-2010 Colin Watson <cjwatson@debian.org>
7646License: BSD-2-clause
7647
7648Files: Debconf/FrontEnd/Passthrough.pm
7649Copyright: 2000 Randolph Chung <tausq@debian.org>
7650 2000-2010 Joey Hess <joeyh@debian.org>
7651 2005-2010 Colin Watson <cjwatson@debian.org>
7652License: BSD-2-clause
7653
7654Files: Debconf/FrontEnd/Gnome.pm
7655Copyright: Eric Gillespie <epg@debian.org>
7656License: BSD-2-clause
7657
7658Files: Debconf/DbDriver/LDAP.pm
7659Copyright: Matthew Palmer <mjp16@ieee.uow.edu.au>
7660License: BSD-2-clause
7661
7662Files: debconf.py
7663Copyright: 2002 Moshe Zadka <m@moshez.org>
7664 2005 Canonical Ltd.
7665 2005-2010 Colin Watson <cjwatson@debian.org>
7666License: BSD-2-clause
7667
7668Files: debconf-show
7669Copyright: 2001-2010 Joey Hess <joeyh@debian.org>
7670 2003 Sylvain Ferriol <sylvain.ferriol@imag.fr>
7671License: BSD-2-clause
7672
7673Files: debconf-get-selections debconf-set-selections
7674Copyright: 2003 Petter Reinholdtsen <pere@hungry.com>
7675License: BSD-2-clause
7676
7677Files: Test/*
7678Copyright: 2005 Sylvain Ferriol <Sylvain.Ferriol@imag.fr>
7679License: BSD-2-clause
7680
7681Files: debconf-apt-progress
7682Copyright: 2005-2010 Colin Watson <cjwatson@debian.org>
7683 2005-2010 Joey Hess <joeyh@debian.org>
7684License: BSD-2-clause
7685
7686License: BSD-2-clause
7687 Redistribution and use in source and binary forms, with or without
7688 modification, are permitted provided that the following conditions
7689 are met:
7690 1. Redistributions of source code must retain the above copyright
7691 notice, this list of conditions and the following disclaimer.
7692 2. Redistributions in binary form must reproduce the above copyright
7693 notice, this list of conditions and the following disclaimer in the
7694 documentation and/or other materials provided with the distribution.
7695 .
7696 THIS SOFTWARE IS PROVIDED BY AUTHORS AND CONTRIBUTORS ``AS IS'' AND
7697 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
7698 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
7699 ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
7700 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
7701 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
7702 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
7703 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
7704 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
7705 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
7706 SUCH DAMAGE.
7707 ‹ ÂVÛnÛF}÷W â‡HÂEóª
7708“vÂØ©¡FÜ¢E VË‘¸ÕrIì.«ÚÔïèÂu–¤e)•T ÜáÌpΙÛf8LÕVH½Ø
7709½ žÕÊÖa *Â\|µ^ âßÉrurð
7710¼W¦Ö¼Ô¤bÃX-*8“3X娀ëҘì2j½Ow)Å“N†ád2ê“—à ¦Ls¡à ¶6ÂKÂ+à ámÑȼ?žeR(¦K¯Ô‹ï®µ8Æ’0r¶úAA˜†AÂà [?ðý““lžà ž)’æº,à ]cÂ¥°=èqY4)´ñG‘Ÿ}2øŒÊaã9S
7711ÒiÄ
7712®%lÆà LkiÅà Ró<…y©Q,è%_åÊ ˆ=>Èr^
7713¸¨lã
7714œÊ A(cI“Ã$ÂJØ ŠÆQ•CO!fĹóÃt‘Ã)+ÊR`¨
7715â€
7716þ×t3m)1?à #¨ ×ÂÀ›µ‚‹á‘ /
7717âùWÌÎ Hà g-ំ£Ô îç¹µ‹“‚ÜÃð ³lË0S%|</XÃBÂf²äK¸ÿñæêçwÙQ¦b+ǯ×Âñâ€â€¡Ã“a2šÄ#¯uEÕaá2c…Â·Ü .ÚȺz™–ê " néK-Ž(
7718'© ÂÀOvá8ˆB×jPiÆã)\V•|€ê°ZKLSyd Å YFÃ¥B=AÕXr4ÉÛÀÂ&Ã89Û=³Ô
7719ãglABÂÂã=؎ꄯU»_³rïÃ?WD"ÂÂf3WºÆ.š§‹RW´?çõPj×EPÅŽÓ$ØGÈÂdÿ¶Eÿï
77209—YÃ@kPVȣPV`¹ Úht1Yµ\´p.ÙÂxÂß®L>²\ò üÂâ1×eiA±¯2´4\Ã+`ÉkúŒ†9[b'è]=7… ÄAÿ¸Âiy
7721hÖqÇSà š; Ód¸‡'ß‹¶MÂòOZ ¦k“£$K)Å’Ã,îa ÂFcoÓdyŒÉä%ýà Âá'ZIkX~¹ôÇ;aEÇÀ:¯Â>Ÿ uŽ;‚…žA¤¾
7722Çc?ì{{ìö™%~â€Ã„£=fšÿÇìM7J¨î €ÞW¥ÛRÆž» ]lûq>¬Ë‰«ÓµW»+K[~ÂFÓÂ;½ß vÃÃý+FKÓj¦ŒdVPÇÖUÆl·G? ¤· 5Öö‘â€Ã•VVÃñpè ›ÕZ5M½Îj0NÆ’Ëœ~{³zx†_k:çÿà *×ÄŒ»
7723Ü¡Öõ—k(òƒÑ‹@Ã@ºÂU ‚î,b²Äáuj±¨æB¢¤tûr1ÓEÊæ¸+gvÂF“¥ ž¦M~RöÓ1J†±·5‚œã§ëÂ;Ÿ«R
7724Å¡â„¢#Ë…à dÃŒDa¾¤$ ÇÃä…›yÊ :J¨[ãÔž(9…kÅ¡Å’Â¥t3¯½aѧÂö
7725%Ãœ¹] ¯Ye 4s7Þoùúä_㥠’Ã
7726
7727
7728 This is the Debian GNU/Linux package debianutils.
7729
7730It is an original Debian package. Programs in it were maintained by
7731Guy Maor <maor@debian.org>, and are now maintained by Clint Adams
7732<schizo@debian.org>.
7733
7734All its programs except savelog, and which may be
7735redistributed under the terms of the GNU GPL, Version 2 or later,
7736found on Debian systems in the file /usr/share/common-licenses/GPL.
7737
7738which is in the public domain.
7739
7740savelog may be redistributed under the following terms: (The rest of
7741this file consists of savelog's distribution terms.)
7742
7743#ident "@(#)smail:RELEASE-3_2:COPYING,v 1.2 1996/06/14 18:59:10 woods Exp"
7744
7745 SMAIL GENERAL PUBLIC LICENSE
7746 (Clarified 11 Feb 1988)
7747
7748 Copyright (C) 1988 Landon Curt Noll & Ronald S. Karr
7749 Copyright (C) 1992 Ronald S. Karr
7750 Copyleft (GNU) 1988 Landon Curt Noll & Ronald S. Karr
7751
7752 Everyone is permitted to copy and distribute verbatim copies
7753 of this license, but changing it is not allowed. You can also
7754 use this wording to make the terms for other programs.
7755
7756 The license agreements of most software companies keep you at the
7757mercy of those companies. By contrast, our general public license is
7758intended to give everyone the right to share SMAIL. To make sure that
7759you get the rights we want you to have, we need to make restrictions
7760that forbid anyone to deny you these rights or to ask you to surrender
7761the rights. Hence this license agreement.
7762
7763 Specifically, we want to make sure that you have the right to give
7764away copies of SMAIL, that you receive source code or else can get it
7765if you want it, that you can change SMAIL or use pieces of it in new
7766free programs, and that you know you can do these things.
7767
7768 To make sure that everyone has such rights, we have to forbid you to
7769deprive anyone else of these rights. For example, if you distribute
7770copies of SMAIL, you must give the recipients all the rights that you
7771have. You must make sure that they, too, receive or can get the
7772source code. And you must tell them their rights.
7773
7774 Also, for our own protection, we must make certain that everyone
7775finds out that there is no warranty for SMAIL. If SMAIL is modified by
7776someone else and passed on, we want its recipients to know that what
7777they have is not what we distributed, so that any problems introduced
7778by others will not reflect on our reputation.
7779
7780 Therefore we (Landon Curt Noll and Ronald S. Karr) make the following
7781terms which say what you must do to be allowed to distribute or change
7782SMAIL.
7783
7784
7785 COPYING POLICIES
7786
7787 1. You may copy and distribute verbatim copies of SMAIL source code
7788as you receive it, in any medium, provided that you conspicuously and
7789appropriately publish on each copy a valid copyright notice "Copyright
7790(C) 1988 Landon Curt Noll & Ronald S. Karr" (or with whatever year is
7791appropriate); keep intact the notices on all files that refer to this
7792License Agreement and to the absence of any warranty; and give any
7793other recipients of the SMAIL program a copy of this License
7794Agreement along with the program. You may charge a distribution fee
7795for the physical act of transferring a copy.
7796
7797 2. You may modify your copy or copies of SMAIL or any portion of it,
7798and copy and distribute such modifications under the terms of
7799Paragraph 1 above, provided that you also do the following:
7800
7801 a) cause the modified files to carry prominent notices stating
7802 that you changed the files and the date of any change; and
7803
7804 b) cause the whole of any work that you distribute or publish,
7805 that in whole or in part contains or is a derivative of SMAIL or
7806 any part thereof, to be licensed at no charge to all third
7807 parties on terms identical to those contained in this License
7808 Agreement (except that you may choose to grant more extensive
7809 warranty protection to some or all third parties, at your option).
7810
7811 c) You may charge a distribution fee for the physical act of
7812 transferring a copy, and you may at your option offer warranty
7813 protection in exchange for a fee.
7814
7815Mere aggregation of another unrelated program with this program (or its
7816derivative) on a volume of a storage or distribution medium does not bring
7817the other program under the scope of these terms.
7818
7819 3. You may copy and distribute SMAIL (or a portion or derivative of it,
7820under Paragraph 2) in object code or executable form under the terms of
7821Paragraphs 1 and 2 above provided that you also do one of the following:
7822
7823 a) accompany it with the complete corresponding machine-readable
7824 source code, which must be distributed under the terms of
7825 Paragraphs 1 and 2 above; or,
7826
7827 b) accompany it with a written offer, valid for at least three
7828 years, to give any third party free (except for a nominal
7829 shipping charge) a complete machine-readable copy of the
7830 corresponding source code, to be distributed under the terms of
7831 Paragraphs 1 and 2 above; or,
7832
7833 c) accompany it with the information you received as to where the
7834 corresponding source code may be obtained. (This alternative is
7835 allowed only for non-commercial distribution and only if you
7836 received the program in object code or executable form alone.)
7837
7838For an executable file, complete source code means all the source code for
7839all modules it contains; but, as a special exception, it need not include
7840source code for modules which are standard libraries that accompany the
7841operating system on which the executable file runs.
7842
7843 4. You may not copy, sublicense, distribute or transfer SMAIL
7844except as expressly provided under this License Agreement. Any attempt
7845otherwise to copy, sublicense, distribute or transfer SMAIL is void and
7846your rights to use the program under this License agreement shall be
7847automatically terminated. However, parties who have received computer
7848software programs from you with this License Agreement will not have
7849their licenses terminated so long as such parties remain in full compliance.
7850
7851 5. If you wish to incorporate parts of SMAIL into other free
7852programs whose distribution conditions are different, write to Landon
7853Curt Noll & Ronald S. Karr via the Free Software Foundation at 51
7854Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. We have not yet
7855worked out a simple rule that can be stated here, but we will often
7856permit this. We will be guided by the two goals of preserving the
7857free status of all derivatives of our free software and of promoting
7858the sharing and reuse of software.
7859
7860Your comments and suggestions about our licensing policies and our
7861software are welcome! This contract was based on the contract made by
7862the Free Software Foundation. Please contact the Free Software
7863Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,
7864USA, or call (617) 542-5942 for details on copylefted material in
7865general.
7866
7867 NO WARRANTY
7868
7869 BECAUSE SMAIL IS LICENSED FREE OF CHARGE, WE PROVIDE ABSOLUTELY NO
7870WARRANTY, TO THE EXTENT PERMITTED BY APPLICABLE STATE LAW. EXCEPT WHEN
7871OTHERWISE STATED IN WRITING, LANDON CURT NOLL & RONALD S. KARR AND/OR
7872OTHER PARTIES PROVIDE SMAIL "AS IS" WITHOUT WARRANTY OF ANY KIND,
7873EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
7874WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
7875THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF SMAIL IS WITH
7876YOU. SHOULD SMAIL PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
7877NECESSARY SERVICING, REPAIR OR CORRECTION.
7878
7879 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL LANDON CURT NOLL &
7880RONALD S. KARR AND/OR ANY OTHER PARTY WHO MAY MODIFY AND REDISTRIBUTE
7881SMAIL AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
7882LOST PROFITS, LOST MONIES, OR OTHER SPECIAL, INCIDENTAL OR
7883CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
7884(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
7885INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE
7886PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS) SMAIL, EVEN IF YOU HAVE
7887BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY
7888ANY OTHER PARTY.
7889 Format: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=166
7890Upstream-Name: DéjàDup
7891Upstream-Contact: DéjàDup Maintainers <deja-dup-team@lists.launchpad.net>
7892Source: https://launchpad.net/deja-dup/+download
7893
7894Files: *
7895Copyright: 2008–2011 Michael Terry <mike@mterry.name>
7896 2009–2010 Andrew Fister <temposs@gmail.com>
7897 2010 Michael Vogt <michael.vogt@ubuntu.com>
7898 2010 Urban Skudnik <urban.skudnik@gmail.com>
7899 2011 Canonical Ltd
7900Comment: For specific author information, see the bzr logs
7901License: GPL-3+
7902
7903Files: po/*.po
7904Copyright: 2008–2011 Rosetta Contributors and Canonical Ltd
7905License: GPL-3+
7906
7907Files: common/uriutils.[ch]
7908Copyright: 2006–2007 Red Hat, Inc
7909License: GPL-3+
7910
7911Files: nautilus/NautilusExtension.[ch]
7912Copyright: 2004–2005 Free Software Foundation, Inc.
7913 2009–2011 Michael Terry <mike@mterry.name>
7914 2011 Canonical Ltd
7915License: GPL-3+
7916
7917Files: preferences/PreferencesPanel.c
7918Copyright: 2010 Intel, Inc
7919 2011 Michael Terry <mike@mterry.name>
7920License: GPL-3+
7921
7922Files: vapi/config.vapi
7923Copyright: 2007–2008 Jaap Haitsma <jaap@haitsma.org>
7924License: GPL-3+
7925
7926Files: help/C/*.page
7927Copyright: 2010–2011 Michael Terry <mike@mterry.name>
7928 2011 Canonical Ltd
7929License: CC-BY-SA-3.0
7930
7931Files: help/*/*.po
7932Copyright: 2008–2011 Rosetta Contributors and Canonical Ltd
7933License: CC-BY-SA-3.0
7934
7935Files: man/help2man
7936Copyright: 1997–2005, 2009–2010 Free Software Foundation, Inc.
7937License: GPL-3+
7938
7939Files: data/icons/*.png data/icons/source.svg
7940Copyright: 2011 Lapo Calamandrei <calamandrei@gmail.com>
7941License: LGPL-3+ or CC-BY-SA-3.0
7942
7943Files: data/icons/*/deja-dup-symbolic.svg
7944Copyright: 2011 Michael Terry <mike@mterry.name>
7945License: LGPL-3+ or CC-BY-SA-3.0
7946
7947Files: data/icons/*/deja-dup-cloud.svg
7948Copyright: None
7949License: public-domain
7950 These icons originally came from the Tango project
7951 (http://tango.freedesktop.org/) and were released into the public domain
7952 by that project.
7953
7954License: GPL-3+
7955 This program is free software: you can redistribute it and/or modify
7956 it under the terms of the GNU General Public License as published by
7957 the Free Software Foundation, either version 3 of the License, or
7958 (at your option) any later version.
7959 .
7960 This program is distributed in the hope that it will be useful,
7961 but WITHOUT ANY WARRANTY; without even the implied warranty of
7962 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7963 GNU General Public License for more details.
7964 .
7965 You should have received a copy of the GNU General Public License
7966 along with this program. If not, see <http://www.gnu.org/licenses/>.
7967 .
7968 On Debian systems, the full text of the GNU General Public License
7969 version 3 can be found in the file /usr/share/common-licenses/GPL-3.
7970
7971License: LGPL-3+
7972 This program is free software: you can redistribute it and/or modify
7973 it under the terms of the GNU Lesser General Public License as published by
7974 the Free Software Foundation, either version 3 of the License, or
7975 (at your option) any later version.
7976 .
7977 This program is distributed in the hope that it will be useful,
7978 but WITHOUT ANY WARRANTY; without even the implied warranty of
7979 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7980 GNU General Public License for more details.
7981 .
7982 You should have received a copy of the GNU Lesser General Public License
7983 along with this program. If not, see <http://www.gnu.org/licenses/>.
7984 .
7985 On Debian systems, the full text of the GNU Lesser General Public License
7986 version 3 can be found in the file /usr/share/common-licenses/LGPL-3.
7987
7988License: CC-BY-SA-3.0
7989 You are free:
7990 to Share (to copy, distribute and transmit the work) and
7991 to Remix (to adapt the work) under the following conditions:
7992 .
7993 Attribution  You must attribute the work in the manner specified by the
7994 author or licensor (but not in any way that suggests that they endorse you
7995 or your use of the work).
7996 .
7997 Share Alike  If you alter, transform, or build upon this work, you may
7998 distribute the resulting work only under the same, similar or a compatible
7999 license.
8000 .
8001 For more information, see http://creativecommons.org/licenses/by-sa/3.0/
8002
8003 This package was debianized by Ross Burton <ross@burtonini.com> on
8004Thu, 8 Aug 2002 17:55:59 +0100.
8005
8006It was downloaded from http://www.freedesktop.org/software/desktop-file-utils/
8007
8008 Copyright 2002, 2004 Red Hat, Inc
8009 Copyright 2006-2009 Vincent Untz <vuntz@gnome.org>
8010 Copyright 2003-2004, 2006-2007 Ville Skyttä, <scop at xemacs.org>
8011 Copyright 2008 Novell, Inc
8012 Copyright 2008 Novell, Inc
8013
8014License:
8015
8016 This package is free software; you can redistribute it and/or modify
8017 it under the terms of the GNU General Public License as published by
8018 the Free Software Foundation; version 2 dated June, 1991.
8019
8020 This package is distributed in the hope that it will be useful,
8021 but WITHOUT ANY WARRANTY; without even the implied warranty of
8022 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8023 GNU General Public License for more details.
8024
8025 You should have received a copy of the GNU General Public License
8026 along with this package; if not, write to the Free Software
8027 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
8028 02110-1301, USA.
8029
8030On Debian GNU/Linux systems, the complete text of the GNU General
8031Public License can be found in `/usr/share/common-licenses/GPL-2'.
8032
8033 ‹ m‘ÃNä0„ïóuä/Nvì. +´/Ãcw
8034Ç=² fžžN$¤å`YnuW}åvÞ/‘’ç\Y‰8hÌùÒ4‡c.´
8035|‰1u Ãö:Èf± Žà óšC¨Üçø¶¢à sÑ:¢ Hì8ÂßÖl
8036;ÃÅ aÇ\dð;vF5€?Â)3F= rA,}'ª LÃŽÃ o¯ú Â<O!
80376’^µTzð@6W9Ã’:÷RÃŒLÃažú‚¦8AÈ)›ž'¡YS×Â-ZI{‹¸ERJmÚʈÈS˜žÊÉüìé OÙ´Ûò\W]-zIh“ ³„6¦ }ñiGS>´>pÞs¾h<ÔcNuî)qÃÄÖîÿÕÔ/w÷Of/§¶$ñlã¸ÂyÅ 3AK«< Z‰"úƒ-PU¸ët
8038>âIÃêu¯
8039‰Âà Šºa®Ü:^yÅ FRwýðñËŸx¶Ë¦9ÃÂßË_§§8nô½x LþÒz?
8040
8041 JED Support in dictionaries-common
8042----------------------------------
8043
8044***** NEWS *****
8045A new improved jed interface to ispell has been included in package
8046jed-extra (not officially released yet), which is compatible with
8047dictionaries-common. For those reasons the jed support in
8048dictionaries-common has been removed. The text below is not completely
8049accurate and must be changed in the future.
8050****************
8051
8052The JED support provided by the dictionaries-common package improves
8053the native Ispell support in the jed package by adding a new
8054interactive S-Lang command `ispell_change_dictionary'. This function
8055allows the user to change the Ispell dictionary that will be used in
8056subsequent calls to the `ispell' command (normally bound to `M-$') and
8057will do completion using the list of Ispell dictionaries that are
8058currently installed in the system.
8059
8060To set the default dictionary for all JED sessions put the line
8061
8062 Ispell_Dictionary = "language";
8063
8064in the ~/.jedrc file. The available list of dictionaries is obtained
8065by launching jed and typing:
8066
8067 [M-x] ispell_change_dictionary [ENTER] [TAB]
8068
8069The default value of the Ispell_Dictionary variable is "default".
8070
8071 -- Rafael Laboissiere <rafael@debian.org>, Mon, Sun Apr 28 15:19:20 CEST 2002
8072
8073 -*- coding: utf-8 -*-
8074
8075dictionaries-common is a Debian native package. It contains modified
8076versions of ispell.el and flyspell.el,
8077
8078ispell.el:
8079 Original author: Ken Stevens <k.stevens@ieee.org>
8080 Copyright (C) 1994, 1995, 1997-2009 Free Software Foundation, Inc.
8081
8082 ispell.el is released under the terms of the GNU GPL, version 3,
8083 or at your option, any later version.
8084
8085flyspell.el:
8086 Original author: Manuel Serrano <Manuel.Serrano@sophia.inria.fr>
8087 Copyright (C) 1998, 2000-2009 Free Software Foundation, Inc.
8088
8089 flyspell.el is released under the terms of the GNU GPL, version 3,
8090 or at your option, any later version.
8091
8092debian/patches/* for ispell.el and flyspell.el:
8093 Copyright (C) 2004-2009 Agustin Martin <agmartin@debian.org>
8094 Released under the same terms of ispell.el and flyspell.el
8095
8096Other dictionaries-common stuff:
8097 Copyright (C) 1999-2008 Rafael Laboissiere <rafael@debian.org>
8098 Copyright (C) 2001-2009 AgustÃÂn MartÃÂn Domingo <agmartin@debian.org>
8099 Copyright (C) 2003-2009 René Engelhard <rene@debian.org>
8100
8101 dictionaries-common is released under the terms of the GNU GPL,
8102 version 2, or at your option, any later version.
8103
8104A copy of the GNU General Public License, versions 2 or 3, should
8105be available in any recent Debian system as /usr/share/common-licenses/GPL-2
8106and /usr/share/common-licenses/GPL-3. If not, see <http://www.gnu.org/licenses/>.
8107
8108The sources for this package can be found on any Debian mirror.
8109 GNU diffutils NEWS -*- outline -*-
8110
8111* Noteworthy changes in release 3.2 (2011-09-02) [stable]
8112
8113** Changes in behavior
8114
8115 --ignore-file-name-case now applies at the top level too.
8116 For example, "diff dir inIt" might compare "dir/Init" to "inIt".
8117
8118** New features
8119
8120 diff and sdiff have a new option --ignore-trailing-space (-Z).
8121
8122** Packaging
8123
8124 The texinfo documentation no longer specifies "front-cover" or "back-cover"
8125 texts, so that it may now be included in Debian's "main" section.
8126
8127
8128* Noteworthy changes in release 3.1 (2011-08-10) [stable]
8129
8130** Bug fixes
8131
8132 diff no longer reports spurious differences merely because two entries
8133 in the same directory have names that compare equal in the current
8134 locale, or compare equal because --ignore-file-name-case was given.
8135
8136* Noteworthy changes in release 3.0 (2010-05-03) [stable]
8137
8138** Bug fixes
8139
8140 diff once again prints the required "\ No newline at end of file" line
8141 when at least one input lacks a newline-at-EOF and the final hunk plus
8142 context-length aligns exactly with the end of the newline-lacking file.
8143 [bug introduced between 2.8.7 and 2.9]
8144
8145** Changes in behavior
8146
8147 In context-style diffs, diff prints a portion of a preceding "function"
8148 line for each hunk, with --show-function-line=RE (-F) or
8149 --show-c-function (-p). Now, it trims leading blanks from such lines
8150 before extracting a prefix. This is useful especially when a function
8151 line is so far indented that the name itself would be truncated or not
8152 included in the limited-width substring that diff appends.
8153
8154 diff once again reports a difference with the diagnostic
8155 "Binary files A and B differ" when at least one of the files
8156 appears to be binary. From 2.8.4 through diffutils-2.9, it printed
8157 "Files A and B differ".
8158
8159
8160* Noteworthy changes in release 2.9 (2010-02-11) [stable]
8161
8162** New features
8163
8164 New diff option --suppress-blank-empty.
8165
8166 Bring back support for `diff -NUM', where NUM is a number,
8167 even when conforming to POSIX 1003.1-2001. This change reverts to
8168 the behavior of GNU diff 2.7 and earlier. This is a change only
8169 when conforming to POSIX 1003.1-2001; there is no effect when
8170 conforming to older POSIX versions.
8171
8172 This change is in response to decisions taken in the January 2005
8173 Austin Group standardization meeting. For more details, please see
8174 "Utility Syntax Guidelines" in the Minutes of the January 2005
8175 Meeting <http://www.opengroup.org/austin/docs/austin_239.html>.
8176
8177 sdiff now understands '1' and '2' as synonyms for 'l' and 'r'.
8178
8179** Changes in behavior
8180
8181 sdiff and diff3 now invoke diff, not $(bindir)/diff
8182
8183** Administrivia
8184
8185 New discussion and bug-reporting address: bug-diffutils@gnu.org
8186
8187 updated gnulib support
8188
8189
8190* Noteworthy changes in release 2.8.7 (2004-04-13) [stable]
8191
8192 Version 2.8.7 contains no user-visible changes.
8193
8194User-visible changes in version 2.8.6:
8195
8196* New diff3 option --strip-trailing-cr.
8197
8198* With -N and -P, inaccessible empty regular files (the kind of files
8199 that 'patch' creates to indicate nonexistent backups) are now
8200 treated as nonexistent when they are in the 'backup' file position.
8201
8202* If multiple SKIP values are given to cmp, e.g., `cmp -i 10 -i 20',
8203 cmp now uses the maximal value instead of the last one.
8204
8205* diff now omits the ".000000000" on hosts that do not support
8206 fractional time stamps.
8207
8208Version 2.8.5 was not publicly released.
8209
8210User-visible changes in version 2.8.4:
8211
8212* Diff now simply prints "Files A and B differ" instead of "Binary
8213 files A and B differ". The message is output if either A or B
8214 appears to be a binary file, and the old wording was misleading
8215 because it implied that both files are binary, which is not
8216 necessarily the case.
8217
8218User-visible changes in version 2.8.3:
8219
8220* New locale: en_US.
8221
8222User-visible changes in version 2.8.2:
8223
8224* New diff and sdiff option:
8225 --tabsize=COLUMNS
8226* If --ignore-space-change or --ignore-all-space is also specified,
8227 --ignore-blank-lines now considers lines to be empty if they contain
8228 only white space.
8229* More platforms now handle multibyte characters correctly when
8230 excluding files by name (diff -x and -X).
8231* New locales: hu, pt_BR.
8232
8233User-visible changes in version 2.8.1:
8234
8235* Documentation fixes.
8236
8237User-visible changes in version 2.8:
8238
8239* cmp and diff now conform to POSIX 1003.1-2001 (IEEE Std 1003.1-2001)
8240 if the underlying system conforms to POSIX and if the _POSIX2_VERSION
8241 environment variable is set to 200112. Conformance removes support
8242 for `diff -NUM', where NUM is a number. Use -C NUM or -U NUM instead.
8243* cmp now supports trailing operands SKIP1 and SKIP2, like BSD cmp.
8244* cmp -i or --ignore-initial now accepts SKIP1:SKIP2 option value.
8245* New cmp option: -n or --bytes.
8246* cmp's old -c or --print-chars option has been renamed;
8247 use -b or --print-bytes instead.
8248* cmp now outputs "byte" rather than "char" outside the POSIX locale.
8249* cmp -l's index column width now adjusts to fit larger (or smaller) files.
8250* cmp -l -s and cmp -s -l are not allowed. Use cmp -s or cmp -l instead.
8251* diff uses ISO 8601 style time stamps for output times (e.g. "2001-11-23
8252 16:44:36.875702460 -0800") unless in the C or POSIX locale and the
8253 -c style is specified.
8254* diff's -I and -F options use the regexp syntax of grep, not of Emacs.
8255* diff now accepts multiple context arguments, and uses their maximum value.
8256* New diff and sdiff options:
8257 -E --ignore-tab-expansion
8258 --strip-trailing-cr
8259* New diff options:
8260 --from-file=FILE, --to-file=FILE
8261 --ignore-file-name-case
8262 --no-ignore-file-name-case
8263* New diff3 and sdiff option:
8264 --diff-program=PROGRAM
8265* The following diff options are still accepted, but are no longer documented.
8266 They may be withdrawn in future releases.
8267 -h (omit; it has no effect)
8268 -H (use --speed-large-files instead)
8269 -L (use --label instead)
8270 -P (use --unidirectional-new-file instead)
8271 --inhibit-hunk-merge (omit; it has no effect)
8272* Recursive diffs now sort file names according to the LC_COLLATE locale
8273 category if possible, instead of using native byte comparison.
8274* Recursive diffs now detect and report directory loops.
8275* Diff printf specs can now use the "0" and "'" flags.
8276* The new sdiff interactive command `ed' precedes each version with a header.
8277* On 64-bit hosts, files larger than 2 GB can be compared.
8278* Some internationalization support has been added, but multibyte locales
8279 are still not completely supported yet.
8280* Some diagnostics have been reworded slightly for consistency.
8281 Also, `diff -D FOO' now outputs `/* ! FOO */' instead of `/* not FOO */'.
8282* The `patch' part of the manual now describes `patch' version 2.5.4.
8283* Man pages are now distributed and installed.
8284* There is support for DJGPP; see the 'ms' subdirectory and the files
8285 m4/dos.m4 and */setmode.*.
8286
8287
8288User-visible changes in version 2.7:
8289
8290* New diff option: --binary (useful only on non-POSIX hosts)
8291* diff -b and -w now ignore line incompleteness; -B no longer does this.
8292* cmp -c now uses locale to decide which output characters to quote.
8293* Help and version messages are reorganized.
8294
8295
8296User-visible changes in version 2.6:
8297
8298* New cmp, diff, diff3, sdiff option: --help
8299* A new heuristic for diff greatly reduces the time needed to compare
8300 large input files that contain many differences.
8301* Partly as a result, GNU diff's output is not exactly the same as before.
8302 Usually it is a bit smaller, but sometimes it is a bit larger.
8303
8304
8305User-visible changes in version 2.5:
8306
8307* New cmp option: -v --version
8308
8309
8310User-visible changes in version 2.4:
8311
8312* New cmp option: --ignore-initial=BYTES
8313* New diff3 option: -T --initial-tab
8314* New diff option: --line-format=FORMAT
8315* New diff group format specifications:
8316 <PRINTF_SPEC>[eflmnEFLMN]
8317 A printf spec followed by one of the following letters
8318 causes the integer corresponding to that letter to be
8319 printed according to the printf specification.
8320 E.g. `%5df' prints the number of the first line in the
8321 group in the old file using the "%5d" format.
8322 e: line number just before the group in old file; equals f - 1
8323 f: first line number in group in the old file
8324 l: last line number in group in the old file
8325 m: line number just after the group in old file; equals l + 1
8326 n: number of lines in group in the old file; equals l - f + 1
8327 E, F, L, M, N: likewise, for lines in the new file
8328 %(A=B?T:E)
8329 If A equals B then T else E. A and B are each either a decimal
8330 constant or a single letter interpreted as above. T and E are
8331 arbitrary format strings. This format spec is equivalent to T if
8332 A's value equals B's; otherwise it is equivalent to E. For
8333 example, `%(N=0?no:%dN) line%(N=1?:s)' is equivalent to `no lines'
8334 if N (the number of lines in the group in the new file) is 0,
8335 to `1 line' if N is 1, and to `%dN lines' otherwise.
8336 %c'C'
8337 where C is a single character, stands for the character C. C may not
8338 be a backslash or an apostrophe. E.g. %c':' stands for a colon.
8339 %c'\O'
8340 where O is a string of 1, 2, or 3 octal digits, stands for the
8341 character with octal code O. E.g. %c'\0' stands for a null character.
8342* New diff line format specifications:
8343 <PRINTF_SPEC>n
8344 The line number, printed with <PRINTF_SPEC>.
8345 E.g. `%5dn' prints the line number with a "%5d" format.
8346 %c'C'
8347 %c'\O'
8348 The character C, or with octal code O, as above.
8349* Supported <PRINTF_SPEC>s have the same meaning as with printf, but must
8350 match the extended regular expression %-*[0-9]*(\.[0-9]*)?[doxX].
8351* The format spec %0 introduced in version 2.1 has been removed, since it
8352 is incompatible with printf specs like %02d. To represent a null char,
8353 use %c'\0' instead.
8354* cmp and diff now conform to POSIX 1003.2-1992 (ISO/IEC 9945-2:1993)
8355 if the underlying system conforms to POSIX:
8356 - Some messages' wordings are changed in minor ways.
8357 - ``White space'' is now whatever C's `isspace' says it is.
8358 - When comparing directories, if `diff' finds a file that is not a regular
8359 file or a directory, it reports the file's type instead of diffing it.
8360 (As usual, it follows symbolic links first.)
8361 - When signaled, sdiff exits with the signal's status, not with status 2.
8362* Now portable to hosts where int, long, pointer, etc. are not all the same
8363 size.
8364* `cmp - -' now works like `diff - -'.
8365
8366
8367User-visible changes in version 2.3:
8368
8369* New diff option: --horizon-lines=lines
8370
8371
8372User-visible changes in version 2.1:
8373
8374* New diff options:
8375 --{old,new,unchanged}-line-format='format'
8376 --{old,new,unchanged,changed}-group-format='format'
8377 -U
8378* New diff3 option:
8379 -A --show-all
8380* diff3 -m now defaults to -A, not -E.
8381* diff3 now takes up to three -L or --label options, not just two.
8382 If just two options are given, they refer to the first two input files,
8383 not the first and third input files.
8384* sdiff and diff -y handle incomplete lines.
8385
8386
8387User-visible changes in version 2.0:
8388
8389* Add sdiff and cmp programs.
8390* Add Texinfo documentation.
8391* Add configure script.
8392* Improve diff performance.
8393* New diff options:
8394-x --exclude
8395-X --exclude-from
8396-P --unidirectional-new-file
8397-W --width
8398-y --side-by-side
8399--left-column
8400--sdiff-merge-assist
8401--suppress-common-lines
8402* diff options renamed:
8403--label renamed from --file-label
8404--forward-ed renamed from --reversed-ed
8405--paginate renamed from --print
8406--entire-new-file renamed from --entire-new-files
8407--new-file renamed from --new-files
8408--all-text removed
8409* New diff3 options:
8410-v --version
8411* Add long-named equivalents for other diff3 options.
8412* diff options -F (--show-function-line) and -I (--ignore-matching-lines)
8413 can now be given more than once.
8414
8415
8416
8417Copyright (C) 1993-1994, 1998, 2001-2002, 2004, 2006, 2009-2011 Free Software
8418Foundation, Inc.
8419
8420This file is part of GNU Diffutils.
8421
8422This program is free software: you can redistribute it and/or modify
8423it under the terms of the GNU General Public License as published by
8424the Free Software Foundation, either version 3 of the License, or
8425(at your option) any later version.
8426
8427This program is distributed in the hope that it will be useful,
8428but WITHOUT ANY WARRANTY; without even the implied warranty of
8429MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8430GNU General Public License for more details.
8431
8432You should have received a copy of the GNU General Public License
8433
8434 This is the Debian prepackaged version of the GNU diffutils package.
8435GNU `diff' was written by Mike Haertel, David Hayes, Richard Stallman,
8436Len Tower, and Paul Eggert. Wayne Davison designed and implemented
8437the unified output format. GNU `diff3' was written by Randy Smith.
8438GNU `sdiff' was written by Thomas Lord. GNU `cmp' was written by
8439Torbjorn Granlund and David MacKenzie.
8440
8441The source for this release was obtained from
8442
8443http://ftp.gnu.org/gnu/diffutils/diffutils-3.2.tar.gz
8444
8445Program copyright and license:
8446=============================
8447
8448Copyright (C) 1988-1996, 1998, 2001-2002, 2004, 2006-2007, 2009-2011
8449Free Software Foundation, Inc.
8450
8451 This program is free software: you can redistribute it and/or modify
8452 it under the terms of the GNU General Public License as published by
8453 the Free Software Foundation, either version 3 of the License, or
8454 (at your option) any later version.
8455
8456 This program is distributed in the hope that it will be useful,
8457 but WITHOUT ANY WARRANTY; without even the implied warranty of
8458 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8459 GNU General Public License for more details.
8460
8461On Debian systems, the complete text of the GNU General Public License
8462may be found in `/usr/share/common-licenses/GPL'.
8463
8464
8465Manual copyright and license:
8466============================
8467
8468Copyright (C) 1992-1994, 1998, 2001-2002, 2004, 2006, 2009-2011 Free
8469Software Foundation, Inc.
8470
8471 Permission is granted to copy, distribute and/or modify this document
8472 under the terms of the GNU Free Documentation License, Version 1.3 or
8473 any later version published by the Free Software Foundation; with no
8474 Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
8475
8476On Debian systems, the complete text of the GNU Free Documentation
8477License may be found in `/usr/share/common-licenses/GFDL'.
8478
8479along with this program. If not, see <http://www.gnu.org/licenses/>.
8480 Files: *
8481Copyright:
8482 (C) 2002-2011 Jean Delvare <khali@linux-fr.org>
8483 (C) 2002 Alan Cox <alan@redhat.com>
8484 (C) 2010 Anton Arapov <anton@redhat.com>
8485License: GPL-2+
8486
8487Files: debian/*
8488Copyright:
8489 (C) 2003-2007 Petter Reinholdtsen <pere@debian.org>
8490 (C) 2011 Daniel Baumann <daniel.baumann@progress-technologies.net>
8491License: GPL-2+
8492
8493License: GPL-2+
8494 This program is free software; you can redistribute it and/or
8495 modify it under the terms of the GNU General Public License
8496 as published by the Free Software Foundation; either version 2
8497 of the License, or (at your option) any later version.
8498 .
8499 This program is distributed in the hope that it will be useful,
8500 but WITHOUT ANY WARRANTY; without even the implied warranty of
8501 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8502 GNU General Public License for more details.
8503 .
8504 You should have received a copy of the GNU General Public License
8505 along with this program; if not, write to the Free Software
8506 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
8507 .
8508 The complete text of the GNU General Public License
8509 can be found in /usr/share/common-licenses/GPL-2 file.
8510 The udev rules included into dmsetup are responsible for setting up the devices
8511in /dev/mapper and also provides some environment variables for use by later
8512rules:
8513
8514* DM_NAME
8515 Actual DM device's name
8516* DM_UUID
8517 UUID set for DM device (blank if not specified)
8518* DM_SUSPENDED
8519 Suspended state of DM device (0 or 1)
8520
8521Other device mapper using packages may define there own rules. For example lvm2,
8522see /usr/share/doc/lvm2/README.udev for further informations.
8523 This package was downloaded from:
8524
8525 ftp://sources.redhat.com/pub/lvm2/
8526
8527Copyright:
8528
8529 Copyright (C) 1997-2004 Sistina Software
8530 2004 Luca Berra
8531 2004-2009 Red Hat, Inc
8532 2005-2007 NEC Corporation
8533
8534License for libdevmapper, liblvm and the lvm tools lib:
8535
8536 This package is free software; you can redistribute it and/or
8537 modify it under the terms of the GNU Lesser General Public
8538 License version 2.1 as published by the Free Software Foundation.
8539
8540 This package is distributed in the hope that it will be useful,
8541 but WITHOUT ANY WARRANTY; without even the implied warranty of
8542 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
8543 Lesser General Public License for more details.
8544
8545 You should have received a copy of the GNU Lesser General Public
8546 License along with this package; if not, write to the Free Software
8547 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
8548
8549On Debian systems, the complete text of the GNU Lesser General
8550Public License v2.1 can be found in `/usr/share/common-licenses/LGPL-2.1'.
8551
8552License for the daemons, tools, tests and build system:
8553
8554 This package is free software; you can redistribute it and/or modify
8555 it under the terms of the GNU General Public License version 2 as
8556 published by the Free Software Foundation.
8557
8558 This package is distributed in the hope that it will be useful,
8559 but WITHOUT ANY WARRANTY; without even the implied warranty of
8560 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8561 GNU General Public License for more details.
8562
8563 You should have received a copy of the GNU General Public License
8564 along with this package; if not, write to the Free Software
8565 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
8566
8567On Debian systems, the complete text of the GNU General
8568Public License v2 can be found in `/usr/share/common-licenses/GPL-2'.
8569
8570The Debian packaging is:
8571
8572 Copyright (C) 2005-2009 Bastian Blank
8573
8574and is licensed under the GPL v2, see above.
8575 This package was debianized by Josselin Mouette <joss@debian.org> on
8576Thu, 24 May 2007 20:34:01 +0200
8577
8578It was downloaded from:
8579 git://gitorious.org/opensuse/art.git
8580
8581Copyright © 2007-2010 Novell, Inc.
8582
8583License for the renderpngs.py script:
8584
8585 This package is free software; you can redistribute it and/or modify
8586 it under the terms of the GNU General Public License as published by
8587 the Free Software Foundation; either version 2 of the License, or
8588 (at your option) any later version.
8589
8590 This package is distributed in the hope that it will be useful,
8591 but WITHOUT ANY WARRANTY; without even the implied warranty of
8592 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8593 GNU General Public License for more details.
8594
8595 You should have received a copy of the GNU General Public License
8596 along with this program. If not, see <http://www.gnu.org/licenses/>
8597
8598On Debian systems, the complete text of the GNU General
8599Public License version 2 can be found in
8600"/usr/share/common-licenses/GPL-2".
8601
8602License for the theme itself:
8603
8604 === Creative Commons Attribution-ShareAlike 3.0 Unported ===
8605
8606 THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS
8607 CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS
8608 PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE
8609 WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS
8610 PROHIBITED.
8611
8612 BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND
8613 AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS
8614 LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU
8615 THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF
8616 SUCH TERMS AND CONDITIONS.
8617
8618 1. Definitions
8619
8620 a. "Adaptation" means a work based upon the Work, or upon the Work
8621 and other pre-existing works, such as a translation, adaptation,
8622 derivative work, arrangement of music or other alterations of a
8623 literary or artistic work, or phonogram or performance and includes
8624 cinematographic adaptations or any other form in which the Work may
8625 be recast, transformed, or adapted including in any form
8626 recognizably derived from the original, except that a work that
8627 constitutes a Collection will not be considered an Adaptation for
8628 the purpose of this License. For the avoidance of doubt, where the
8629 Work is a musical work, performance or phonogram, the
8630 synchronization of the Work in timed-relation with a moving image
8631 ("synching") will be considered an Adaptation for the purpose of
8632 this License.
8633
8634 b. "Collection" means a collection of literary or artistic works,
8635 such as encyclopedias and anthologies, or performances, phonograms
8636 or broadcasts, or other works or subject matter other than works
8637 listed in Section 1(f) below, which, by reason of the selection and
8638 arrangement of their contents, constitute intellectual creations,
8639 in which the Work is included in its entirety in unmodified form
8640 along with one or more other contributions, each constituting
8641 separate and independent works in themselves, which together are
8642 assembled into a collective whole. A work that constitutes a
8643 Collection will not be considered an Adaptation (as defined below)
8644 for the purposes of this License.
8645
8646 c. "Creative Commons Compatible License" means a license that is
8647 listed at http://creativecommons.org/compatiblelicenses that has
8648 been approved by Creative Commons as being essentially equivalent
8649 to this License, including, at a minimum, because that license: (i)
8650 contains terms that have the same purpose, meaning and effect as
8651 the License Elements of this License; and, (ii) explicitly permits
8652 the relicensing of adaptations of works made available under that
8653 license under this License or a Creative Commons jurisdiction
8654 license with the same License Elements as this License.
8655
8656 d. "Distribute" means to make available to the public the original
8657 and copies of the Work or Adaptation, as appropriate, through sale
8658 or other transfer of ownership.
8659
8660 e. "License Elements" means the following high-level license
8661 attributes as selected by Licensor and indicated in the title of
8662 this License: Attribution, ShareAlike.
8663
8664 f. "Licensor" means the individual, individuals, entity or entities
8665 that offer(s) the Work under the terms of this License.
8666
8667 g. "Original Author" means, in the case of a literary or artistic
8668 work, the individual, individuals, entity or entities who created
8669 the Work or if no individual or entity can be identified, the
8670 publisher; and in addition (i) in the case of a performance the
8671 actors, singers, musicians, dancers, and other persons who act,
8672 sing, deliver, declaim, play in, interpret or otherwise perform
8673 literary or artistic works or expressions of folklore; (ii) in the
8674 case of a phonogram the producer being the person or legal entity
8675 who first fixes the sounds of a performance or other sounds; and,
8676 (iii) in the case of broadcasts, the organization that transmits
8677 the broadcast.
8678
8679 h. "Work" means the literary and/or artistic work offered under the
8680 terms of this License including without limitation any production
8681 in the literary, scientific and artistic domain, whatever may be
8682 the mode or form of its expression including digital form, such as
8683 a book, pamphlet and other writing; a lecture, address, sermon or
8684 other work of the same nature; a dramatic or dramatico-musical
8685 work; a choreographic work or entertainment in dumb show; a musical
8686 composition with or without words; a cinematographic work to which
8687 are assimilated works expressed by a process analogous to
8688 cinematography; a work of drawing, painting, architecture,
8689 sculpture, engraving or lithography; a photographic work to which
8690 are assimilated works expressed by a process analogous to
8691 photography; a work of applied art; an illustration, map, plan,
8692 sketch or three-dimensional work relative to geography, topography,
8693 architecture or science; a performance; a broadcast; a phonogram; a
8694 compilation of data to the extent it is protected as a
8695 copyrightable work; or a work performed by a variety or circus
8696 performer to the extent it is not otherwise considered a literary
8697 or artistic work.
8698
8699 i. "You" means an individual or entity exercising rights under this
8700 License who has not previously violated the terms of this License
8701 with respect to the Work, or who has received express permission
8702 from the Licensor to exercise rights under this License despite a
8703 previous violation.
8704
8705 j. "Publicly Perform" means to perform public recitations of the
8706 Work and to communicate to the public those public recitations, by
8707 any means or process, including by wire or wireless means or public
8708 digital performances; to make available to the public Works in such
8709 a way that members of the public may access these Works from a
8710 place and at a place individually chosen by them; to perform the
8711 Work to the public by any means or process and the communication to
8712 the public of the performances of the Work, including by public
8713 digital performance; to broadcast and rebroadcast the Work by any
8714 means including signs, sounds or images.
8715
8716 k. "Reproduce" means to make copies of the Work by any means
8717 including without limitation by sound or visual recordings and the
8718 right of fixation and reproducing fixations of the Work, including
8719 storage of a protected performance or phonogram in digital form or
8720 other electronic medium.
8721
8722 2. Fair Dealing Rights. Nothing in this License is intended to
8723 reduce, limit, or restrict any uses free from copyright or rights
8724 arising from limitations or exceptions that are provided for in
8725 connection with the copyright protection under copyright law or
8726 other applicable laws.
8727
8728 3. License Grant. Subject to the terms and conditions of this
8729 License, Licensor hereby grants You a worldwide, royalty-free,
8730 non-exclusive, perpetual (for the duration of the applicable
8731 copyright) license to exercise the rights in the Work as stated
8732 below:
8733
8734 a. to Reproduce the Work, to incorporate the Work into one or more
8735 Collections, and to Reproduce the Work as incorporated in the
8736 Collections;
8737
8738 b. to create and Reproduce Adaptations provided that any such
8739 Adaptation, including any translation in any medium, takes
8740 reasonable steps to clearly label, demarcate or otherwise identify
8741 that changes were made to the original Work. For example, a
8742 translation could be marked "The original work was translated from
8743 English to Spanish," or a modification could indicate "The original
8744 work has been modified.";
8745
8746 c. to Distribute and Publicly Perform the Work including as
8747 incorporated in Collections; and,
8748
8749 d. to Distribute and Publicly Perform Adaptations.
8750
8751 e. For the avoidance of doubt:
8752
8753 i. Non-waivable Compulsory License Schemes. In those jurisdictions
8754 in which the right to collect royalties through any statutory or
8755 compulsory licensing scheme cannot be waived, the Licensor
8756 reserves the exclusive right to collect such royalties for any
8757 exercise by You of the rights granted under this License;
8758
8759 ii. Waivable Compulsory License Schemes. In those jurisdictions in
8760 which the right to collect royalties through any statutory or
8761 compulsory licensing scheme can be waived, the Licensor waives the
8762 exclusive right to collect such royalties for any exercise by You
8763 of the rights granted under this License; and,
8764
8765 iii. Voluntary License Schemes. The Licensor waives the right to
8766 collect royalties, whether individually or, in the event that the
8767 Licensor is a member of a collecting society that administers
8768 voluntary licensing schemes, via that society, from any exercise
8769 by You of the rights granted under this License.
8770
8771 The above rights may be exercised in all media and formats whether
8772 now known or hereafter devised. The above rights include the right
8773 to make such modifications as are technically necessary to exercise
8774 the rights in other media and formats. Subject to Section 8(f), all
8775 rights not expressly granted by Licensor are hereby reserved.
8776
8777 4. Restrictions. The license granted in Section 3 above is expressly
8778 made subject to and limited by the following restrictions:
8779
8780 a. You may Distribute or Publicly Perform the Work only under the
8781 terms of this License. You must include a copy of, or the Uniform
8782 Resource Identifier (URI) for, this License with every copy of the
8783 Work You Distribute or Publicly Perform. You may not offer or
8784 impose any terms on the Work that restrict the terms of this
8785 License or the ability of the recipient of the Work to exercise the
8786 rights granted to that recipient under the terms of the License.
8787 You may not sublicense the Work. You must keep intact all notices
8788 that refer to this License and to the disclaimer of warranties with
8789 every copy of the Work You Distribute or Publicly Perform. When You
8790 Distribute or Publicly Perform the Work, You may not impose any
8791 effective technological measures on the Work that restrict the
8792 ability of a recipient of the Work from You to exercise the rights
8793 granted to that recipient under the terms of the License. This
8794 Section 4(a) applies to the Work as incorporated in a Collection,
8795 but this does not require the Collection apart from the Work itself
8796 to be made subject to the terms of this License. If You create a
8797 Collection, upon notice from any Licensor You must, to the extent
8798 practicable, remove from the Collection any credit as required by
8799 Section 4(c), as requested. If You create an Adaptation, upon
8800 notice from any Licensor You must, to the extent practicable,
8801 remove from the Adaptation any credit as required by Section 4(c),
8802 as requested.
8803
8804 b. You may Distribute or Publicly Perform an Adaptation only under
8805 the terms of: (i) this License; (ii) a later version of this
8806 License with the same License Elements as this License; (iii) a
8807 Creative Commons jurisdiction license (either this or a later
8808 license version) that contains the same License Elements as this
8809 License (e.g., Attribution-ShareAlike 3.0 US)); (iv) a Creative
8810 Commons Compatible License. If you license the Adaptation under one
8811 of the licenses mentioned in (iv), you must comply with the terms
8812 of that license. If you license the Adaptation under the terms of
8813 any of the licenses mentioned in (i), (ii) or (iii) (the
8814 "Applicable License"), you must comply with the terms of the
8815 Applicable License generally and the following provisions: (I) You
8816 must include a copy of, or the URI for, the Applicable License with
8817 every copy of each Adaptation You Distribute or Publicly Perform;
8818 (II) You may not offer or impose any terms on the Adaptation that
8819 restrict the terms of the Applicable License or the ability of the
8820 recipient of the Adaptation to exercise the rights granted to that
8821 recipient under the terms of the Applicable License; (III) You must
8822 keep intact all notices that refer to the Applicable License and to
8823 the disclaimer of warranties with every copy of the Work as
8824 included in the Adaptation You Distribute or Publicly Perform; (IV)
8825 when You Distribute or Publicly Perform the Adaptation, You may not
8826 impose any effective technological measures on the Adaptation that
8827 restrict the ability of a recipient of the Adaptation from You to
8828 exercise the rights granted to that recipient under the terms of
8829 the Applicable License. This Section 4(b) applies to the Adaptation
8830 as incorporated in a Collection, but this does not require the
8831 Collection apart from the Adaptation itself to be made subject to
8832 the terms of the Applicable License.
8833
8834 c. If You Distribute, or Publicly Perform the Work or any
8835 Adaptations or Collections, You must, unless a request has been
8836 made pursuant to Section 4(a), keep intact all copyright notices
8837 for the Work and provide, reasonable to the medium or means You are
8838 utilizing: (i) the name of the Original Author (or pseudonym, if
8839 applicable) if supplied, and/or if the Original Author and/or
8840 Licensor designate another party or parties (e.g., a sponsor
8841 institute, publishing entity, journal) for attribution
8842 ("Attribution Parties") in Licensor's copyright notice, terms of
8843 service or by other reasonable means, the name of such party or
8844 parties; (ii) the title of the Work if supplied; (iii) to the
8845 extent reasonably practicable, the URI, if any, that Licensor
8846 specifies to be associated with the Work, unless such URI does not
8847 refer to the copyright notice or licensing information for the
8848 Work; and (iv) , consistent with Ssection 3(b), in the case of an
8849 Adaptation, a credit identifying the use of the Work in the
8850 Adaptation (e.g., "French translation of the Work by Original
8851 Author," or "Screenplay based on original Work by Original
8852 Author"). The credit required by this Section 4(c) may be
8853 implemented in any reasonable manner; provided, however, that in
8854 the case of a Adaptation or Collection, at a minimum such credit
8855 will appear, if a credit for all contributing authors of the
8856 Adaptation or Collection appears, then as part of these credits and
8857 in a manner at least as prominent as the credits for the other
8858 contributing authors. For the avoidance of doubt, You may only use
8859 the credit required by this Section for the purpose of attribution
8860 in the manner set out above and, by exercising Your rights under
8861 this License, You may not implicitly or explicitly assert or imply
8862 any connection with, sponsorship or endorsement by the Original
8863 Author, Licensor and/or Attribution Parties, as appropriate, of You
8864 or Your use of the Work, without the separate, express prior
8865 written permission of the Original Author, Licensor and/or
8866 Attribution Parties.
8867
8868 d. Except as otherwise agreed in writing by the Licensor or as may
8869 be otherwise permitted by applicable law, if You Reproduce,
8870 Distribute or Publicly Perform the Work either by itself or as part
8871 of any Adaptations or Collections, You must not distort, mutilate,
8872 modify or take other derogatory action in relation to the Work
8873 which would be prejudicial to the Original Author's honor or
8874 reputation. Licensor agrees that in those jurisdictions (e.g.
8875 Japan), in which any exercise of the right granted in Section 3(b)
8876 of this License (the right to make Adaptations) would be deemed to
8877 be a distortion, mutilation, modification or other derogatory
8878 action prejudicial to the Original Author's honor and reputation,
8879 the Licensor will waive or not assert, as appropriate, this
8880 Section, to the fullest extent permitted by the applicable national
8881 law, to enable You to reasonably exercise Your right under Section
8882 3(b) of this License (right to make Adaptations) but not otherwise.
8883
8884 5. Representations, Warranties and Disclaimer
8885
8886 UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING,
8887 LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR
8888 WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED,
8889 STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF
8890 TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE,
8891 NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS,
8892 ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT
8893 DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF
8894 IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
8895
8896 6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY
8897 APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY
8898 LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR
8899 EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE
8900 WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
8901 DAMAGES.
8902
8903 7. Termination
8904
8905 a. This License and the rights granted hereunder will terminate
8906 automatically upon any breach by You of the terms of this License.
8907 Individuals or entities who have received Adaptations or
8908 Collections from You under this License, however, will not have
8909 their licenses terminated provided such individuals or entities
8910 remain in full compliance with those licenses. Sections 1, 2, 5, 6,
8911 7, and 8 will survive any termination of this License.
8912
8913 b. Subject to the above terms and conditions, the license granted
8914 here is perpetual (for the duration of the applicable copyright in
8915 the Work). Notwithstanding the above, Licensor reserves the right
8916 to release the Work under different license terms or to stop
8917 distributing the Work at any time; provided, however that any such
8918 election will not serve to withdraw this License (or any other
8919 license that has been, or is required to be, granted under the
8920 terms of this License), and this License will continue in full
8921 force and effect unless terminated as stated above.
8922
8923 8. Miscellaneous
8924
8925 a. Each time You Distribute or Publicly Perform the Work or a
8926 Collection, the Licensor offers to the recipient a license to the
8927 Work on the same terms and conditions as the license granted to You
8928 under this License.
8929
8930 b. Each time You Distribute or Publicly Perform an Adaptation,
8931 Licensor offers to the recipient a license to the original Work on
8932 the same terms and conditions as the license granted to You under
8933 this License.
8934
8935 c. If any provision of this License is invalid or unenforceable
8936 under applicable law, it shall not affect the validity or
8937 enforceability of the remainder of the terms of this License, and
8938 without further action by the parties to this agreement, such
8939 provision shall be reformed to the minimum extent necessary to make
8940 such provision valid and enforceable.
8941
8942 d. No term or provision of this License shall be deemed waived and
8943 no breach consented to unless such waiver or consent shall be in
8944 writing and signed by the party to be charged with such waiver or
8945 consent.
8946
8947 e. This License constitutes the entire agreement between the
8948 parties with respect to the Work licensed here. There are no
8949 understandings, agreements or representations with respect to the
8950 Work not specified here. Licensor shall not be bound by any
8951 additional provisions that may appear in any communication from
8952 You. This License may not be modified without the mutual written
8953 agreement of the Licensor and You.
8954
8955 f. The rights granted under, and the subject matter referenced, in
8956 this License were drafted utilizing the terminology of the Berne
8957 Convention for the Protection of Literary and Artistic Works (as
8958 amended on September 28, 1979), the Rome Convention of 1961, the
8959 WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms
8960 Treaty of 1996 and the Universal Copyright Convention (as revised
8961 on July 24, 1971). These rights and subject matter take effect in
8962 the relevant jurisdiction in which the License terms are sought to
8963 be enforced according to the corresponding provisions of the
8964 implementation of those treaty provisions in the applicable
8965 national law. If the standard suite of rights granted under
8966 applicable copyright law includes additional rights not granted
8967 under this License, such additional rights are deemed to be
8968 included in the License; this License is not intended to restrict
8969 the license of any rights under applicable law.
8970 è¬Ÿà ˆØ²ä»¦Ì‚ä…†Qå³ç›ä››çº–～áŠâ±Ÿé…엔즗㉨㥉㎶쵡囘딲ቪà©à ‘æ °ã‘€æ«ï¯¿î¾žë©œé›ë”¶ë«»â¢©ä¢‘⾠﫧ä®è¿·ì•—뜯ꊇ絬쨨氦ï¡æ¢½ë¹·ç¸©çºî±ê»šì”᜷韧à¯è¨—꾽ﱫ἟⼗춞ᒟ녅䔈å¿ìŠ…섕蚯ì”殮떗黟巵鯻칫準åµæ¶¶î··âž“꺯侊뺷궸뜶瘺î¿í‡ºã’¼î’疋ᗛᗕæªë—穛៎⻃鷴å·