]> pere.pagekite.me Git - homepage.git/blob - blog/tags/isenkram/isenkram.rss
c6fa75c82993c5b20bba5d1b8c13dc25be282582
[homepage.git] / blog / tags / isenkram / isenkram.rss
1 <?xml version="1.0" encoding="utf-8"?>
2 <rss version='2.0' xmlns:lj='http://www.livejournal.org/rss/lj/1.0/'>
3 <channel>
4 <title>Petter Reinholdtsen - Entries tagged isenkram</title>
5 <description>Entries tagged isenkram</description>
6 <link>http://www.hungry.com/~pere/blog/</link>
7
8
9 <item>
10 <title>What is the most supported MIME type in Debian in 2025?</title>
11 <link>http://www.hungry.com/~pere/blog/What_is_the_most_supported_MIME_type_in_Debian_in_2025_.html</link>
12 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/What_is_the_most_supported_MIME_type_in_Debian_in_2025_.html</guid>
13 <pubDate>Sat, 18 Jan 2025 10:30:00 +0100</pubDate>
14 <description>&lt;p&gt;&lt;a href=&quot;http://www.hungry.com/~pere/blog/What_is_the_most_supported_MIME_type_in_Debian_in_2018_.html&quot;&gt;Seven&lt;/a&gt;
15 and
16 &lt;a href=&quot;http://www.hungry.com/~pere/blog/What_is_the_most_supported_MIME_type_in_Debian_.html&quot;&gt;twelve&lt;/a&gt;
17 years ago, I measured what the most supported MIME type in Debian
18 was&lt;/a&gt;, first by analysing the desktop files in all packages in the
19 archive, then by analysing the DEP-11 AppStream data set. I guess it
20 is time to repeat the measurement, only for unstable as last time:&lt;/p&gt;
21
22 &lt;p&gt;&lt;strong&gt;Debian Unstable:&lt;/strong&gt;&lt;/p&gt;
23
24 &lt;pre&gt;
25 count MIME type
26 ----- -----------------------
27 63 image/png
28 63 image/jpeg
29 57 image/tiff
30 54 image/gif
31 51 image/bmp
32 50 audio/mpeg
33 48 text/plain
34 42 audio/x-mp3
35 40 application/ogg
36 39 audio/x-wav
37 39 audio/x-flac
38 36 audio/x-vorbis+ogg
39 35 audio/x-mpeg
40 34 audio/x-mpegurl
41 34 audio/ogg
42 33 application/x-ogg
43 32 audio/mp4
44 31 audio/x-scpls
45 31 application/pdf
46 29 audio/x-ms-wma
47 &lt;/pre&gt;
48
49 &lt;p&gt;The list was created like this using a sid chroot:&lt;/p&gt;
50
51 &lt;pre&gt;
52 cat /var/lib/apt/lists/*sid*_dep11_Components-amd64.yml.gz | \
53 zcat | awk &#39;/^ - \S+\/\S+$/ {print $2 }&#39; | sort | \
54 uniq -c | sort -nr | head -20
55 &lt;/pre&gt;
56
57 &lt;p&gt;It is nice to see that the same number of packages now support PNG
58 and JPEG. Last time JPEG had more support than PNG. Most of the MIME
59 types are known to me, but the &#39;audio/x-scpls&#39; one I have no idea what
60 represent, except it being an audio format. To find the packages
61 claiming support for this format, the appstreamcli command from the
62 appstream package can be used:
63
64 &lt;pre&gt;
65 % appstreamcli what-provides mediatype audio/x-scpls | grep Package: | sort -u
66 Package: alsaplayer-common
67 Package: amarok
68 Package: audacious
69 Package: brasero
70 Package: celluloid
71 Package: clapper
72 Package: clementine
73 Package: cynthiune.app
74 Package: elisa
75 Package: gtranscribe
76 Package: kaffeine
77 Package: kmplayer
78 Package: kylin-burner
79 Package: lollypop
80 Package: mediaconch-gui
81 Package: mediainfo-gui
82 Package: mplayer-gui
83 Package: mpv
84 Package: mystiq
85 Package: parlatype
86 Package: parole
87 Package: pragha
88 Package: qmmp
89 Package: rhythmbox
90 Package: sayonara
91 Package: shotcut
92 Package: smplayer
93 Package: soundconverter
94 Package: strawberry
95 Package: syncplay
96 Package: vlc
97 %
98 &lt;/pre&gt;
99
100 &lt;p&gt;Look like several video and auto tools understand the format.
101 Similarly one can check out the number of packages supporting the STL
102 format commonly used for 3D printing:&lt;/p&gt;
103
104 &lt;pre&gt;
105 % appstreamcli what-provides mediatype model/stl | grep Package: | sort -u
106 Package: cura
107 Package: freecad
108 Package: open3d-viewer
109 %
110 &lt;/pre&gt;
111
112 &lt;p&gt;How strange the
113 &lt;a href=&quot;https://tracker.debian.org/pkg/slic3r&quot;&gt;slic3r&lt;/a&gt; and
114 &lt;a href=&quot;https://tracker.debian.org/pkg/slic3r-prusa&quot;&gt;prusa-slicer&lt;/a&gt;
115 packages do not support STL. Perhaps just missing package metadata?
116 Luckily the amount of package metadata in Debian is getting better,
117 and hopefully this way of locating relevant packages for any file
118 format will be the preferred one soon.
119
120 &lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
121 activities, please send Bitcoin donations to my address
122 &lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
123 </description>
124 </item>
125
126 <item>
127 <title>RAID status from LSI Megaraid controllers in Debian</title>
128 <link>http://www.hungry.com/~pere/blog/RAID_status_from_LSI_Megaraid_controllers_in_Debian.html</link>
129 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/RAID_status_from_LSI_Megaraid_controllers_in_Debian.html</guid>
130 <pubDate>Wed, 17 Apr 2024 17:00:00 +0200</pubDate>
131 <description>&lt;p&gt;I am happy to report that
132 &lt;a href=&quot;https://github.com/namiltd/megactl&quot;&gt;the megactl package&lt;/a&gt;,
133 useful to fetch RAID status when using the LSI Megaraid controller,
134 now is available in Debian. It passed NEW a few days ago, and is now
135 &lt;a href=&quot;https://tracker.debian.org/pkg/megactl&quot;&gt;available in
136 unstable&lt;/a&gt;, and probably showing up in testing in a weeks time. The
137 new version should provide Appstream hardware mapping and should
138 integrate nicely with isenkram.&lt;/p&gt;
139
140 &lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
141 activities, please send Bitcoin donations to my address
142 &lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
143
144 </description>
145 </item>
146
147 <item>
148 <title>RAID status from LSI Megaraid controllers using free software</title>
149 <link>http://www.hungry.com/~pere/blog/RAID_status_from_LSI_Megaraid_controllers_using_free_software.html</link>
150 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/RAID_status_from_LSI_Megaraid_controllers_using_free_software.html</guid>
151 <pubDate>Sun, 3 Mar 2024 22:40:00 +0100</pubDate>
152 <description>&lt;p&gt;The last few days I have revisited RAID setup using the LSI
153 Megaraid controller. These are a family of controllers called PERC by
154 Dell, and is present in several old PowerEdge servers, and I recently
155 got my hands on one of these. I had forgotten how to handle this RAID
156 controller in Debian, so I had to take a peek in the
157 &lt;a href=&quot;https://wiki.debian.org/LinuxRaidForAdmins&quot;&gt;Debian wiki page
158 &quot;Linux and Hardware RAID: an administrator&#39;s summary&quot;&lt;/a&gt; to remember
159 what kind of software is available to configure and monitor the disks
160 and controller. I prefer Free Software alternatives to proprietary
161 tools, as the later tend to fall into disarray once the manufacturer
162 loose interest, and often do not work with newer Linux Distributions.
163 Sadly there is no free software tool to configure the RAID setup, only
164 to monitor it. RAID can provide improved reliability and resilience in
165 a storage solution, but only if it is being regularly checked and any
166 broken disks are being replaced in time. I thus want to ensure some
167 automatic monitoring is available.&lt;/p&gt;
168
169 &lt;p&gt;In the discovery process, I came across a old free software tool to
170 monitor PERC2, PERC3, PERC4 and PERC5 controllers, which to my
171 surprise is not present in debian. To help change that I created a
172 &lt;a href=&quot;https://bugs.debian.org/1065322&quot;&gt;request for packaging of the
173 megactl package&lt;/a&gt;, and tried to track down a usable version.
174 &lt;a href=&quot;https://sourceforge.net/p/megactl/&quot;&gt;The original project
175 site&lt;/a&gt; is on Sourceforge, but as far as I can tell that project has
176 been dead for more than 15 years. I managed to find a
177 &lt;a href=&quot;https://github.com/hmage/megactl&quot;&gt;more recent fork on
178 github&lt;/a&gt; from user hmage, but it is unclear to me if this is still
179 being maintained. It has not seen much improvements since 2016. A
180 &lt;a href=&quot;https://github.com/namiltd/megactl&quot;&gt;more up to date
181 edition&lt;/a&gt; is a git fork from the original github fork by user
182 namiltd, and this newer fork seem a lot more promising. The owner of
183 this github repository has replied to change proposals within hours,
184 and had already added some improvements and support for more hardware.
185 Sadly he is reluctant to commit to maintaining the tool and stated in
186 &lt;a href=&quot;https://github.com/namiltd/megactl/pull/1&quot;&gt;my first pull
187 request&lt;/A&gt; that he think a new release should be made based on the
188 git repository owned by hmage. I perfectly understand this
189 reluctance, as I feel the same about maintaining yet another package
190 in Debian when I barely have time to take care of the ones I already
191 maintain, but do not really have high hopes that hmage will have time
192 to spend on it and hope namiltd will change his mind.&lt;/p&gt;
193
194 &lt;p&gt;In any case, I created
195 &lt;a href=&quot;https://salsa.debian.org/debian/megactl&quot;&gt;a draft package&lt;/a&gt;
196 based on the namiltd edition and put it under the debian group on
197 salsa.debian.org. If you own a Dell PowerEdge server with one of the
198 PERC controllers, or any other RAID controller using the megaraid or
199 megaraid_sas Linux kernel modules, you might want to check it out. If
200 enough people are interested, perhaps the package will make it into
201 the Debian archive.&lt;/p&gt;
202
203 &lt;p&gt;There are two tools provided, megactl for the megaraid Linux kernel
204 module, and megasasctl for the megaraid_sas Linux kernel module. The
205 simple output from the command on one of my machines look like this
206 (yes, I know some of the disks have problems. :).&lt;/p&gt;
207
208 &lt;pre&gt;
209 # megasasctl
210 a0 PERC H730 Mini encl:1 ldrv:2 batt:good
211 a0d0 558GiB RAID 1 1x2 optimal
212 a0d1 3067GiB RAID 0 1x11 optimal
213 a0e32s0 558GiB a0d0 online errs: media:0 other:19
214 a0e32s1 279GiB a0d1 online
215 a0e32s2 279GiB a0d1 online
216 a0e32s3 279GiB a0d1 online
217 a0e32s4 279GiB a0d1 online
218 a0e32s5 279GiB a0d1 online
219 a0e32s6 279GiB a0d1 online
220 a0e32s8 558GiB a0d0 online errs: media:0 other:17
221 a0e32s9 279GiB a0d1 online
222 a0e32s10 279GiB a0d1 online
223 a0e32s11 279GiB a0d1 online
224 a0e32s12 279GiB a0d1 online
225 a0e32s13 279GiB a0d1 online
226
227 #
228 &lt;/pre&gt;
229
230 &lt;p&gt;In addition to displaying a simple status report, it can also test
231 individual drives and print the various event logs. Perhaps you too
232 find it useful?&lt;/p&gt;
233
234 &lt;p&gt;In the packaging process I provided some patches upstream to
235 improve installation and ensure
236 &lt;ahref=&quot;https://github.com/namiltd/megactl/pull/2&quot;&gt;a Appstream
237 metainfo file is provided&lt;/a&gt; to list all supported HW, to allow
238 &lt;a href=&quot;https://tracker.debian.org/isenkram&quot;&gt;isenkram&lt;/a&gt; to propose
239 the package on all servers with a relevant PCI card.&lt;/p&gt;
240
241 &lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
242 activities, please send Bitcoin donations to my address
243 &lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
244
245 </description>
246 </item>
247
248 <item>
249 <title>What is the most supported MIME type in Debian in 2018?</title>
250 <link>http://www.hungry.com/~pere/blog/What_is_the_most_supported_MIME_type_in_Debian_in_2018_.html</link>
251 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/What_is_the_most_supported_MIME_type_in_Debian_in_2018_.html</guid>
252 <pubDate>Mon, 9 Jul 2018 08:05:00 +0200</pubDate>
253 <description>&lt;p&gt;Five years ago,
254 &lt;a href=&quot;http://www.hungry.com/~pere/blog/What_is_the_most_supported_MIME_type_in_Debian_.html&quot;&gt;I
255 measured what the most supported MIME type in Debian was&lt;/a&gt;, by
256 analysing the desktop files in all packages in the archive. Since
257 then, the DEP-11 AppStream system has been put into production, making
258 the task a lot easier. This made me want to repeat the measurement,
259 to see how much things changed. Here are the new numbers, for
260 unstable only this time:
261
262 &lt;p&gt;&lt;strong&gt;Debian Unstable:&lt;/strong&gt;&lt;/p&gt;
263
264 &lt;pre&gt;
265 count MIME type
266 ----- -----------------------
267 56 image/jpeg
268 55 image/png
269 49 image/tiff
270 48 image/gif
271 39 image/bmp
272 38 text/plain
273 37 audio/mpeg
274 34 application/ogg
275 33 audio/x-flac
276 32 audio/x-mp3
277 30 audio/x-wav
278 30 audio/x-vorbis+ogg
279 29 image/x-portable-pixmap
280 27 inode/directory
281 27 image/x-portable-bitmap
282 27 audio/x-mpeg
283 26 application/x-ogg
284 25 audio/x-mpegurl
285 25 audio/ogg
286 24 text/html
287 &lt;/pre&gt;
288
289 &lt;p&gt;The list was created like this using a sid chroot: &quot;cat
290 /var/lib/apt/lists/*sid*_dep11_Components-amd64.yml.gz| zcat | awk &#39;/^
291 - \S+\/\S+$/ {print $2 }&#39; | sort | uniq -c | sort -nr | head -20&quot;&lt;/p&gt;
292
293 &lt;p&gt;It is interesting to see how image formats have passed text/plain
294 as the most announced supported MIME type. These days, thanks to the
295 AppStream system, if you run into a file format you do not know, and
296 want to figure out which packages support the format, you can find the
297 MIME type of the file using &quot;file --mime &amp;lt;filename&amp;gt;&quot;, and then
298 look up all packages announcing support for this format in their
299 AppStream metadata (XML or .desktop file) using &quot;appstreamcli
300 what-provides mimetype &amp;lt;mime-type&amp;gt;. For example if you, like
301 me, want to know which packages support inode/directory, you can get a
302 list like this:&lt;/p&gt;
303
304 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
305 % appstreamcli what-provides mimetype inode/directory | grep Package: | sort
306 Package: anjuta
307 Package: audacious
308 Package: baobab
309 Package: cervisia
310 Package: chirp
311 Package: dolphin
312 Package: doublecmd-common
313 Package: easytag
314 Package: enlightenment
315 Package: ephoto
316 Package: filelight
317 Package: gwenview
318 Package: k4dirstat
319 Package: kaffeine
320 Package: kdesvn
321 Package: kid3
322 Package: kid3-qt
323 Package: nautilus
324 Package: nemo
325 Package: pcmanfm
326 Package: pcmanfm-qt
327 Package: qweborf
328 Package: ranger
329 Package: sirikali
330 Package: spacefm
331 Package: spacefm
332 Package: vifm
333 %
334 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
335
336 &lt;p&gt;Using the same method, I can quickly discover that the Sketchup file
337 format is not yet supported by any package in Debian:&lt;/p&gt;
338
339 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
340 % appstreamcli what-provides mimetype application/vnd.sketchup.skp
341 Could not find component providing &#39;mimetype::application/vnd.sketchup.skp&#39;.
342 %
343 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
344
345 &lt;p&gt;Yesterday I used it to figure out which packages support the STL 3D
346 format:&lt;/p&gt;
347
348 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
349 % appstreamcli what-provides mimetype application/sla|grep Package
350 Package: cura
351 Package: meshlab
352 Package: printrun
353 %
354 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
355
356 &lt;p&gt;PS: A new version of Cura was uploaded to Debian yesterday.&lt;/p&gt;
357
358 &lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
359 activities, please send Bitcoin donations to my address
360 &lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
361 </description>
362 </item>
363
364 <item>
365 <title>Appstream just learned how to map hardware to packages too!</title>
366 <link>http://www.hungry.com/~pere/blog/Appstream_just_learned_how_to_map_hardware_to_packages_too_.html</link>
367 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Appstream_just_learned_how_to_map_hardware_to_packages_too_.html</guid>
368 <pubDate>Fri, 23 Dec 2016 10:30:00 +0100</pubDate>
369 <description>&lt;p&gt;I received a very nice Christmas present today. As my regular
370 readers probably know, I have been working on the
371 &lt;a href=&quot;http://packages.qa.debian.org/isenkram&quot;&gt;the Isenkram
372 system&lt;/a&gt; for many years. The goal of the Isenkram system is to make
373 it easier for users to figure out what to install to get a given piece
374 of hardware to work in Debian, and a key part of this system is a way
375 to map hardware to packages. Isenkram have its own mapping database,
376 and also uses data provided by each package using the AppStream
377 metadata format. And today,
378 &lt;a href=&quot;https://tracker.debian.org/pkg/appstream&quot;&gt;AppStream&lt;/a&gt; in
379 Debian learned to look up hardware the same way Isenkram is doing it,
380 ie using fnmatch():&lt;/p&gt;
381
382 &lt;p&gt;&lt;pre&gt;
383 % appstreamcli what-provides modalias \
384 usb:v1130p0202d0100dc00dsc00dp00ic03isc00ip00in00
385 Identifier: pymissile [generic]
386 Name: pymissile
387 Summary: Control original Striker USB Missile Launcher
388 Package: pymissile
389 % appstreamcli what-provides modalias usb:v0694p0002d0000
390 Identifier: libnxt [generic]
391 Name: libnxt
392 Summary: utility library for talking to the LEGO Mindstorms NXT brick
393 Package: libnxt
394 ---
395 Identifier: t2n [generic]
396 Name: t2n
397 Summary: Simple command-line tool for Lego NXT
398 Package: t2n
399 ---
400 Identifier: python-nxt [generic]
401 Name: python-nxt
402 Summary: Python driver/interface/wrapper for the Lego Mindstorms NXT robot
403 Package: python-nxt
404 ---
405 Identifier: nbc [generic]
406 Name: nbc
407 Summary: C compiler for LEGO Mindstorms NXT bricks
408 Package: nbc
409 %
410 &lt;/pre&gt;&lt;/p&gt;
411
412 &lt;p&gt;A similar query can be done using the combined AppStream and
413 Isenkram databases using the isenkram-lookup tool:&lt;/p&gt;
414
415 &lt;p&gt;&lt;pre&gt;
416 % isenkram-lookup usb:v1130p0202d0100dc00dsc00dp00ic03isc00ip00in00
417 pymissile
418 % isenkram-lookup usb:v0694p0002d0000
419 libnxt
420 nbc
421 python-nxt
422 t2n
423 %
424 &lt;/pre&gt;&lt;/p&gt;
425
426 &lt;p&gt;You can find modalias values relevant for your machine using
427 &lt;tt&gt;cat $(find /sys/devices/ -name modalias)&lt;/tt&gt;.
428
429 &lt;p&gt;If you want to make this system a success and help Debian users
430 make the most of the hardware they have, please help
431 &lt;a href=&quot;https://wiki.debian.org/AppStream/Guidelines&quot;&gt;add AppStream
432 metadata for your package following the guidelines&lt;/a&gt; documented in
433 the wiki. So far only 11 packages provide such information, among the
434 several hundred hardware specific packages in Debian. The Isenkram
435 database on the other hand contain 101 packages, mostly related to USB
436 dongles. Most of the packages with hardware mapping in AppStream are
437 LEGO Mindstorms related, because I have, as part of my involvement in
438 &lt;a href=&quot;https://wiki.debian.org/LegoDesigners&quot;&gt;the Debian LEGO
439 team&lt;/a&gt; given priority to making sure LEGO users get proposed the
440 complete set of packages in Debian for that particular hardware. The
441 team also got a nice Christmas present today. The
442 &lt;a href=&quot;https://tracker.debian.org/pkg/nxt-firmware&quot;&gt;nxt-firmware
443 package&lt;/a&gt; made it into Debian. With this package in place, it is
444 now possible to use the LEGO Mindstorms NXT unit with only free
445 software, as the nxt-firmware package contain the source and firmware
446 binaries for the NXT brick.&lt;/p&gt;
447
448 &lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
449 activities, please send Bitcoin donations to my address
450 &lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
451 </description>
452 </item>
453
454 <item>
455 <title>Isenkram updated with a lot more hardware-package mappings</title>
456 <link>http://www.hungry.com/~pere/blog/Isenkram_updated_with_a_lot_more_hardware_package_mappings.html</link>
457 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Isenkram_updated_with_a_lot_more_hardware_package_mappings.html</guid>
458 <pubDate>Tue, 20 Dec 2016 11:55:00 +0100</pubDate>
459 <description>&lt;p&gt;&lt;a href=&quot;http://packages.qa.debian.org/isenkram&quot;&gt;The Isenkram
460 system&lt;/a&gt; I wrote two years ago to make it easier in Debian to find
461 and install packages to get your hardware dongles to work, is still
462 going strong. It is a system to look up the hardware present on or
463 connected to the current system, and map the hardware to Debian
464 packages. It can either be done using the tools in isenkram-cli or
465 using the user space daemon in the isenkram package. The latter will
466 notify you, when inserting new hardware, about what packages to
467 install to get the dongle working. It will even provide a button to
468 click on to ask packagekit to install the packages.&lt;/p&gt;
469
470 &lt;p&gt;Here is an command line example from my Thinkpad laptop:&lt;/p&gt;
471
472 &lt;p&gt;&lt;pre&gt;
473 % isenkram-lookup
474 bluez
475 cheese
476 ethtool
477 fprintd
478 fprintd-demo
479 gkrellm-thinkbat
480 hdapsd
481 libpam-fprintd
482 pidgin-blinklight
483 thinkfan
484 tlp
485 tp-smapi-dkms
486 tp-smapi-source
487 tpb
488 %
489 &lt;/pre&gt;&lt;/p&gt;
490
491 &lt;p&gt;It can also list the firware package providing firmware requested
492 by the load kernel modules, which in my case is an empty list because
493 I have all the firmware my machine need:
494
495 &lt;p&gt;&lt;pre&gt;
496 % /usr/sbin/isenkram-autoinstall-firmware -l
497 info: did not find any firmware files requested by loaded kernel modules. exiting
498 %
499 &lt;/pre&gt;&lt;/p&gt;
500
501 &lt;p&gt;The last few days I had a look at several of the around 250
502 packages in Debian with udev rules. These seem like good candidates
503 to install when a given hardware dongle is inserted, and I found
504 several that should be proposed by isenkram. I have not had time to
505 check all of them, but am happy to report that now there are 97
506 packages packages mapped to hardware by Isenkram. 11 of these
507 packages provide hardware mapping using AppStream, while the rest are
508 listed in the modaliases file provided in isenkram.&lt;/p&gt;
509
510 &lt;p&gt;These are the packages with hardware mappings at the moment. The
511 &lt;strong&gt;marked packages&lt;/strong&gt; are also announcing their hardware
512 support using AppStream, for everyone to use:&lt;/p&gt;
513
514 &lt;p&gt;air-quality-sensor, alsa-firmware-loaders, argyll,
515 &lt;strong&gt;array-info&lt;/strong&gt;, avarice, avrdude, b43-fwcutter,
516 bit-babbler, bluez, bluez-firmware, &lt;strong&gt;brltty&lt;/strong&gt;,
517 &lt;strong&gt;broadcom-sta-dkms&lt;/strong&gt;, calibre, cgminer, cheese, colord,
518 &lt;strong&gt;colorhug-client&lt;/strong&gt;, dahdi-firmware-nonfree, dahdi-linux,
519 dfu-util, dolphin-emu, ekeyd, ethtool, firmware-ipw2x00, fprintd,
520 fprintd-demo, &lt;strong&gt;galileo&lt;/strong&gt;, gkrellm-thinkbat, gphoto2,
521 gpsbabel, gpsbabel-gui, gpsman, gpstrans, gqrx-sdr, gr-fcdproplus,
522 gr-osmosdr, gtkpod, hackrf, hdapsd, hdmi2usb-udev, hpijs-ppds, hplip,
523 ipw3945-source, ipw3945d, kde-config-tablet, kinect-audio-setup,
524 &lt;strong&gt;libnxt&lt;/strong&gt;, libpam-fprintd, &lt;strong&gt;lomoco&lt;/strong&gt;,
525 madwimax, minidisc-utils, mkgmap, msi-keyboard, mtkbabel,
526 &lt;strong&gt;nbc&lt;/strong&gt;, &lt;strong&gt;nqc&lt;/strong&gt;, nut-hal-drivers, ola,
527 open-vm-toolbox, open-vm-tools, openambit, pcgminer, pcmciautils,
528 pcscd, pidgin-blinklight, printer-driver-splix,
529 &lt;strong&gt;pymissile&lt;/strong&gt;, python-nxt, qlandkartegt,
530 qlandkartegt-garmin, rosegarden, rt2x00-source, sispmctl,
531 soapysdr-module-hackrf, solaar, squeak-plugins-scratch, sunxi-tools,
532 &lt;strong&gt;t2n&lt;/strong&gt;, thinkfan, thinkfinger-tools, tlp, tp-smapi-dkms,
533 tp-smapi-source, tpb, tucnak, uhd-host, usbmuxd, viking,
534 virtualbox-ose-guest-x11, w1retap, xawtv, xserver-xorg-input-vmmouse,
535 xserver-xorg-input-wacom, xserver-xorg-video-qxl,
536 xserver-xorg-video-vmware, yubikey-personalization and
537 zd1211-firmware&lt;/p&gt;
538
539 &lt;p&gt;If you know of other packages, please let me know with a wishlist
540 bug report against the isenkram-cli package, and ask the package
541 maintainer to
542 &lt;a href=&quot;https://wiki.debian.org/AppStream/Guidelines&quot;&gt;add AppStream
543 metadata according to the guidelines&lt;/a&gt; to provide the information
544 for everyone. In time, I hope to get rid of the isenkram specific
545 hardware mapping and depend exclusively on AppStream.&lt;/p&gt;
546
547 &lt;p&gt;Note, the AppStream metadata for broadcom-sta-dkms is matching too
548 much hardware, and suggest that the package with with any ethernet
549 card. See &lt;a href=&quot;http://bugs.debian.org/838735&quot;&gt;bug #838735&lt;/a&gt; for
550 the details. I hope the maintainer find time to address it soon. In
551 the mean time I provide an override in isenkram.&lt;/p&gt;
552 </description>
553 </item>
554
555 <item>
556 <title>Isenkram, Appstream and udev make life as a LEGO builder easier</title>
557 <link>http://www.hungry.com/~pere/blog/Isenkram__Appstream_and_udev_make_life_as_a_LEGO_builder_easier.html</link>
558 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Isenkram__Appstream_and_udev_make_life_as_a_LEGO_builder_easier.html</guid>
559 <pubDate>Fri, 7 Oct 2016 09:50:00 +0200</pubDate>
560 <description>&lt;p&gt;&lt;a href=&quot;http://packages.qa.debian.org/isenkram&quot;&gt;The Isenkram
561 system&lt;/a&gt; provide a practical and easy way to figure out which
562 packages support the hardware in a given machine. The command line
563 tool &lt;tt&gt;isenkram-lookup&lt;/tt&gt; and the tasksel options provide a
564 convenient way to list and install packages relevant for the current
565 hardware during system installation, both user space packages and
566 firmware packages. The GUI background daemon on the other hand provide
567 a pop-up proposing to install packages when a new dongle is inserted
568 while using the computer. For example, if you plug in a smart card
569 reader, the system will ask if you want to install &lt;tt&gt;pcscd&lt;/tt&gt; if
570 that package isn&#39;t already installed, and if you plug in a USB video
571 camera the system will ask if you want to install &lt;tt&gt;cheese&lt;/tt&gt; if
572 cheese is currently missing. This already work just fine.&lt;/p&gt;
573
574 &lt;p&gt;But Isenkram depend on a database mapping from hardware IDs to
575 package names. When I started no such database existed in Debian, so
576 I made my own data set and included it with the isenkram package and
577 made isenkram fetch the latest version of this database from git using
578 http. This way the isenkram users would get updated package proposals
579 as soon as I learned more about hardware related packages.&lt;/p&gt;
580
581 &lt;p&gt;The hardware is identified using modalias strings. The modalias
582 design is from the Linux kernel where most hardware descriptors are
583 made available as a strings that can be matched using filename style
584 globbing. It handle USB, PCI, DMI and a lot of other hardware related
585 identifiers.&lt;/p&gt;
586
587 &lt;p&gt;The downside to the Isenkram specific database is that there is no
588 information about relevant distribution / Debian version, making
589 isenkram propose obsolete packages too. But along came AppStream, a
590 cross distribution mechanism to store and collect metadata about
591 software packages. When I heard about the proposal, I contacted the
592 people involved and suggested to add a hardware matching rule using
593 modalias strings in the specification, to be able to use AppStream for
594 mapping hardware to packages. This idea was accepted and AppStream is
595 now a great way for a package to announce the hardware it support in a
596 distribution neutral way. I wrote
597 &lt;a href=&quot;http://www.hungry.com/~pere/blog/Using_appstream_with_isenkram_to_install_hardware_related_packages_in_Debian.html&quot;&gt;a
598 recipe on how to add such meta-information&lt;/a&gt; in a blog post last
599 December. If you have a hardware related package in Debian, please
600 announce the relevant hardware IDs using AppStream.&lt;/p&gt;
601
602 &lt;p&gt;In Debian, almost all packages that can talk to a LEGO Mindestorms
603 RCX or NXT unit, announce this support using AppStream. The effect is
604 that when you insert such LEGO robot controller into your Debian
605 machine, Isenkram will propose to install the packages needed to get
606 it working. The intention is that this should allow the local user to
607 start programming his robot controller right away without having to
608 guess what packages to use or which permissions to fix.&lt;/p&gt;
609
610 &lt;p&gt;But when I sat down with my son the other day to program our NXT
611 unit using his Debian Stretch computer, I discovered something
612 annoying. The local console user (ie my son) did not get access to
613 the USB device for programming the unit. This used to work, but no
614 longer in Jessie and Stretch. After some investigation and asking
615 around on #debian-devel, I discovered that this was because udev had
616 changed the mechanism used to grant access to local devices. The
617 ConsoleKit mechanism from &lt;tt&gt;/lib/udev/rules.d/70-udev-acl.rules&lt;/tt&gt;
618 no longer applied, because LDAP users no longer was added to the
619 plugdev group during login. Michael Biebl told me that this method
620 was obsolete and the new method used ACLs instead. This was good
621 news, as the plugdev mechanism is a mess when using a remote user
622 directory like LDAP. Using ACLs would make sure a user lost device
623 access when she logged out, even if the user left behind a background
624 process which would retain the plugdev membership with the ConsoleKit
625 setup. Armed with this knowledge I moved on to fix the access problem
626 for the LEGO Mindstorms related packages.&lt;/p&gt;
627
628 &lt;p&gt;The new system uses a udev tag, &#39;uaccess&#39;. It can either be
629 applied directly for a device, or is applied in
630 /lib/udev/rules.d/70-uaccess.rules for classes of devices. As the
631 LEGO Mindstorms udev rules did not have a class, I decided to add the
632 tag directly in the udev rules files included in the packages. Here
633 is one example. For the nqc C compiler for the RCX, the
634 &lt;tt&gt;/lib/udev/rules.d/60-nqc.rules&lt;/tt&gt; file now look like this:
635
636 &lt;p&gt;&lt;pre&gt;
637 SUBSYSTEM==&quot;usb&quot;, ACTION==&quot;add&quot;, ATTR{idVendor}==&quot;0694&quot;, ATTR{idProduct}==&quot;0001&quot;, \
638 SYMLINK+=&quot;rcx-%k&quot;, TAG+=&quot;uaccess&quot;
639 &lt;/pre&gt;&lt;/p&gt;
640
641 &lt;p&gt;The key part is the &#39;TAG+=&quot;uaccess&quot;&#39; at the end. I suspect all
642 packages using plugdev in their /lib/udev/rules.d/ files should be
643 changed to use this tag (either directly or indirectly via
644 &lt;tt&gt;70-uaccess.rules&lt;/tt&gt;). Perhaps a lintian check should be created
645 to detect this?&lt;/p&gt;
646
647 &lt;p&gt;I&#39;ve been unable to find good documentation on the uaccess feature.
648 It is unclear to me if the uaccess tag is an internal implementation
649 detail like the udev-acl tag used by
650 &lt;tt&gt;/lib/udev/rules.d/70-udev-acl.rules&lt;/tt&gt;. If it is, I guess the
651 indirect method is the preferred way. Michael
652 &lt;a href=&quot;https://github.com/systemd/systemd/issues/4288&quot;&gt;asked for more
653 documentation from the systemd project&lt;/a&gt; and I hope it will make
654 this clearer. For now I use the generic classes when they exist and
655 is already handled by &lt;tt&gt;70-uaccess.rules&lt;/tt&gt;, and add the tag
656 directly if no such class exist.&lt;/p&gt;
657
658 &lt;p&gt;To learn more about the isenkram system, please check out
659 &lt;a href=&quot;http://www.hungry.com/~pere/blog/tags/isenkram/&quot;&gt;my
660 blog posts tagged isenkram&lt;/a&gt;.&lt;/p&gt;
661
662 &lt;p&gt;To help out making life for LEGO constructors in Debian easier,
663 please join us on our IRC channel
664 &lt;a href=&quot;irc://irc.debian.org/%23debian-lego&quot;&gt;#debian-lego&lt;/a&gt; and join
665 the &lt;a href=&quot;https://alioth.debian.org/projects/debian-lego/&quot;&gt;Debian
666 LEGO team&lt;/a&gt; in the Alioth project we created yesterday. A mailing
667 list is not yet created, but we are working on it. :)&lt;/p&gt;
668
669 &lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
670 activities, please send Bitcoin donations to my address
671 &lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
672 </description>
673 </item>
674
675 <item>
676 <title>Isenkram with PackageKit support - new version 0.23 available in Debian unstable</title>
677 <link>http://www.hungry.com/~pere/blog/Isenkram_with_PackageKit_support___new_version_0_23_available_in_Debian_unstable.html</link>
678 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Isenkram_with_PackageKit_support___new_version_0_23_available_in_Debian_unstable.html</guid>
679 <pubDate>Wed, 25 May 2016 10:20:00 +0200</pubDate>
680 <description>&lt;p&gt;&lt;a href=&quot;https://tracker.debian.org/pkg/isenkram&quot;&gt;The isenkram
681 system&lt;/a&gt; is a user-focused solution in Debian for handling hardware
682 related packages. The idea is to have a database of mappings between
683 hardware and packages, and pop up a dialog suggesting for the user to
684 install the packages to use a given hardware dongle. Some use cases
685 are when you insert a Yubikey, it proposes to install the software
686 needed to control it; when you insert a braille reader list it
687 proposes to install the packages needed to send text to the reader;
688 and when you insert a ColorHug screen calibrator it suggests to
689 install the driver for it. The system work well, and even have a few
690 command line tools to install firmware packages and packages for the
691 hardware already in the machine (as opposed to hotpluggable hardware).&lt;/p&gt;
692
693 &lt;p&gt;The system was initially written using aptdaemon, because I found
694 good documentation and example code on how to use it. But aptdaemon
695 is going away and is generally being replaced by
696 &lt;a href=&quot;http://www.freedesktop.org/software/PackageKit/&quot;&gt;PackageKit&lt;/a&gt;,
697 so Isenkram needed a rewrite. And today, thanks to the great patch
698 from my college Sunil Mohan Adapa in the FreedomBox project, the
699 rewrite finally took place. I&#39;ve just uploaded a new version of
700 Isenkram into Debian Unstable with the patch included, and the default
701 for the background daemon is now to use PackageKit. To check it out,
702 install the &lt;tt&gt;isenkram&lt;/tt&gt; package and insert some hardware dongle
703 and see if it is recognised.&lt;/p&gt;
704
705 &lt;p&gt;If you want to know what kind of packages isenkram would propose for
706 the machine it is running on, you can check out the isenkram-lookup
707 program. This is what it look like on a Thinkpad X230:&lt;/p&gt;
708
709 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
710 % isenkram-lookup
711 bluez
712 cheese
713 fprintd
714 fprintd-demo
715 gkrellm-thinkbat
716 hdapsd
717 libpam-fprintd
718 pidgin-blinklight
719 thinkfan
720 tleds
721 tp-smapi-dkms
722 tp-smapi-source
723 tpb
724 %p
725 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
726
727 &lt;p&gt;The hardware mappings come from several places. The preferred way
728 is for packages to announce their hardware support using
729 &lt;a href=&quot;https://www.freedesktop.org/software/appstream/docs/&quot;&gt;the
730 cross distribution appstream system&lt;/a&gt;.
731 See
732 &lt;a href=&quot;http://www.hungry.com/~pere/blog/tags/isenkram/&quot;&gt;previous
733 blog posts about isenkram&lt;/a&gt; to learn how to do that.&lt;/p&gt;
734 </description>
735 </item>
736
737 <item>
738 <title>Using appstream with isenkram to install hardware related packages in Debian</title>
739 <link>http://www.hungry.com/~pere/blog/Using_appstream_with_isenkram_to_install_hardware_related_packages_in_Debian.html</link>
740 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Using_appstream_with_isenkram_to_install_hardware_related_packages_in_Debian.html</guid>
741 <pubDate>Sun, 20 Dec 2015 12:20:00 +0100</pubDate>
742 <description>&lt;p&gt;Around three years ago, I created
743 &lt;a href=&quot;http://packages.qa.debian.org/isenkram&quot;&gt;the isenkram
744 system&lt;/a&gt; to get a more practical solution in Debian for handing
745 hardware related packages. A GUI system in the isenkram package will
746 present a pop-up dialog when some hardware dongle supported by
747 relevant packages in Debian is inserted into the machine. The same
748 lookup mechanism to detect packages is available as command line
749 tools in the isenkram-cli package. In addition to mapping hardware,
750 it will also map kernel firmware files to packages and make it easy to
751 install needed firmware packages automatically. The key for this
752 system to work is a good way to map hardware to packages, in other
753 words, allow packages to announce what hardware they will work
754 with.&lt;/p&gt;
755
756 &lt;p&gt;I started by providing data files in the isenkram source, and
757 adding code to download the latest version of these data files at run
758 time, to ensure every user had the most up to date mapping available.
759 I also added support for storing the mapping in the Packages file in
760 the apt repositories, but did not push this approach because while I
761 was trying to figure out how to best store hardware/package mappings,
762 &lt;a href=&quot;http://www.freedesktop.org/software/appstream/docs/&quot;&gt;the
763 appstream system&lt;/a&gt; was announced. I got in touch and suggested to
764 add the hardware mapping into that data set to be able to use
765 appstream as a data source, and this was accepted at least for the
766 Debian version of appstream.&lt;/p&gt;
767
768 &lt;p&gt;A few days ago using appstream in Debian for this became possible,
769 and today I uploaded a new version 0.20 of isenkram adding support for
770 appstream as a data source for mapping hardware to packages. The only
771 package so far using appstream to announce its hardware support is my
772 pymissile package. I got help from Matthias Klumpp with figuring out
773 how do add the required
774 &lt;a href=&quot;https://appstream.debian.org/html/sid/main/metainfo/pymissile.html&quot;&gt;metadata
775 in pymissile&lt;/a&gt;. I added a file debian/pymissile.metainfo.xml with
776 this content:&lt;/p&gt;
777
778 &lt;blockquote&gt;&lt;pre&gt;
779 &amp;lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&amp;gt;
780 &amp;lt;component&amp;gt;
781 &amp;lt;id&amp;gt;pymissile&amp;lt;/id&amp;gt;
782 &amp;lt;metadata_license&amp;gt;MIT&amp;lt;/metadata_license&amp;gt;
783 &amp;lt;name&amp;gt;pymissile&amp;lt;/name&amp;gt;
784 &amp;lt;summary&amp;gt;Control original Striker USB Missile Launcher&amp;lt;/summary&amp;gt;
785 &amp;lt;description&amp;gt;
786 &amp;lt;p&amp;gt;
787 Pymissile provides a curses interface to control an original
788 Marks and Spencer / Striker USB Missile Launcher, as well as a
789 motion control script to allow a webcamera to control the
790 launcher.
791 &amp;lt;/p&amp;gt;
792 &amp;lt;/description&amp;gt;
793 &amp;lt;provides&amp;gt;
794 &amp;lt;modalias&amp;gt;usb:v1130p0202d*&amp;lt;/modalias&amp;gt;
795 &amp;lt;/provides&amp;gt;
796 &amp;lt;/component&amp;gt;
797 &lt;/pre&gt;&lt;/blockquote&gt;
798
799 &lt;p&gt;The key for isenkram is the component/provides/modalias value,
800 which is a glob style match rule for hardware specific strings
801 (modalias strings) provided by the Linux kernel. In this case, it
802 will map to all USB devices with vendor code 1130 and product code
803 0202.&lt;/p&gt;
804
805 &lt;p&gt;Note, it is important that the license of all the metadata files
806 are compatible to have permissions to aggregate them into archive wide
807 appstream files. Matthias suggested to use MIT or BSD licenses for
808 these files. A challenge is figuring out a good id for the data, as
809 it is supposed to be globally unique and shared across distributions
810 (in other words, best to coordinate with upstream what to use). But
811 it can be changed later or, so we went with the package name as
812 upstream for this project is dormant.&lt;/p&gt;
813
814 &lt;p&gt;To get the metadata file installed in the correct location for the
815 mirror update scripts to pick it up and include its content the
816 appstream data source, the file must be installed in the binary
817 package under /usr/share/appdata/. I did this by adding the following
818 line to debian/pymissile.install:&lt;/p&gt;
819
820 &lt;blockquote&gt;&lt;pre&gt;
821 debian/pymissile.metainfo.xml usr/share/appdata
822 &lt;/pre&gt;&lt;/blockquote&gt;
823
824 &lt;p&gt;With that in place, the command line tool isenkram-lookup will list
825 all packages useful on the current computer automatically, and the GUI
826 pop-up handler will propose to install the package not already
827 installed if a hardware dongle is inserted into the machine in
828 question.&lt;/p&gt;
829
830 &lt;p&gt;Details of the modalias field in appstream is available from the
831 &lt;a href=&quot;https://wiki.debian.org/DEP-11&quot;&gt;DEP-11&lt;/a&gt; proposal.&lt;/p&gt;
832
833 &lt;p&gt;To locate the modalias values of all hardware present in a machine,
834 try running this command on the command line:&lt;/p&gt;
835
836 &lt;blockquote&gt;&lt;pre&gt;
837 cat $(find /sys/devices/|grep modalias)
838 &lt;/pre&gt;&lt;/blockquote&gt;
839
840 &lt;p&gt;To learn more about the isenkram system, please check out
841 &lt;a href=&quot;http://www.hungry.com/~pere/blog/tags/isenkram/&quot;&gt;my
842 blog posts tagged isenkram&lt;/a&gt;.&lt;/p&gt;
843 </description>
844 </item>
845
846 <item>
847 <title>Debian Jessie, PXE and automatic firmware installation</title>
848 <link>http://www.hungry.com/~pere/blog/Debian_Jessie__PXE_and_automatic_firmware_installation.html</link>
849 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Debian_Jessie__PXE_and_automatic_firmware_installation.html</guid>
850 <pubDate>Fri, 17 Oct 2014 14:10:00 +0200</pubDate>
851 <description>&lt;p&gt;When PXE installing laptops with Debian, I often run into the
852 problem that the WiFi card require some firmware to work properly.
853 And it has been a pain to fix this using preseeding in Debian.
854 Normally something more is needed. But thanks to
855 &lt;a href=&quot;https://packages.qa.debian.org/i/isenkram.html&quot;&gt;my isenkram
856 package&lt;/a&gt; and its recent tasksel extension, it has now become easy
857 to do this using simple preseeding.&lt;/p&gt;
858
859 &lt;p&gt;The isenkram-cli package provide tasksel tasks which will install
860 firmware for the hardware found in the machine (actually, requested by
861 the kernel modules for the hardware). (It can also install user space
862 programs supporting the hardware detected, but that is not the focus
863 of this story.)&lt;/p&gt;
864
865 &lt;p&gt;To get this working in the default installation, two preeseding
866 values are needed. First, the isenkram-cli package must be installed
867 into the target chroot (aka the hard drive) before tasksel is executed
868 in the pkgsel step of the debian-installer system. This is done by
869 preseeding the base-installer/includes debconf value to include the
870 isenkram-cli package. The package name is next passed to debootstrap
871 for installation. With the isenkram-cli package in place, tasksel
872 will automatically use the isenkram tasks to detect hardware specific
873 packages for the machine being installed and install them, because
874 isenkram-cli contain tasksel tasks.&lt;/p&gt;
875
876 &lt;p&gt;Second, one need to enable the non-free APT repository, because
877 most firmware unfortunately is non-free. This is done by preseeding
878 the apt-mirror-setup step. This is unfortunate, but for a lot of
879 hardware it is the only option in Debian.&lt;/p&gt;
880
881 &lt;p&gt;The end result is two lines needed in your preseeding file to get
882 firmware installed automatically by the installer:&lt;/p&gt;
883
884 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
885 base-installer base-installer/includes string isenkram-cli
886 apt-mirror-setup apt-setup/non-free boolean true
887 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
888
889 &lt;p&gt;The current version of isenkram-cli in testing/jessie will install
890 both firmware and user space packages when using this method. It also
891 do not work well, so use version 0.15 or later. Installing both
892 firmware and user space packages might give you a bit more than you
893 want, so I decided to split the tasksel task in two, one for firmware
894 and one for user space programs. The firmware task is enabled by
895 default, while the one for user space programs is not. This split is
896 implemented in the package currently in unstable.&lt;/p&gt;
897
898 &lt;p&gt;If you decide to give this a go, please let me know (via email) how
899 this recipe work for you. :)&lt;/p&gt;
900
901 &lt;p&gt;So, I bet you are wondering, how can this work. First and
902 foremost, it work because tasksel is modular, and driven by whatever
903 files it find in /usr/lib/tasksel/ and /usr/share/tasksel/. So the
904 isenkram-cli package place two files for tasksel to find. First there
905 is the task description file (/usr/share/tasksel/descs/isenkram.desc):&lt;/p&gt;
906
907 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
908 Task: isenkram-packages
909 Section: hardware
910 Description: Hardware specific packages (autodetected by isenkram)
911 Based on the detected hardware various hardware specific packages are
912 proposed.
913 Test-new-install: show show
914 Relevance: 8
915 Packages: for-current-hardware
916
917 Task: isenkram-firmware
918 Section: hardware
919 Description: Hardware specific firmware packages (autodetected by isenkram)
920 Based on the detected hardware various hardware specific firmware
921 packages are proposed.
922 Test-new-install: mark show
923 Relevance: 8
924 Packages: for-current-hardware-firmware
925 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
926
927 &lt;p&gt;The key parts are Test-new-install which indicate how the task
928 should be handled and the Packages line referencing to a script in
929 /usr/lib/tasksel/packages/. The scripts use other scripts to get a
930 list of packages to install. The for-current-hardware-firmware script
931 look like this to list relevant firmware for the machine:
932
933 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
934 #!/bin/sh
935 #
936 PATH=/usr/sbin:$PATH
937 export PATH
938 isenkram-autoinstall-firmware -l
939 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
940
941 &lt;p&gt;With those two pieces in place, the firmware is installed by
942 tasksel during the normal d-i run. :)&lt;/p&gt;
943
944 &lt;p&gt;If you want to test what tasksel will install when isenkram-cli is
945 installed, run &lt;tt&gt;DEBIAN_PRIORITY=critical tasksel --test
946 --new-install&lt;/tt&gt; to get the list of packages that tasksel would
947 install.&lt;/p&gt;
948
949 &lt;p&gt;&lt;a href=&quot;https://wiki.debian.org/DebianEdu/&quot;&gt;Debian Edu&lt;/a&gt; will be
950 pilots in testing this feature, as isenkram is used there now to
951 install firmware, replacing the earlier scripts.&lt;/p&gt;
952 </description>
953 </item>
954
955 <item>
956 <title>Install hardware dependent packages using tasksel (Isenkram 0.7)</title>
957 <link>http://www.hungry.com/~pere/blog/Install_hardware_dependent_packages_using_tasksel__Isenkram_0_7_.html</link>
958 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Install_hardware_dependent_packages_using_tasksel__Isenkram_0_7_.html</guid>
959 <pubDate>Wed, 23 Apr 2014 14:50:00 +0200</pubDate>
960 <description>&lt;p&gt;It would be nice if it was easier in Debian to get all the hardware
961 related packages relevant for the computer installed automatically.
962 So I implemented one, using
963 &lt;a href=&quot;http://packages.qa.debian.org/isenkram&quot;&gt;my Isenkram
964 package&lt;/a&gt;. To use it, install the tasksel and isenkram packages and
965 run tasksel as user root. You should be presented with a new option,
966 &quot;Hardware specific packages (autodetected by isenkram)&quot;. When you
967 select it, tasksel will install the packages isenkram claim is fit for
968 the current hardware, hot pluggable or not.&lt;p&gt;
969
970 &lt;p&gt;The implementation is in two files, one is the tasksel menu entry
971 description, and the other is the script used to extract the list of
972 packages to install. The first part is in
973 &lt;tt&gt;/usr/share/tasksel/descs/isenkram.desc&lt;/tt&gt; and look like
974 this:&lt;/p&gt;
975
976 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
977 Task: isenkram
978 Section: hardware
979 Description: Hardware specific packages (autodetected by isenkram)
980 Based on the detected hardware various hardware specific packages are
981 proposed.
982 Test-new-install: mark show
983 Relevance: 8
984 Packages: for-current-hardware
985 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
986
987 &lt;p&gt;The second part is in
988 &lt;tt&gt;/usr/lib/tasksel/packages/for-current-hardware&lt;/tt&gt; and look like
989 this:&lt;/p&gt;
990
991 &lt;p&gt;&lt;blockquote&gt;&lt;pre&gt;
992 #!/bin/sh
993 #
994 (
995 isenkram-lookup
996 isenkram-autoinstall-firmware -l
997 ) | sort -u
998 &lt;/pre&gt;&lt;/blockquote&gt;&lt;/p&gt;
999
1000 &lt;p&gt;All in all, a very short and simple implementation making it
1001 trivial to install the hardware dependent package we all may want to
1002 have installed on our machines. I&#39;ve not been able to find a way to
1003 get tasksel to tell you exactly which packages it plan to install
1004 before doing the installation. So if you are curious or careful,
1005 check the output from the isenkram-* command line tools first.&lt;/p&gt;
1006
1007 &lt;p&gt;The information about which packages are handling which hardware is
1008 fetched either from the isenkram package itself in
1009 /usr/share/isenkram/, from git.debian.org or from the APT package
1010 database (using the Modaliases header). The APT package database
1011 parsing have caused a nasty resource leak in the isenkram daemon (bugs
1012 &lt;a href=&quot;http://bugs.debian.org/719837&quot;&gt;#719837&lt;/a&gt; and
1013 &lt;a href=&quot;http://bugs.debian.org/730704&quot;&gt;#730704&lt;/a&gt;). The cause is in
1014 the python-apt code (bug
1015 &lt;a href=&quot;http://bugs.debian.org/745487&quot;&gt;#745487&lt;/a&gt;), but using a
1016 workaround I was able to get rid of the file descriptor leak and
1017 reduce the memory leak from ~30 MiB per hardware detection down to
1018 around 2 MiB per hardware detection. It should make the desktop
1019 daemon a lot more useful. The fix is in version 0.7 uploaded to
1020 unstable today.&lt;/p&gt;
1021
1022 &lt;p&gt;I believe the current way of mapping hardware to packages in
1023 Isenkram is is a good draft, but in the future I expect isenkram to
1024 use the AppStream data source for this. A proposal for getting proper
1025 AppStream support into Debian is floating around as
1026 &lt;a href=&quot;https://wiki.debian.org/DEP-11&quot;&gt;DEP-11&lt;/a&gt;, and
1027 &lt;a href=&quot;https://wiki.debian.org/SummerOfCode2014/Projects#SummerOfCode2014.2FProjects.2FAppStreamDEP11Implementation.AppStream.2FDEP-11_for_the_Debian_Archive&quot;&gt;GSoC
1028 project&lt;/a&gt; will take place this summer to improve the situation. I
1029 look forward to seeing the result, and welcome patches for isenkram to
1030 start using the information when it is ready.&lt;/p&gt;
1031
1032 &lt;p&gt;If you want your package to map to some specific hardware, either
1033 add a &quot;Xb-Modaliases&quot; header to your control file like I did in
1034 &lt;a href=&quot;http://packages.qa.debian.org/pymissile&quot;&gt;the pymissile
1035 package&lt;/a&gt; or submit a bug report with the details to the isenkram
1036 package. See also
1037 &lt;a href=&quot;http://www.hungry.com/~pere/blog/tags/isenkram/&quot;&gt;all my
1038 blog posts tagged isenkram&lt;/a&gt; for details on the notation. I expect
1039 the information will be migrated to AppStream eventually, but for the
1040 moment I got no better place to store it.&lt;/p&gt;
1041 </description>
1042 </item>
1043
1044 <item>
1045 <title>Automatically locate and install required firmware packages on Debian (Isenkram 0.4)</title>
1046 <link>http://www.hungry.com/~pere/blog/Automatically_locate_and_install_required_firmware_packages_on_Debian__Isenkram_0_4_.html</link>
1047 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Automatically_locate_and_install_required_firmware_packages_on_Debian__Isenkram_0_4_.html</guid>
1048 <pubDate>Tue, 25 Jun 2013 11:50:00 +0200</pubDate>
1049 <description>&lt;p&gt;It annoys me when the computer fail to do automatically what it is
1050 perfectly capable of, and I have to do it manually to get things
1051 working. One such task is to find out what firmware packages are
1052 needed to get the hardware on my computer working. Most often this
1053 affect the wifi card, but some times it even affect the RAID
1054 controller or the ethernet card. Today I pushed version 0.4 of the
1055 &lt;a href=&quot;http://packages.qa.debian.org/isenkram&quot;&gt;Isenkram package&lt;/a&gt;
1056 including a new script isenkram-autoinstall-firmware handling the
1057 process of asking all the loaded kernel modules what firmware files
1058 they want, find debian packages providing these files and install the
1059 debian packages. Here is a test run on my laptop:&lt;/p&gt;
1060
1061 &lt;p&gt;&lt;pre&gt;
1062 # isenkram-autoinstall-firmware
1063 info: kernel drivers requested extra firmware: ipw2200-bss.fw ipw2200-ibss.fw ipw2200-sniffer.fw
1064 info: fetching http://http.debian.net/debian/dists/squeeze/Contents-i386.gz
1065 info: locating packages with the requested firmware files
1066 info: Updating APT sources after adding non-free APT source
1067 info: trying to install firmware-ipw2x00
1068 firmware-ipw2x00
1069 firmware-ipw2x00
1070 Preconfiguring packages ...
1071 Selecting previously deselected package firmware-ipw2x00.
1072 (Reading database ... 259727 files and directories currently installed.)
1073 Unpacking firmware-ipw2x00 (from .../firmware-ipw2x00_0.28+squeeze1_all.deb) ...
1074 Setting up firmware-ipw2x00 (0.28+squeeze1) ...
1075 #
1076 &lt;/pre&gt;&lt;/p&gt;
1077
1078 &lt;p&gt;When all the requested firmware is present, a simple message is
1079 printed instead:&lt;/p&gt;
1080
1081 &lt;p&gt;&lt;pre&gt;
1082 # isenkram-autoinstall-firmware
1083 info: did not find any firmware files requested by loaded kernel modules. exiting
1084 #
1085 &lt;/pre&gt;&lt;/p&gt;
1086
1087 &lt;p&gt;It could use some polish, but it is already working well and saving
1088 me some time when setting up new machines. :)&lt;/p&gt;
1089
1090 &lt;p&gt;So, how does it work? It look at the set of currently loaded
1091 kernel modules, and look up each one of them using modinfo, to find
1092 the firmware files listed in the module meta-information. Next, it
1093 download the Contents file from a nearby APT mirror, and search for
1094 the firmware files in this file to locate the package with the
1095 requested firmware file. If the package is in the non-free section, a
1096 non-free APT source is added and the package is installed using
1097 &lt;tt&gt;apt-get install&lt;/tt&gt;. The end result is a slightly better working
1098 machine.&lt;/p&gt;
1099
1100 &lt;p&gt;I hope someone find time to implement a more polished version of
1101 this script as part of the hw-detect debian-installer module, to
1102 finally fix &lt;a href=&quot;http://bugs.debian.org/655507&quot;&gt;BTS report
1103 #655507&lt;/a&gt;. There really is no need to insert USB sticks with
1104 firmware during a PXE install when the packages already are available
1105 from the nearby Debian mirror.&lt;/p&gt;
1106 </description>
1107 </item>
1108
1109 <item>
1110 <title>Isenkram 0.2 finally in the Debian archive</title>
1111 <link>http://www.hungry.com/~pere/blog/Isenkram_0_2_finally_in_the_Debian_archive.html</link>
1112 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Isenkram_0_2_finally_in_the_Debian_archive.html</guid>
1113 <pubDate>Wed, 3 Apr 2013 23:40:00 +0200</pubDate>
1114 <description>&lt;p&gt;Today the &lt;a href=&quot;http://packages.qa.debian.org/isenkram&quot;&gt;Isenkram
1115 package&lt;/a&gt; finally made it into the archive, after lingering in NEW
1116 for many months. I uploaded it to the Debian experimental suite
1117 2013-01-27, and today it was accepted into the archive.&lt;/p&gt;
1118
1119 &lt;p&gt;Isenkram is a system for suggesting to users what packages to
1120 install to work with a pluggable hardware device. The suggestion pop
1121 up when the device is plugged in. For example if a Lego Mindstorm NXT
1122 is inserted, it will suggest to install the program needed to program
1123 the NXT controller. Give it a go, and report bugs and suggestions to
1124 BTS. :)&lt;/p&gt;
1125 </description>
1126 </item>
1127
1128 <item>
1129 <title>Welcome to the world, Isenkram!</title>
1130 <link>http://www.hungry.com/~pere/blog/Welcome_to_the_world__Isenkram_.html</link>
1131 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Welcome_to_the_world__Isenkram_.html</guid>
1132 <pubDate>Tue, 22 Jan 2013 22:00:00 +0100</pubDate>
1133 <description>&lt;p&gt;Yesterday, I
1134 &lt;a href=&quot;http://www.hungry.com/~pere/blog/First_prototype_ready_making_hardware_easier_to_use_in_Debian.html&quot;&gt;asked
1135 for testers&lt;/a&gt; for my prototype for making Debian better at handling
1136 pluggable hardware devices, which I
1137 &lt;a href=&quot;http://www.hungry.com/~pere/blog/Lets_make_hardware_dongles_easier_to_use_in_Debian.html&quot;&gt;set
1138 out to create&lt;/a&gt; earlier this month. Several valuable testers showed
1139 up, and caused me to really want to to open up the development to more
1140 people. But before I did this, I want to come up with a sensible name
1141 for this project. Today I finally decided on a new name, and I have
1142 renamed the project from hw-support-handler to this new name. In the
1143 process, I moved the source to git and made it available as a
1144 &lt;a href=&quot;http://anonscm.debian.org/gitweb/?p=collab-maint/isenkram.git&quot;&gt;collab-maint&lt;/a&gt;
1145 repository in Debian. The new name? It is &lt;strong&gt;Isenkram&lt;/strong&gt;.
1146 To fetch and build the latest version of the source, use&lt;/p&gt;
1147
1148 &lt;pre&gt;
1149 git clone http://anonscm.debian.org/git/collab-maint/isenkram.git
1150 cd isenkram &amp;&amp; git-buildpackage -us -uc
1151 &lt;/pre&gt;
1152
1153 &lt;p&gt;I have not yet adjusted all files to use the new name yet. If you
1154 want to hack on the source or improve the package, please go ahead.
1155 But please talk to me first on IRC or via email before you do major
1156 changes, to make sure we do not step on each others toes. :)&lt;/p&gt;
1157
1158 &lt;p&gt;If you wonder what &#39;isenkram&#39; is, it is a Norwegian word for iron
1159 stuff, typically meaning tools, nails, screws, etc. Typical hardware
1160 stuff, in other words. I&#39;ve been told it is the Norwegian variant of
1161 the German word eisenkram, for those that are familiar with that
1162 word.&lt;/p&gt;
1163
1164 &lt;p&gt;&lt;strong&gt;Update 2013-01-26&lt;/strong&gt;: Added -us -us to build
1165 instructions, to avoid confusing people with an error from the signing
1166 process.&lt;/p&gt;
1167
1168 &lt;p&gt;&lt;strong&gt;Update 2013-01-27&lt;/strong&gt;: Switch to HTTP URL for the git
1169 clone argument to avoid the need for authentication.&lt;/p&gt;
1170 </description>
1171 </item>
1172
1173 <item>
1174 <title>First prototype ready making hardware easier to use in Debian</title>
1175 <link>http://www.hungry.com/~pere/blog/First_prototype_ready_making_hardware_easier_to_use_in_Debian.html</link>
1176 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/First_prototype_ready_making_hardware_easier_to_use_in_Debian.html</guid>
1177 <pubDate>Mon, 21 Jan 2013 12:00:00 +0100</pubDate>
1178 <description>&lt;p&gt;Early this month I set out to try to
1179 &lt;a href=&quot;http://www.hungry.com/~pere/blog/Lets_make_hardware_dongles_easier_to_use_in_Debian.html&quot;&gt;improve
1180 the Debian support for pluggable hardware devices&lt;/a&gt;. Now my
1181 prototype is working, and it is ready for a larger audience. To test
1182 it, fetch the
1183 &lt;a href=&quot;http://anonscm.debian.org/viewvc/debian-edu/trunk/src/hw-support-handler/&quot;&gt;source
1184 from the Debian Edu subversion repository&lt;/a&gt;, build and install the
1185 package. You might have to log out and in again activate the
1186 autostart script.&lt;/p&gt;
1187
1188 &lt;p&gt;The design is simple:&lt;/p&gt;
1189
1190 &lt;ul&gt;
1191
1192 &lt;li&gt;Add desktop entry in /usr/share/autostart/ causing a program
1193 hw-support-handlerd to start when the user log in.&lt;/li&gt;
1194
1195 &lt;li&gt;This program listen for kernel events about new hardware (directly
1196 from the kernel like udev does), not using HAL dbus events as I
1197 initially did.&lt;/li&gt;
1198
1199 &lt;li&gt;When new hardware is inserted, look up the hardware modalias in
1200 the APT database, a database
1201 &lt;a href=&quot;http://anonscm.debian.org/viewvc/debian-edu/trunk/src/hw-support-handler/modaliases?view=markup&quot;&gt;available
1202 via HTTP&lt;/a&gt; and a database available as part of the package.&lt;/li&gt;
1203
1204 &lt;li&gt;If a package is mapped to the hardware in question, the package
1205 isn&#39;t installed yet and this is the first time the hardware was
1206 plugged in, show a desktop notification suggesting to install the
1207 package or packages.&lt;/li&gt;
1208
1209 &lt;li&gt;If the user click on the &#39;install package now&#39; button, ask
1210 aptdaemon via the PackageKit API to install the requrired package.&lt;/li&gt;
1211
1212 &lt;li&gt;aptdaemon ask for root password or sudo password, and install the
1213 package while showing progress information in a window.&lt;/li&gt;
1214
1215 &lt;/ul&gt;
1216
1217 &lt;p&gt;I still need to come up with a better name for the system. Here
1218 are some screen shots showing the prototype in action. First the
1219 notification, then the password request, and finally the request to
1220 approve all the dependencies. Sorry for the Norwegian Bokmål GUI.&lt;/p&gt;
1221
1222 &lt;p&gt;&lt;img src=&quot;http://www.hungry.com/~pere/blog/images/2013-01-21-hw-support-1-notification.png&quot;&gt;
1223 &lt;br&gt;&lt;img src=&quot;http://www.hungry.com/~pere/blog/images/2013-01-21-hw-support-2-password.png&quot;&gt;
1224 &lt;br&gt;&lt;img src=&quot;http://www.hungry.com/~pere/blog/images/2013-01-21-hw-support-3-dependencies.png&quot;&gt;
1225 &lt;br&gt;&lt;img src=&quot;http://www.hungry.com/~pere/blog/images/2013-01-21-hw-support-4-installing.png&quot;&gt;
1226 &lt;br&gt;&lt;img src=&quot;http://www.hungry.com/~pere/blog/images/2013-01-21-hw-support-5-installing-details.png&quot; width=&quot;70%&quot;&gt;&lt;/p&gt;
1227
1228 &lt;p&gt;The prototype still need to be improved with longer timeouts, but
1229 is already useful. The database of hardware to package mappings also
1230 need more work. It is currently compatible with the Ubuntu way of
1231 storing such information in the package control file, but could be
1232 changed to use other formats instead or in addition to the current
1233 method. I&#39;ve dropped the use of discover for this mapping, as the
1234 modalias approach is more flexible and easier to use on Linux as long
1235 as the Linux kernel expose its modalias strings directly.&lt;/p&gt;
1236
1237 &lt;p&gt;&lt;strong&gt;Update 2013-01-21 16:50&lt;/strong&gt;: Due to popular demand,
1238 here is the command required to check out and build the source: Use
1239 &#39;&lt;tt&gt;svn checkout
1240 svn://svn.debian.org/debian-edu/trunk/src/hw-support-handler/; cd
1241 hw-support-handler; debuild&lt;/tt&gt;&#39;. If you lack debuild, install the
1242 devscripts package.&lt;/p&gt;
1243
1244 &lt;p&gt;&lt;strong&gt;Update 2013-01-23 12:00&lt;/strong&gt;: The project is now
1245 renamed to Isenkram and the source moved from the Debian Edu
1246 subversion repository to a Debian collab-maint git repository. See
1247 &lt;a href=&quot;http://www.hungry.com/~pere/blog/Welcome_to_the_world__Isenkram_.html&quot;&gt;build
1248 instructions&lt;/a&gt; for details.&lt;/p&gt;
1249 </description>
1250 </item>
1251
1252 <item>
1253 <title>Using modalias info to find packages handling my hardware</title>
1254 <link>http://www.hungry.com/~pere/blog/Using_modalias_info_to_find_packages_handling_my_hardware.html</link>
1255 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Using_modalias_info_to_find_packages_handling_my_hardware.html</guid>
1256 <pubDate>Tue, 15 Jan 2013 08:00:00 +0100</pubDate>
1257 <description>&lt;p&gt;Yesterday, I wrote about the
1258 &lt;a href=&quot;http://www.hungry.com/~pere/blog/Modalias_strings___a_practical_way_to_map__stuff__to_hardware.html&quot;&gt;modalias
1259 values provided by the Linux kernel&lt;/a&gt; following my hope for
1260 &lt;a href=&quot;http://www.hungry.com/~pere/blog/Lets_make_hardware_dongles_easier_to_use_in_Debian.html&quot;&gt;better
1261 dongle support in Debian&lt;/a&gt;. Using this knowledge, I have tested how
1262 modalias values attached to package names can be used to map packages
1263 to hardware. This allow the system to look up and suggest relevant
1264 packages when I plug in some new hardware into my machine, and replace
1265 discover and discover-data as the database used to map hardware to
1266 packages.&lt;/p&gt;
1267
1268 &lt;p&gt;I create a modaliases file with entries like the following,
1269 containing package name, kernel module name (if relevant, otherwise
1270 the package name) and globs matching the relevant hardware
1271 modalias.&lt;/p&gt;
1272
1273 &lt;p&gt;&lt;blockquote&gt;
1274 Package: package-name
1275 &lt;br&gt;Modaliases: module(modaliasglob, modaliasglob, modaliasglob)&lt;/p&gt;
1276 &lt;/blockquote&gt;&lt;/p&gt;
1277
1278 &lt;p&gt;It is fairly trivial to write code to find the relevant packages
1279 for a given modalias value using this file.&lt;/p&gt;
1280
1281 &lt;p&gt;An entry like this would suggest the video and picture application
1282 cheese for many USB web cameras (interface bus class 0E01):&lt;/p&gt;
1283
1284 &lt;p&gt;&lt;blockquote&gt;
1285 Package: cheese
1286 &lt;br&gt;Modaliases: cheese(usb:v*p*d*dc*dsc*dp*ic0Eisc01ip*)&lt;/p&gt;
1287 &lt;/blockquote&gt;&lt;/p&gt;
1288
1289 &lt;p&gt;An entry like this would suggest the pcmciautils package when a
1290 CardBus bridge (bus class 0607) PCI device is present:&lt;/p&gt;
1291
1292 &lt;p&gt;&lt;blockquote&gt;
1293 Package: pcmciautils
1294 &lt;br&gt;Modaliases: pcmciautils(pci:v*d*sv*sd*bc06sc07i*)
1295 &lt;/blockquote&gt;&lt;/p&gt;
1296
1297 &lt;p&gt;An entry like this would suggest the package colorhug-client when
1298 plugging in a ColorHug with USB IDs 04D8:F8DA:&lt;/p&gt;
1299
1300 &lt;p&gt;&lt;blockquote&gt;
1301 Package: colorhug-client
1302 &lt;br&gt;Modaliases: colorhug-client(usb:v04D8pF8DAd*)&lt;/p&gt;
1303 &lt;/blockquote&gt;&lt;/p&gt;
1304
1305 &lt;p&gt;I believe the format is compatible with the format of the Packages
1306 file in the Debian archive. Ubuntu already uses their Packages file
1307 to store their mappings from packages to hardware.&lt;/p&gt;
1308
1309 &lt;p&gt;By adding a XB-Modaliases: header in debian/control, any .deb can
1310 announce the hardware it support in a way my prototype understand.
1311 This allow those publishing packages in an APT source outside the
1312 Debian archive as well as those backporting packages to make sure the
1313 hardware mapping are included in the package meta information. I&#39;ve
1314 tested such header in the pymissile package, and its modalias mapping
1315 is working as it should with my prototype. It even made it to Ubuntu
1316 Raring.&lt;/p&gt;
1317
1318 &lt;p&gt;To test if it was possible to look up supported hardware using only
1319 the shell tools available in the Debian installer, I wrote a shell
1320 implementation of the lookup code. The idea is to create files for
1321 each modalias and let the shell do the matching. Please check out and
1322 try the
1323 &lt;a href=&quot;http://anonscm.debian.org/viewvc/debian-edu/trunk/src/hw-support-handler/hw-support-lookup?view=co&quot;&gt;hw-support-lookup&lt;/a&gt;
1324 shell script. It run without any extra dependencies and fetch the
1325 hardware mappings from the Debian archive and the subversion
1326 repository where I currently work on my prototype.&lt;/p&gt;
1327
1328 &lt;p&gt;When I use it on a machine with a yubikey inserted, it suggest to
1329 install yubikey-personalization:&lt;/p&gt;
1330
1331 &lt;p&gt;&lt;blockquote&gt;
1332 % ./hw-support-lookup
1333 &lt;br&gt;yubikey-personalization
1334 &lt;br&gt;%
1335 &lt;/blockquote&gt;&lt;/p&gt;
1336
1337 &lt;p&gt;When I run it on my Thinkpad X40 with a PCMCIA/CardBus slot, it
1338 propose to install the pcmciautils package:&lt;/p&gt;
1339
1340 &lt;p&gt;&lt;blockquote&gt;
1341 % ./hw-support-lookup
1342 &lt;br&gt;pcmciautils
1343 &lt;br&gt;%
1344 &lt;/blockquote&gt;&lt;/p&gt;
1345
1346 &lt;p&gt;If you know of any hardware-package mapping that should be added to
1347 &lt;a href=&quot;http://anonscm.debian.org/viewvc/debian-edu/trunk/src/hw-support-handler/modaliases?view=co&quot;&gt;my
1348 database&lt;/a&gt;, please tell me about it.&lt;/p&gt;
1349
1350 &lt;p&gt;It could be possible to generate several of the mappings between
1351 packages and hardware. One source would be to look at packages with
1352 kernel modules, ie packages with *.ko files in /lib/modules/, and
1353 extract their modalias information. Another would be to look at
1354 packages with udev rules, ie packages with files in
1355 /lib/udev/rules.d/, and extract their vendor/model information to
1356 generate a modalias matching rule. I have not tested any of these to
1357 see if it work.&lt;/p&gt;
1358
1359 &lt;p&gt;If you want to help implementing a system to let us propose what
1360 packages to install when new hardware is plugged into a Debian
1361 machine, please send me an email or talk to me on
1362 &lt;a href=&quot;irc://irc.debian.org/%23debian-devel&quot;&gt;#debian-devel&lt;/a&gt;.&lt;/p&gt;
1363 </description>
1364 </item>
1365
1366 <item>
1367 <title>Modalias strings - a practical way to map &quot;stuff&quot; to hardware</title>
1368 <link>http://www.hungry.com/~pere/blog/Modalias_strings___a_practical_way_to_map__stuff__to_hardware.html</link>
1369 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Modalias_strings___a_practical_way_to_map__stuff__to_hardware.html</guid>
1370 <pubDate>Mon, 14 Jan 2013 11:20:00 +0100</pubDate>
1371 <description>&lt;p&gt;While looking into how to look up Debian packages based on hardware
1372 information, to find the packages that support a given piece of
1373 hardware, I refreshed my memory regarding modalias values, and decided
1374 to document the details. Here are my findings so far, also available
1375 in
1376 &lt;a href=&quot;http://anonscm.debian.org/viewvc/debian-edu/trunk/src/hw-support-handler/&quot;&gt;the
1377 Debian Edu subversion repository&lt;/a&gt;:
1378
1379 &lt;p&gt;&lt;strong&gt;Modalias decoded&lt;/strong&gt;&lt;/p&gt;
1380
1381 &lt;p&gt;This document try to explain what the different types of modalias
1382 values stands for. It is in part based on information from
1383 &amp;lt;URL: &lt;a href=&quot;https://wiki.archlinux.org/index.php/Modalias&quot;&gt;https://wiki.archlinux.org/index.php/Modalias&lt;/a&gt; &amp;gt;,
1384 &amp;lt;URL: &lt;a href=&quot;http://unix.stackexchange.com/questions/26132/how-to-assign-usb-driver-to-device&quot;&gt;http://unix.stackexchange.com/questions/26132/how-to-assign-usb-driver-to-device&lt;/a&gt; &amp;gt;,
1385 &amp;lt;URL: &lt;a href=&quot;http://code.metager.de/source/history/linux/stable/scripts/mod/file2alias.c&quot;&gt;http://code.metager.de/source/history/linux/stable/scripts/mod/file2alias.c&lt;/a&gt; &amp;gt; and
1386 &amp;lt;URL: &lt;a href=&quot;http://cvs.savannah.gnu.org/viewvc/dmidecode/dmidecode.c?root=dmidecode&amp;view=markup&quot;&gt;http://cvs.savannah.gnu.org/viewvc/dmidecode/dmidecode.c?root=dmidecode&amp;view=markup&lt;/a&gt; &amp;gt;.
1387
1388 &lt;p&gt;The modalias entries for a given Linux machine can be found using
1389 this shell script:&lt;/p&gt;
1390
1391 &lt;pre&gt;
1392 find /sys -name modalias -print0 | xargs -0 cat | sort -u
1393 &lt;/pre&gt;
1394
1395 &lt;p&gt;The supported modalias globs for a given kernel module can be found
1396 using modinfo:&lt;/p&gt;
1397
1398 &lt;pre&gt;
1399 % /sbin/modinfo psmouse | grep alias:
1400 alias: serio:ty05pr*id*ex*
1401 alias: serio:ty01pr*id*ex*
1402 %
1403 &lt;/pre&gt;
1404
1405 &lt;p&gt;&lt;strong&gt;PCI subtype&lt;/strong&gt;&lt;/p&gt;
1406
1407 &lt;p&gt;A typical PCI entry can look like this. This is an Intel Host
1408 Bridge memory controller:&lt;/p&gt;
1409
1410 &lt;p&gt;&lt;blockquote&gt;
1411 pci:v00008086d00002770sv00001028sd000001ADbc06sc00i00
1412 &lt;/blockquote&gt;&lt;/p&gt;
1413
1414 &lt;p&gt;This represent these values:&lt;/p&gt;
1415
1416 &lt;pre&gt;
1417 v 00008086 (vendor)
1418 d 00002770 (device)
1419 sv 00001028 (subvendor)
1420 sd 000001AD (subdevice)
1421 bc 06 (bus class)
1422 sc 00 (bus subclass)
1423 i 00 (interface)
1424 &lt;/pre&gt;
1425
1426 &lt;p&gt;The vendor/device values are the same values outputted from &#39;lspci
1427 -n&#39; as 8086:2770. The bus class/subclass is also shown by lspci as
1428 0600. The 0600 class is a host bridge. Other useful bus values are
1429 0300 (VGA compatible card) and 0200 (Ethernet controller).&lt;/p&gt;
1430
1431 &lt;p&gt;Not sure how to figure out the interface value, nor what it
1432 means.&lt;/p&gt;
1433
1434 &lt;p&gt;&lt;strong&gt;USB subtype&lt;/strong&gt;&lt;/p&gt;
1435
1436 &lt;p&gt;Some typical USB entries can look like this. This is an internal
1437 USB hub in a laptop:&lt;/p&gt;
1438
1439 &lt;p&gt;&lt;blockquote&gt;
1440 usb:v1D6Bp0001d0206dc09dsc00dp00ic09isc00ip00
1441 &lt;/blockquote&gt;&lt;/p&gt;
1442
1443 &lt;p&gt;Here is the values included in this alias:&lt;/p&gt;
1444
1445 &lt;pre&gt;
1446 v 1D6B (device vendor)
1447 p 0001 (device product)
1448 d 0206 (bcddevice)
1449 dc 09 (device class)
1450 dsc 00 (device subclass)
1451 dp 00 (device protocol)
1452 ic 09 (interface class)
1453 isc 00 (interface subclass)
1454 ip 00 (interface protocol)
1455 &lt;/pre&gt;
1456
1457 &lt;p&gt;The 0900 device class/subclass means hub. Some times the relevant
1458 class is in the interface class section. For a simple USB web camera,
1459 these alias entries show up:&lt;/p&gt;
1460
1461 &lt;p&gt;&lt;blockquote&gt;
1462 usb:v0AC8p3420d5000dcEFdsc02dp01ic01isc01ip00
1463 &lt;br&gt;usb:v0AC8p3420d5000dcEFdsc02dp01ic01isc02ip00
1464 &lt;br&gt;usb:v0AC8p3420d5000dcEFdsc02dp01ic0Eisc01ip00
1465 &lt;br&gt;usb:v0AC8p3420d5000dcEFdsc02dp01ic0Eisc02ip00
1466 &lt;/blockquote&gt;&lt;/p&gt;
1467
1468 &lt;p&gt;Interface class 0E01 is video control, 0E02 is video streaming (aka
1469 camera), 0101 is audio control device and 0102 is audio streaming (aka
1470 microphone). Thus this is a camera with microphone included.&lt;/p&gt;
1471
1472 &lt;p&gt;&lt;strong&gt;ACPI subtype&lt;/strong&gt;&lt;/p&gt;
1473
1474 &lt;p&gt;The ACPI type is used for several non-PCI/USB stuff. This is an IR
1475 receiver in a Thinkpad X40:&lt;/p&gt;
1476
1477 &lt;p&gt;&lt;blockquote&gt;
1478 acpi:IBM0071:PNP0511:
1479 &lt;/blockquote&gt;&lt;/p&gt;
1480
1481 &lt;p&gt;The values between the colons are IDs.&lt;/p&gt;
1482
1483 &lt;p&gt;&lt;strong&gt;DMI subtype&lt;/strong&gt;&lt;/p&gt;
1484
1485 &lt;p&gt;The DMI table contain lots of information about the computer case
1486 and model. This is an entry for a IBM Thinkpad X40, fetched from
1487 /sys/devices/virtual/dmi/id/modalias:&lt;/p&gt;
1488
1489 &lt;p&gt;&lt;blockquote&gt;
1490 dmi:bvnIBM:bvr1UETB6WW(1.66):bd06/15/2005:svnIBM:pn2371H4G:pvrThinkPadX40:rvnIBM:rn2371H4G:rvrNotAvailable:cvnIBM:ct10:cvrNotAvailable:
1491 &lt;/blockquote&gt;&lt;/p&gt;
1492
1493 &lt;p&gt;The values present are&lt;/p&gt;
1494
1495 &lt;pre&gt;
1496 bvn IBM (BIOS vendor)
1497 bvr 1UETB6WW(1.66) (BIOS version)
1498 bd 06/15/2005 (BIOS date)
1499 svn IBM (system vendor)
1500 pn 2371H4G (product name)
1501 pvr ThinkPadX40 (product version)
1502 rvn IBM (board vendor)
1503 rn 2371H4G (board name)
1504 rvr NotAvailable (board version)
1505 cvn IBM (chassis vendor)
1506 ct 10 (chassis type)
1507 cvr NotAvailable (chassis version)
1508 &lt;/pre&gt;
1509
1510 &lt;p&gt;The chassis type 10 is Notebook. Other interesting values can be
1511 found in the dmidecode source:&lt;/p&gt;
1512
1513 &lt;pre&gt;
1514 3 Desktop
1515 4 Low Profile Desktop
1516 5 Pizza Box
1517 6 Mini Tower
1518 7 Tower
1519 8 Portable
1520 9 Laptop
1521 10 Notebook
1522 11 Hand Held
1523 12 Docking Station
1524 13 All In One
1525 14 Sub Notebook
1526 15 Space-saving
1527 16 Lunch Box
1528 17 Main Server Chassis
1529 18 Expansion Chassis
1530 19 Sub Chassis
1531 20 Bus Expansion Chassis
1532 21 Peripheral Chassis
1533 22 RAID Chassis
1534 23 Rack Mount Chassis
1535 24 Sealed-case PC
1536 25 Multi-system
1537 26 CompactPCI
1538 27 AdvancedTCA
1539 28 Blade
1540 29 Blade Enclosing
1541 &lt;/pre&gt;
1542
1543 &lt;p&gt;The chassis type values are not always accurately set in the DMI
1544 table. For example my home server is a tower, but the DMI modalias
1545 claim it is a desktop.&lt;/p&gt;
1546
1547 &lt;p&gt;&lt;strong&gt;SerIO subtype&lt;/strong&gt;&lt;/p&gt;
1548
1549 &lt;p&gt;This type is used for PS/2 mouse plugs. One example is from my
1550 test machine:&lt;/p&gt;
1551
1552 &lt;p&gt;&lt;blockquote&gt;
1553 serio:ty01pr00id00ex00
1554 &lt;/blockquote&gt;&lt;/p&gt;
1555
1556 &lt;p&gt;The values present are&lt;/p&gt;
1557
1558 &lt;pre&gt;
1559 ty 01 (type)
1560 pr 00 (prototype)
1561 id 00 (id)
1562 ex 00 (extra)
1563 &lt;/pre&gt;
1564
1565 &lt;p&gt;This type is supported by the psmouse driver. I am not sure what
1566 the valid values are.&lt;/p&gt;
1567
1568 &lt;p&gt;&lt;strong&gt;Other subtypes&lt;/strong&gt;&lt;/p&gt;
1569
1570 &lt;p&gt;There are heaps of other modalias subtypes according to
1571 file2alias.c. There is the rest of the list from that source: amba,
1572 ap, bcma, ccw, css, eisa, hid, i2c, ieee1394, input, ipack, isapnp,
1573 mdio, of, parisc, pcmcia, platform, scsi, sdio, spi, ssb, vio, virtio,
1574 vmbus, x86cpu and zorro. I did not spend time documenting all of
1575 these, as they do not seem relevant for my intended use with mapping
1576 hardware to packages when new stuff is inserted during run time.&lt;/p&gt;
1577
1578 &lt;p&gt;&lt;strong&gt;Looking up kernel modules using modalias values&lt;/strong&gt;&lt;/p&gt;
1579
1580 &lt;p&gt;To check which kernel modules provide support for a given modalias,
1581 one can use the following shell script:&lt;/p&gt;
1582
1583 &lt;pre&gt;
1584 for id in $(find /sys -name modalias -print0 | xargs -0 cat | sort -u); do \
1585 echo &quot;$id&quot; ; \
1586 /sbin/modprobe --show-depends &quot;$id&quot;|sed &#39;s/^/ /&#39; ; \
1587 done
1588 &lt;/pre&gt;
1589
1590 &lt;p&gt;The output can look like this (only the first few entries as the
1591 list is very long on my test machine):&lt;/p&gt;
1592
1593 &lt;pre&gt;
1594 acpi:ACPI0003:
1595 insmod /lib/modules/2.6.32-5-686/kernel/drivers/acpi/ac.ko
1596 acpi:device:
1597 FATAL: Module acpi:device: not found.
1598 acpi:IBM0068:
1599 insmod /lib/modules/2.6.32-5-686/kernel/drivers/char/nvram.ko
1600 insmod /lib/modules/2.6.32-5-686/kernel/drivers/leds/led-class.ko
1601 insmod /lib/modules/2.6.32-5-686/kernel/net/rfkill/rfkill.ko
1602 insmod /lib/modules/2.6.32-5-686/kernel/drivers/platform/x86/thinkpad_acpi.ko
1603 acpi:IBM0071:PNP0511:
1604 insmod /lib/modules/2.6.32-5-686/kernel/lib/crc-ccitt.ko
1605 insmod /lib/modules/2.6.32-5-686/kernel/net/irda/irda.ko
1606 insmod /lib/modules/2.6.32-5-686/kernel/drivers/net/irda/nsc-ircc.ko
1607 [...]
1608 &lt;/pre&gt;
1609
1610 &lt;p&gt;If you want to help implementing a system to let us propose what
1611 packages to install when new hardware is plugged into a Debian
1612 machine, please send me an email or talk to me on
1613 &lt;a href=&quot;irc://irc.debian.org/%23debian-devel&quot;&gt;#debian-devel&lt;/a&gt;.&lt;/p&gt;
1614
1615 &lt;p&gt;&lt;strong&gt;Update 2013-01-15:&lt;/strong&gt; Rewrite &quot;cat $(find ...)&quot; to
1616 &quot;find ... -print0 | xargs -0 cat&quot; to make sure it handle directories
1617 in /sys/ with space in them.&lt;/p&gt;
1618 </description>
1619 </item>
1620
1621 <item>
1622 <title>Moved the pymissile Debian packaging to collab-maint</title>
1623 <link>http://www.hungry.com/~pere/blog/Moved_the_pymissile_Debian_packaging_to_collab_maint.html</link>
1624 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Moved_the_pymissile_Debian_packaging_to_collab_maint.html</guid>
1625 <pubDate>Thu, 10 Jan 2013 20:40:00 +0100</pubDate>
1626 <description>&lt;p&gt;As part of my investigation on how to improve the support in Debian
1627 for hardware dongles, I dug up my old Mark and Spencer USB Rocket
1628 Launcher and updated the Debian package
1629 &lt;a href=&quot;http://packages.qa.debian.org/pymissile&quot;&gt;pymissile&lt;/a&gt; to make
1630 sure udev will fix the device permissions when it is plugged in. I
1631 also added a &quot;Modaliases&quot; header to test it in the Debian archive and
1632 hopefully make the package be proposed by jockey in Ubuntu when a user
1633 plug in his rocket launcher. In the process I moved the source to a
1634 git repository under collab-maint, to make it easier for any DD to
1635 contribute. &lt;a href=&quot;http://code.google.com/p/pymissile/&quot;&gt;Upstream&lt;/a&gt;
1636 is not very active, but the software still work for me even after five
1637 years of relative silence. The new git repository is not listed in
1638 the uploaded package yet, because I want to test the other changes a
1639 bit more before I upload the new version. If you want to check out
1640 the new version with a .desktop file included, visit the
1641 &lt;a href=&quot;http://anonscm.debian.org/gitweb/?p=collab-maint/pymissile.git&quot;&gt;gitweb
1642 view&lt;/a&gt; or use &quot;&lt;tt&gt;git clone
1643 git://anonscm.debian.org/collab-maint/pymissile.git&lt;/tt&gt;&quot;.&lt;/p&gt;
1644 </description>
1645 </item>
1646
1647 <item>
1648 <title>Lets make hardware dongles easier to use in Debian</title>
1649 <link>http://www.hungry.com/~pere/blog/Lets_make_hardware_dongles_easier_to_use_in_Debian.html</link>
1650 <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Lets_make_hardware_dongles_easier_to_use_in_Debian.html</guid>
1651 <pubDate>Wed, 9 Jan 2013 15:40:00 +0100</pubDate>
1652 <description>&lt;p&gt;One thing that annoys me with Debian and Linux distributions in
1653 general, is that there is a great package management system with the
1654 ability to automatically install software packages by downloading them
1655 from the distribution mirrors, but no way to get it to automatically
1656 install the packages I need to use the hardware I plug into my
1657 machine. Even if the package to use it is easily available from the
1658 Linux distribution. When I plug in a LEGO Mindstorms NXT, it could
1659 suggest to automatically install the python-nxt, nbc and t2n packages
1660 I need to talk to it. When I plug in a Yubikey, it could propose the
1661 yubikey-personalization package. The information required to do this
1662 is available, but no-one have pulled all the pieces together.&lt;/p&gt;
1663
1664 &lt;p&gt;Some years ago, I proposed to
1665 &lt;a href=&quot;http://lists.debian.org/debian-devel/2010/05/msg01206.html&quot;&gt;use
1666 the discover subsystem to implement this&lt;/a&gt;. The idea is fairly
1667 simple:
1668
1669 &lt;ul&gt;
1670
1671 &lt;li&gt;Add a desktop entry in /usr/share/autostart/ pointing to a program
1672 starting when a user log in.&lt;/li&gt;
1673
1674 &lt;li&gt;Set this program up to listen for kernel events emitted when new
1675 hardware is inserted into the computer.&lt;/li&gt;
1676
1677 &lt;li&gt;When new hardware is inserted, look up the hardware ID in a
1678 database mapping to packages, and take note of any non-installed
1679 packages.&lt;/li&gt;
1680
1681 &lt;li&gt;Show a message to the user proposing to install the discovered
1682 package, and make it easy to install it.&lt;/li&gt;
1683
1684 &lt;/ul&gt;
1685
1686 &lt;p&gt;I am not sure what the best way to implement this is, but my
1687 initial idea was to use dbus events to discover new hardware, the
1688 discover database to find packages and
1689 &lt;a href=&quot;http://www.packagekit.org/&quot;&gt;PackageKit&lt;/a&gt; to install
1690 packages.&lt;/p&gt;
1691
1692 &lt;p&gt;Yesterday, I found time to try to implement this idea, and the
1693 draft package is now checked into
1694 &lt;a href=&quot;http://anonscm.debian.org/viewvc/debian-edu/trunk/src/hw-support-handler/&quot;&gt;the
1695 Debian Edu subversion repository&lt;/a&gt;. In the process, I updated the
1696 &lt;a href=&quot;http://packages.qa.debian.org/d/discover-data.html&quot;&gt;discover-data&lt;/a&gt;
1697 package to map the USB ids of LEGO Mindstorms and Yubikey devices to
1698 the relevant packages in Debian, and uploaded a new version
1699 2.2013.01.09 to unstable. I also discovered that the current
1700 &lt;a href=&quot;http://packages.qa.debian.org/d/discover.html&quot;&gt;discover&lt;/a&gt;
1701 package in Debian no longer discovered any USB devices, because
1702 /proc/bus/usb/devices is no longer present. I ported it to use
1703 libusb as a fall back option to get it working. The fixed package
1704 version 2.1.2-6 is now in experimental (didn&#39;t upload it to unstable
1705 because of the freeze).&lt;/p&gt;
1706
1707 &lt;p&gt;With this prototype in place, I can insert my Yubikey, and get this
1708 desktop notification to show up (only once, the first time it is
1709 inserted):&lt;/p&gt;
1710
1711 &lt;p align=&quot;center&quot;&gt;&lt;img src=&quot;http://www.hungry.com/~pere/blog/images/2013-01-09-hw-autoinstall.png&quot;&gt;&lt;/p&gt;
1712
1713 &lt;p&gt;For this prototype to be really useful, some way to automatically
1714 install the proposed packages by pressing the &quot;Please install
1715 program(s)&quot; button should to be implemented.&lt;/p&gt;
1716
1717 &lt;p&gt;If this idea seem useful to you, and you want to help make it
1718 happen, please help me update the discover-data database with mappings
1719 from hardware to Debian packages. Check if &#39;discover-pkginstall -l&#39;
1720 list the package you would like to have installed when a given
1721 hardware device is inserted into your computer, and report bugs using
1722 reportbug if it isn&#39;t. Or, if you know of a better way to provide
1723 such mapping, please let me know.&lt;/p&gt;
1724
1725 &lt;p&gt;This prototype need more work, and there are several questions that
1726 should be considered before it is ready for production use. Is dbus
1727 the correct way to detect new hardware? At the moment I look for HAL
1728 dbus events on the system bus, because that is the events I could see
1729 on my Debian Squeeze KDE desktop. Are there better events to use?
1730 How should the user be notified? Is the desktop notification
1731 mechanism the best option, or should the background daemon raise a
1732 popup instead? How should packages be installed? When should they
1733 not be installed?&lt;/p&gt;
1734
1735 &lt;p&gt;If you want to help getting such feature implemented in Debian,
1736 please send me an email. :)&lt;/p&gt;
1737 </description>
1738 </item>
1739
1740 </channel>
1741 </rss>