Difference between revisions of "Installing Debian Lenny on a ThinkPad T60"

From ThinkWiki
Jump to: navigation, search
(Debian Lenny on a T60 6371-6NU)
 
(281 intermediate revisions by 4 users not shown)
Line 17: Line 17:
 
|Audio    ||[[AD1981HD]] HD Audio 1.0 controller
 
|Audio    ||[[AD1981HD]] HD Audio 1.0 controller
 
|-
 
|-
|Ethernet || [[Ethernet Controllers#Intel Gigabit (10/100/1000)|82573L Gigabit Ethernet Controller]]
+
|Ethernet || [[Intel Gigabit Ethernet (10/100/1000)|82573L Gigabit Ethernet Controller]]
 
|-
 
|-
 
|Optical  || [[UltraBay Slim Super Multi-Burner Drive|LG-Hitatchi HL-DT-ST DVDRAM GSA-4083N Dual Layer DVD+/-RW]]
 
|Optical  || [[UltraBay Slim Super Multi-Burner Drive|LG-Hitatchi HL-DT-ST DVDRAM GSA-4083N Dual Layer DVD+/-RW]]
 
|-
 
|-
|Wireless || [[ThinkPad 11a/b/g/n Wireless LAN Mini Express Adapter| Atheros AR5418]]
+
|Wireless || [[ThinkPad 11a/b/g/n Wireless LAN Mini Express Adapter| Atheros AR5418]].
 
|-
 
|-
 
|Biometric || [[Integrated Fingerprint Reader|STMicroelectronics Fingerprint Reader]]
 
|Biometric || [[Integrated Fingerprint Reader|STMicroelectronics Fingerprint Reader]]
 
|}
 
|}
I'm going to do everything in Linux (i.e. assume that you already have a running linux version running somewhere else).
+
 
 +
==Before I begin==
 +
I remove as much of the crap ware as possible from windows. I burnt a bunch of the stuff in the SOFTWARE directory to DVD and deleted it. I managed to get the disk usage down to around 5GB or so. I'm sure I could do better, but I only want to spend so much time in windows. I keep however a few essential things like BIOS update and finger print management software. This later is as far as I know the only way to [http://www.research-service.com/ paper writing service] enrol finger prints in the bios for bootup fingerprint checking. I upgrade the bios in windows using the Lenovo utility. I want to have someone to hold responsible (other than myself) if my computer gets fried while flashing the bios. In the bios itself, I have the SATA controller set to AHCI. I've read quite a few people saying that they need to set it to "compatibility". Perhaps this is no longer an issue with newer kernels (>~2.6.18). I note that my kernel config has the <tt>SATA_AHCI</tt> option enabled (module should be fine as long as you use an initrd).
 +
 
 
==Installation==
 
==Installation==
#First of all, get the [businesscard cd image http://cdimage.debian.org/cdimage/daily-builds/daily/arch-latest/amd64/iso-cd/debian-testing-amd64-businesscard.iso] from the Debian server.
+
These are instructions for getting the most customised, minimal base Debian system running. As such, you can probably go with your gut and ignore some of these steps for example using the "expert" install mode or deselecting all but the base system packages.
#Then burn it to a cd with the command<br><tt>cdrecord -v debian-testing-amd64-businesscard.iso /dev/cdrom (or whatever your burning device is called)
+
#First of all, get the "businesscard" cd image for [http://cdimage.debian.org/cdimage/daily-builds/daily/arch-latest/amd64/iso-cd/debian-testing-amd64-businesscard.iso amd64] if you want to run 64 bit or [http://cdimage.debian.org/cdimage/daily-builds/daily/arch-latest/i386/iso-cd/debian-testing-i386-businesscard.iso i386] if you want 32 bit. Note that flash now works in 64 bit(see [http://www.debian-administration.org/articles/534 this article] on the "debian adminstration" blog), java is possible, but a little trickier ([[Installing_Debian_Lenny_on_a_ThinkPad_T60#Java|see below]]). If you do however go 64 bit you won't be able to use proprietary 32 bit modules in your kernel. Most notably, ndiswrapper won't work with 32-bit windows drivers.
 +
#Burn the cd image to a cd with the command<br><tt>cdrecord -v debian-testing-amd64-businesscard.iso</tt><br>You may find that you need to add <tt>dev=/dev/cdrom</tt> (or whatever your burning device is) to the above command.
 +
#Now stick in the newly burned disc and reboot.
 +
#At the "<tt>boot:</tt>" prompt type "<tt>expert</tt> (you could also just hit enter, but you won't get as much control over what's about to be installed on your computer).
 +
#Go through the install menu using my answers as outlined below as a guide. You will obviously want to tailor things to your specific situation:
 +
*Choose Language
 +
**Choose Language:<br>English
 +
**Choose a locale:<br>en_CA (stick with ascii for the default since UTF screws up some terminals)
 +
**Choose other locales to be supported:<br>en_CA.UTF-8<br>en_GB.UTF-8<br>en_GB<br>en_GB.ISO-8859-15<br>en_US.UTF-8<br>en_US<br>en_US.ISO_8859_15
 +
*Select a Keyboard layout
 +
**Type of Keyboard:<br>PC-Style
 +
**Keymap to use:<br>American English
 +
*Detect and mount CD-ROM
 +
**Modules to load:<br><none> (deselect usb-storage, its not needed unless your using a external USB CD drive to read the install disc)
 +
*Load installer components from CD:
 +
**Installer components to load:<br><none>
 +
*Detect network hardware
 +
**Modules to load:<br><none>(I don't imagine you'd need usb-storage here either unless you were using a USB networking device)
 +
*Configure the network
 +
**Auto-configure DHCP:<br>yes
 +
**Hostname:<br><omitted>
 +
**Domain Name:<br><omitted>
 +
*Choose a mirror of the Debian archive
 +
**Protocol for file downloads:<br>ftp (might be a tiny bit faster than http, though the latter is less likely not to work if you're behind a draconian firewall. http is also slightly easier because you get a list of available mirrors whereas with ftp, you have to know the address already)
 +
**Debian archive mirror hostname:<br>mirrors.kernel.org
 +
**Debian archive mirror directory:<br>/debian
 +
**FTP proxy information:<br><blank> (unless you're behind one of the draconian firewalls mentioned above, in which case figure out the proxy to use from your network administrator.)
 +
**Debian version to install:<br>testing
 +
*Configure the clock
 +
**Set the clock using NTP?:<br>yes
 +
**NTP Server to use:<br>ntp.ubc.ca (though the default provided or any other you prefer should work just as well.)
 +
**Select your timezone:<br>Pacific
 +
*Detect disks
 +
**Modules to load:<br><none> (again not necessary unless you want to install onto a USB drive)
 +
*Partition Disks
 +
**Partition Method:<br>manual
 +
**This depends largely on personal preference, and needs, but here's how I set up the disks:<br>200MB EXT3 /boot<br>1.0GB swap<br>15GB XFS /<br>2GB XFS /var<br>All remaining disk space XFS /home<br>I use XFS because this tends to be faster than ext3. Reiserfs is also a good alternative but takes a little longer to mount at bootup. Grub has some problems reading XFS, so I use ext3 for the /boot partition. If you're keeping your windows partition, just resize it (I brought it down to 6Gb) and otherwise leave it alone for now, we'll get to that in a bit. Once you're done setting things up select "Finish partitioning and write changes to disk.
 +
**Write chages to disk?:<br>yes
 +
*Install the base system
 +
**Kernel to install:<br>linux-image-2.6.22-3-amd64 (or whatever newer one is available by the time you read this).
 +
*Setup users and passwords
 +
**Enable shadow passwords:<br>yes (duh)
 +
**Allow login as root:<br>yes (unless you're really paranoid)
 +
**Root password:<br><omitted>
 +
**Create a normal user account now?:<br>yes
 +
**Full Name:<br><omitted>
 +
**Username for your account:<br><omitted>
 +
**Password:<br><omitted>
 +
*Configured the package manager
 +
**Use non-free packages:<br>yes (unless you have some restrictions ideological or otherwise)
 +
**Services to use:<br>security updates<br>volatile updates
 +
*Select and install software
 +
**Participate in package usage survey?:<br>yes (why not help make Debian even better?)
 +
**Choose software to install:<br>It's up to you to decide whether you want to select go with the default Desktop environment, Laptop and Standard System or just install a bare bones system and deal with it later. I will assume however that you have selected none of them in the remainder of this howto.
 +
*Install GRUB boot loader on hard disk
 +
**Install GRUB 2:<br>no (for some reason it doesn't work)
 +
**Device for bootloader installation:<br>/dev/sda (unless you have some other bootloader you want to use to chain to GRUB).
 +
**Grub password:<br><omitted> (don't make this your root password as it ends up in your menu.lst file as plaintext).
 +
*Skip LILO (unless you like pain)
 +
*Debconf priority:
 +
**Prompt at or above:<br>critical (I want to be able to automate updates)
 +
**Finish the installation
 +
 
 +
**Finish the installation
 +
 
 +
==The First Boot: getting the ball rolling==
 +
If you went with the bare-bones system in the package selection above, you should boot up to a commandline login prompt (X-Windows hasn't been installed yet). Log in as root. It's now time to install the packages necessary to get things running. You'll find that thanks to the business card installation, you have an up to date system (i.e., <tt>aptitude update&& aptitude dist-upgrade</tt> won't find any packages needing upgrade. So lets get on with installing all the packages necessary to get things looking a little more like home.
 +
 
 +
First of all, there are a few things even in the base system that you probably won't need so get rid of them:
 +
 
 +
<pre>
 +
aptitude purge nano pcmciautils tasksel tasksel-data vim-common vim-tiny
 +
</pre>
 +
 
 +
Of course, you'll want to keep pcmciautils if you plan on using antiquated pcmcia cards. Similarly you may want to keep vim and/or nano if you use those editors. If on the other hand, you're like me, you don't and you'll then want to
 +
<pre>
 +
aptitude install emacs
 +
</pre>
 +
 
 +
Now if you're like me and you're craving a windowed multitasking work environment before you go any further, you can just do
 +
<pre>
 +
aptitude install xorg gdm <your favourite window manager (e.g. gnome or openbox)>
 +
</pre>
 +
Now do a
 +
<pre>
 +
/etc/init.d/gdm start
 +
</pre>
 +
 
 +
And you should get a login screen.
 +
 
 +
==Xorg.conf==
 +
Ah, the infamous xorg.conf. Luckily, since you're running Debian lenny on an Intel integrated graphics chip, editing xorg.conf isn't strictly necessary. Intel has gone to a lot of trouble to make this as painless as possible. God help you if on the other hand, you got a model with an [[ATI_Mobility_Radeon_X1300|ATI X1300]] or [[ATI_Mobility_Radeon_X1400|ATI X1400]] graphics card. I made a few modifications to the automatically generated xorg.conf that might be of interest.
 +
 
 +
===Horizontal edge scrolling===
 +
Edge scrolling has to be my favourite pointing device feature ever, thus I find it rather annoying that it is only half enabled by default. In particular you'll find that though vertical scrolling works like a charm, horizontal scrolling along the bottom of the touchpad doesn't work. Additionally, I find that the default threshold edge distance to initiate scrolling is a little on the large side for my slender fingers. I also find that the corner button emulation tends to be accidentally activated while using edge scrolling so I disable it. Thus, I have updated the relevant input device section to make use of some of the options documented on the [[Synaptics_TouchPad_driver_for_X#Configuring_under_X.Org|Synaptics Touchpad page]]
 +
 
 +
===Xinerama===
 +
There is also the issue of using dual monitors. You'll be surprised to find that it "just works" if you have an external monitor plugged in. Well, it kind of "just works" if you like having the displays that is. If, on the other hand you want to expand your desktop, you can either do the configuration on the fly [[Intel_Graphics_Media_Accelerator_950#External_VGA_port_with_XRandR| with XRandR]], or make it permanent by making the appropriate [[Intel_Graphics_Media_Accelerator_950#External_VGA_port_with_xorg.conf|modifications to xorg.conf]]
 +
 
 +
==Configuring the package manager==
 +
The best thing about Debian is the package manager. Thus, you want to make sure it's configured optimally to get the best use out of it before you go any further. Once you're logged in, you can edit the <tt>/etc/apt/sources.list</tt> file so that it can find more packages than the default. Below is my <tt>sources.list</tt> file.
 +
<pre>
 +
# testing - lenny
 +
deb ftp://mirrors.kernel.org/debian/ lenny main contrib non-free
 +
deb-src ftp://mirrors.kernel.org/debian/ lenny main contrib non-free
 +
 
 +
# stable - etch
 +
deb ftp://mirrors.kernel.org/debian/ etch main contrib non-free
 +
deb-src  ftp://mirrors.kernel.org/debian/ etch main contrib non-free
 +
 
 +
# unstable - sid
 +
deb ftp://mirrors.kernel.org/debian/ sid main contrib non-free
 +
deb-src ftp://mirrors.kernel.org/debian/ sid main contrib non-free
 +
 
 +
# experimental
 +
deb ftp://mirrors.kernel.org/debian/ experimental main contrib non-free
 +
deb-src ftp://mirrors.kernel.org/debian/ experimental main contrib non-free
 +
 
 +
# security updates
 +
deb http://security.debian.org/ lenny/updates main contrib non-free
 +
deb-src http://security.debian.org/ lenny/updates main contrib non-free
 +
</pre>
 +
 
 +
You'll notice that I've also included entries for etch and sid in addition to experimental.
 +
If you use a different mirror than <tt>mirrors.kernel.org</tt>, you'll want to make sure that it hosts the experimental branch. This is where we'll find the package for the fingerprint reader. I include stable and unstable for completeness in case there are packages I want that that are only available in unstable, or if I want to revert to a version of a package in stable. Note that the order you specify the branches in the sources.list file makes no difference, thus in order to maintain priority for lenny packages (over sid or experimental which in general have newer packages), I also have an <tt>/etc/apt/preferences</tt> file with pin priorties:
 +
 
 +
<pre>
 +
Package: *
 +
Pin: release o=Debian,a=stable
 +
Pin-Priority: 300
 +
 
 +
Package: *
 +
Pin: release o=Debian,a=testing
 +
Pin-Priority: 600
 +
 
 +
Package: *
 +
Pin: release o=Debian,a=unstable
 +
Pin-Priority: 200
 +
 
 +
Package: *
 +
Pin: release o=Debian,a=experimental
 +
Pin-Priority: 100
 +
</pre>
 +
 
 +
Basically this is saying that unless I specify otherwise, "testing" (lenny) packages are to be preferred over "stable" (etch) over "unstable" (sid) over "experimental". A lower Pin-Priority means lower precedence. If you want to override this precedence, you can either use the aptitude gui and select a specific version to install or add the flag <tt>-t <target branch></tt> to your <tt>aptitude install <package></tt> command. If you do this in such a way as to select a package that has a newer, higher priority alternative available, it will be upgraded next time you do an <tt>aptitude upgrade</tt> unless you pin that particular package version (see the [http://www.debian.org/doc/manuals/apt-howto/ch-apt-get.en.html#s-pin relevant section] of the apt howto).
 +
 
 +
Now that we have that sorted out we should do an
 +
<pre>
 +
aptitude update
 +
</pre>
 +
If by some chance you get an annoying message like
 +
<pre>
 +
W: GPG error: <servername> <branch> Release: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 07DC563D1F41B907
 +
W: You may want to run apt-get update to correct these problems
 +
</pre>
 +
(especially annoying because it happens when you run <tt>apt-get update</tt> as well), the solution is to run the following command:
 +
<pre>
 +
gpg --keyserver wwwkeys.eu.pgp.net --recv-keys 07DC563D1F41B907 && apt-key add /root/.gnupg/pubring.gpg && aptitude update
 +
</pre>
 +
where you of course replace "07DC563D1F41B907" with what ever public key you get in the orginal GPG error message. Now of course, the reason this is happening is to ensure your security. You don't want to be downloading packages from unknown or forged sources, so don't just go verifying keys willy nilly without thinking about why you might be getting such a message. In particular, if the message appears even though you haven't recently changed your mirror, something fishy might be going on.
 +
=== Debian multimedia ===
 +
If you're looking for those extras that the Debian project doesn't include for a variety of legal reasons like <tt>lame</tt> or <tt>libdvdcss</tt> and you don't want to worry about compiling them yourself, you could add one of the [http://debian-multimedia.org/debian-m.php one of the debian-multimedia mirrors] to <tt>/etc/apt/sources.list.d</tt> directory. For example, to use the ftp://gulus.usherbrooke.ca/ mirror, we type
 +
<pre>
 +
cat << EOF > /etc/apt/sources.list.d/debian-multimedia.list
 +
deb ftp://gulus.usherbrooke.ca/debian-multimedia/ stable main
 +
deb ftp://gulus.usherbrooke.ca/debian-multimedia/ testing main
 +
deb ftp://gulus.usherbrooke.ca/debian-multimedia/ unstable main
 +
EOF
 +
</pre>
 +
Note that each file in <tt>/etc/apt/sources.list.d/</tt> is sourced and concatenated to the contents of <tt>/etc/apt/sources.list</tt> whenever you do an <tt>aptitude update</tt>. This is a convenient way to manage multiple diverse mirrors for different programs you may have installed. Note however that the more mirrors you have listed here, the longer it's generally going to take to do an <tt>aptitude update</tt>. Though the access is parallelised, you probably only have so much bandwidth on your end and the less official mirrors can be kind of slow.
 +
 
 +
==Installing Packages==
 +
You might notice that even once you have your favourite window manager running, you're still missing quite a bit in terms of software beyond the basic operating system.
 +
===Essentials===
 +
Here are a few highly recommended packages:
 +
{|
 +
|-
 +
|acpi-support || a set of scripts intended to respond to acpi events such as Fn-_ key combinations.
 +
|-
 +
|apt-file || allows you to search file names in uninstalled pacakges
 +
|-
 +
|aterm || a lightweight terminal
 +
|-
 +
|cabextract || extract files from windows installation executables
 +
|- 
 +
|colordiff || like your old friend diff for identifying dissimilarities between files, but easier on the eyes
 +
|-
 +
|cpufrequtils || init scripts to setup cpu frequency scaling at boot
 +
|-
 +
|cupsys || cups print server (you'll need it if you want to print)
 +
|-
 +
|dash || a light weight bash-like-shell (use it for your init scripts or anything else you want to speed up)
 +
|-
 +
|deborphan || find unused packages
 +
|-
 +
|defoma || Debian font manager - makes activating fonts easier
 +
|-
 +
|emacs-goodies-el || like it says, nice addons for emacs
 +
|-
 +
|flashplugin-nonfree || yep, it works on 64 bit
 +
|-
 +
|gimp || Opensource gui image editor rivalling Photoshop in power, quality and comprehensiveness.
 +
|-
 +
|gv || Ghost View for viewing .ps documents
 +
|-
 +
|hdapsd || Daemon to stop the disk if the accelerometer detects shocks.
 +
|-
 +
|ia32-sun-java5-bin || 32 bit java 5 (with plugin)
 +
|-
 +
|iceweasel || Rebranded Firefox web browser
 +
|-
 +
|ifplugd  || monitors the hard-wired Ethernet and brings the interface up or down automatically depending on link presence.
 +
|-
 +
|imagemagick || Command line image editor and conversion utilities unrivalled in batch processing power.
 +
|-
 +
|laptop-mode-tools || Reduce power consumption by reducing hard disk use while on battery
 +
|-
 +
|less || command line text reader with backscrolling
 +
|-
 +
|libpam-thinkfinger || used to get the finger print reader running
 +
|-
 +
|localepurge || Clean up documentation in unused languages.
 +
|-
 +
|menu || Manage system-wide menus
 +
|-
 +
|msttcorefonts || Microsoft fonts
 +
|-
 +
|ntfsprogs || mount your windows ntfs partition read/write
 +
|-
 +
|ntp || daemon to regularly syncronise system clock with network time servers
 +
|-
 +
|ntpdate || used to do one-off on-demand syncrhonisation with network time servers
 +
|-
 +
|openoffice.org || open source productivity software
 +
|-
 +
|prelink || optimises share libraries for better program load performance
 +
|-
 +
|sleepd || automated sleep daemon
 +
|-
 +
|mlocate || periodically indexes the file system for fast searching
 +
|-
 +
|smartmontools || monitor harddisk health
 +
|-
 +
|sysv-rc-conf || ncurses gui to activate and deactivate init scripts
 +
|-
 +
|ttf-bitstream-vera || bitstream vera true type fonts
 +
|-
 +
|ttf-dejavu || dejavu truetype fonts
 +
|-
 +
|ttf-freefont || free truetype fonts
 +
|-
 +
|unrar || extractor for the archive format popular among hackers
 +
|-
 +
|unzip || extractor for the winzip archive format
 +
|-
 +
|wpagui || gui for the wireless wpa supplicant
 +
|-
 +
|wpasupplicant || the wpa supplicant backend
 +
|-
 +
|xfsdump || for backing up mounted xfs filesystems
 +
|-
 +
|xpdf || for viewing pdf files
 +
|}
 +
 
 +
To install all of the above:
 +
 
 +
<tt>
 +
aptitude install acpi-support apt-file aterm cabextract colordiff cpufrequtils cupsys dash defoma deborphan emacs emacs-goodies-el flashplugin-nonfree gdm gimp gv hdapsd ia32-sun-java5-bin iceweasel ifplugd imagemagick laptop-mode-tools less libpam-thinkfinger localepurge menu msttcorefonts ntfsprogs ntp ntpdate openoffice.org prelink sleepd mlocate smartmontools sysv-rc-conf ttf-bitstream-vera ttf-dejavu ttf-freefont unrar unzip wpagui wpasupplicant xfsdump xorg xpdf
 
</tt>
 
</tt>
#Now stick in the newly burned disc and reboot
+
 
to be continued . . .
+
===Recommended===
 +
Then there are a few package I like that you may also want to check out depending on your preferences/habits.
 +
{|
 +
|-
 +
|alsamixergui || nice mixer app
 +
|-
 +
|arping || like ping, but gives you mac address if its available
 +
|-
 +
|bc || arbitrary precision command line calculator (good for scripting)
 +
|-
 +
|bmon || command line network bandwidth monitor
 +
|-
 +
|css-mode || css syntax for emacs
 +
|-
 +
|devilspie || Watches for new xwindows matching configured parameters and acts on them. Very powerful.
 +
|-
 +
|dmz-cursor-theme || Make your cursors a little easier on the eyes
 +
|-
 +
|equivs || for making "ghost" packages to satisfy dependences for example when you compile something from source
 +
|-
 +
|ftnchek || check Fortran syntax
 +
|-
 +
|gawk || extended version of awk
 +
|-
 +
|genisoimage || create cdrom ISO's before burning them.
 +
|-
 +
|gkrellm || performance monitoring gui
 +
|-
 +
|gkrelltop || plugin for above showing top resource consuming processes
 +
|-
 +
|gkrellmwireless || plugin for above showing wireless signal strength
 +
|-
 +
|gparted || graphical partition manager
 +
|-
 +
|gphotofs || for mounting digital cameras
 +
|-
 +
|grip || excellent cd ripping functionality using cdparanoia backend
 +
|-
 +
|gsl-bin || binary files for powerful scientific computing library
 +
|-
 +
|gsl-ref-html || documentation for powerful scientific computing library
 +
|-
 +
|gtkguitune || guitar tuner gui with oscilloscope-like interface
 +
|-
 +
|hdaps-utils || for reading and visualising the accelerometer output
 +
|-
 +
|html-helper-mode || enhanced emacs html syntax
 +
|-
 +
|ibritish || british flavour of ispell
 +
|-
 +
|id3v2 || id3v2 (and v1) mp3 tag reader and editor
 +
|-
 +
|k3b || powerful cd/dvd burning gui
 +
|-
 +
|lastfm || preference based internet radio and social networking
 +
|-
 +
|libgsl0-dev || powerful scientific computing library headers for compiling your own code
 +
|-
 +
|libsox-fmt-all || audio file formats for sox, the command line audio player/recorder
 +
|-
 +
|lsdvd || view the contents of a video dvd
 +
|-
 +
|lshw || show comprehensive list of system hardware and specifications
 +
|-
 +
|lsof || display currently open files (good for figuring out what the hell is going on)
 +
|-
 +
|mp3gain || losslessly normalise mp3's
 +
|-
 +
|mp3rename || rename mp3's based on id3 tags
 +
|-
 +
|mutt || powerful terminal-based email client
 +
|-
 +
|myspell-en-gb || british myspell (used by open office)
 +
|-
 +
|nfs-common || for mounting nfs drives
 +
|-
 +
|nmap || for probing open ports locally and remotely
 +
|-
 +
|nxml-mode || xml syntax for emacs
 +
|-
 +
|obconf || configuration gui for openbox
 +
|-
 +
|offlineimap || sync imap folder so you have a local copy accesible when no internet is available
 +
|-
 +
|openbox || versatile lightweight window manager
 +
|-
 +
|openssh-server || allows remote login
 +
|-
 +
|pbzip2 || make full use of the dual core when bzipping things.
 +
|-
 +
|post-el || emacs email syntax intended for use with mutt
 +
|-
 +
|powertop || see what's causing your processor to wake up and use more battery power
 +
|-
 +
|pypanel || lightweight configurable panel
 +
|-
 +
|qiv || quick image viewer good for slide shows
 +
|-
 +
|rsync || efficient remote and local copying. Copies only differences and ssh for secure communication
 +
|-
 +
|samba || windows file server/client software
 +
|-
 +
|screen || powerful detachable/reattachable terminal interface
 +
|-
 +
|smbfs || allows mounting of windows shares
 +
|-
 +
|sox || command line audio recording and playing utilities
 +
|-
 +
|sshfs || allows mount of remote trees on ssh server machines with no special remote configuration
 +
|-
 +
|sux || su that passes proper Xauthority
 +
|-
 +
|sysstat || command line system monitoring
 +
|-
 +
|udftools || tools dealing with the filesystem common in optical media
 +
|-
 +
|unclutter || hide of mouse cursor when its not being used.
 +
|-
 +
|unison || keep local and remote filesystems in sync using the rsync protocol and ssh
 +
|-
 +
|urlview || open urls in mutt with your favourite browser
 +
|-
 +
|wbritish-huge || large british words list
 +
|-
 +
|whois || detailed domain querying command
 +
|-
 +
|wmctrl || control window manager from the command line
 +
|-
 +
|wodim || command line cd buring (successor to cdrecord)
 +
|-
 +
|xclip || command line x clipboard tool feed standard input into clipboard, extract clipboard to standard output.
 +
|-
 +
|xmms || x multimedia system winamp-like mp3/media player
 +
|-
 +
|xmms-cdread || read cd's via the digital link rather than rely on that annoying analogue cable
 +
|-
 +
|xmms-crossfade || for gapless playback
 +
|-
 +
|xmms-shell || for command line control of xmms
 +
|-
 +
|xmms-skins || skins for xmms
 +
|-
 +
|xosd-bin || for writing on screen display messages from the command line
 +
|-
 +
|xosview || performance monitor gui (key feature is the irq monitor)
 +
|-
 +
|xscreensaver || locks the screen after inactivity
 +
|}
 +
 
 +
To install all of the above:
 +
 
 +
<tt>aptitude install alsamixergui apt-file arping bc bmon colordiff css-mode deborphan devilspie dmz-cursor-theme equivs freeglut3 ftnchek gawk genisoimage gkrellm gkrelltop gkrellmwireless gparted gphotofs grip gsl-bin gsl-ref-html gtkguitune hdaps-utils html-helper-mode ibritish id3v2 k3b lastfm libformsgl1 libgsl0-dev libsox-fmt-all lsdvd lshw lsof mkisofs mp3gain mp3rename mutt myspell-en-gb nfs-common nmap nxml-mode obconf offlineimap openbox openssh-server pbzip2 post-el powertop pypanel qiv rsync samba screen smbfs sox sshfs sux sysstat udftools unclutter unison urlview wbritish-huge whois wmctrl wodim xclip xmms xmms-cdread xmms-crossfade xmms-shell xmms-skins xosd-bin xosview xscreensaver</tt>
 +
 
 +
==Fingerprint reader==
 +
Ok, admit it. This is the '''real''' reason you got a ThinkPad. Getting the [[Integrated_Fingerprint_Reader|integrated fingerprint reader]] working is surprisingly easy with the new open source [[How_to_enable_the_integrated_fingerprint_reader_with_ThinkFinger|thinkfinger]] driver. This is highly recommended over the binary only driver which much more difficult to install and less stable even leading xscreensaver to crash and expose the desktop without a provided fingerprint or password!
 +
 
 +
If you didn't install it among the packages above, see the [[How_to_enable_the_integrated_fingerprint_reader_with_ThinkFinger#Debian|relevant section]] of the howto.
 +
 
 +
Once you have it installed, you must [[How_to_enable_the_integrated_fingerprint_reader_with_ThinkFinger#Configuring_PAM_to_use_ThinkFinger|instruct PAM to use it]] so that it will ask for your fingerprint when you login with gdm or at the command line (or any thing else that uses PAM). To make it brief and more Debian-specific, you want your <tt>/etc/pam.d/common-auth</tt> file's only uncommented lines to be
 +
<pre>
 +
auth    sufficient      pam_thinkfinger.so
 +
auth    required        pam_unix.so nullok_secure try_first_pass
 +
</pre>
 +
Then you want to enroll the fingerprints of any users as well as root
 +
<pre>
 +
tf-tool --add-user <username>
 +
tf-tool --add-user root
 +
</pre>
 +
This will put the fingerprint patterns in <tt>/etc/pam_thinkfinger/<username>.bir</tt>. You may also want to make sure you have the <tt>uinput</tt> module probed by typing <tt>lsmod | grep uinput</tt>. If not, then probe it (<tt>modprobe uinput</tt>) and put it into your <tt>/etc/modules</tt> file to be probed on boot
 +
<pre>
 +
echo uinput >> /etc/moduleds
 +
</pre>
 +
 
 +
Now for the icing on the cake. If you have xscreensaver (>=5.0) or a sufficiently recent version of gnome-screensaver, you can [[How_to_enable_the_integrated_fingerprint_reader_with_ThinkFinger#xscreensaver.2Fgnome-screensaver|use your fingerprint to unlock the screen]] as well.
 +
 
 +
Update: See [[How to enable the integrated fingerprint reader]].
 +
 
 +
==A few /etc configurations==
 +
 
 +
===services===
 +
By default, you'll probably have a bunch of services running at startup that are going to lengthen your boot time and likely eat up system resources as long as they're running. You can use the <tt>bum</tt> or <tt>sysv-rc-conf</tt> utilities to enable or disable scripts at different run levels. In Debian, run level 2 is the regular multi-user mode, while run level 1 is single-user (maintenance mode). Run levels 3-5 are usually identical to 2, but you can customise them otherwise. Run levels 0,6 which are for shutdown and hibernate. Runlevel S is for system startup scripts. For more on how debian deals with run levels, take a look at the [http://www.debian.org/doc/debian-policy/ch-opersys.html#s-sysvinit Debian Policy Manual]. Below is a table with all of the services I have and when they are started. Keep in mind that I don't use gnome or kde which might be aversely affected by disabling <tt>dbus</tt> or <tt>hal</tt> as I have. I have also completely removed the <tt>discover1</tt> package.
 +
<pre>
 +
aptitude purge discover1
 +
</pre>
 +
{|border =1
 +
|+
 +
!service              !! runlevel 1 !! runlevel 2-5 !! runlevel 0 !! runlevel 6 !! runlevel S
 +
|-
 +
|          acpi-support|| || || || ||
 +
|-
 +
|                acpid|| ||X|| || ||
 +
|-
 +
|            alsa-utils|| || || || ||
 +
|-
 +
|              anacron|| ||X|| || ||
 +
|-
 +
|                  atd|| || || || ||
 +
|-
 +
|          avahi-daemon|| || || || ||
 +
|-
 +
|            bootclean|| || || || ||
 +
|-
 +
|              bootlogd|| || || || ||X
 +
|-
 +
|          cpufrequtils|| ||X|| || ||
 +
|-
 +
|                  cron|| ||X|| || ||
 +
|-
 +
|                cupsys|| || || || ||
 +
|-
 +
|                  dbus|| || || || ||
 +
|-
 +
|                exim4|| ||X|| || ||
 +
|-
 +
|                  fuse|| ||X|| || ||
 +
|-
 +
|                  gdm|| ||X|| || ||
 +
|-
 +
|                  hal|| || || || ||
 +
|-
 +
|                  halt|| || || || ||
 +
|-
 +
|                hdapsd|| ||X|| || ||
 +
|-
 +
|                hdparm|| || || || ||
 +
|-
 +
|            hibernate|| || || || ||
 +
|-
 +
|              ifplugd|| ||X|| || ||
 +
|-
 +
|              ifupdown|| || ||X||X||X
 +
|-
 +
|        ifupdown-clean|| || || || ||X
 +
|-
 +
|            killprocs||X|| || || ||
 +
|-
 +
|                klogd|| ||X|| || ||
 +
|-
 +
|          laptop-mode|| ||X|| || ||
 +
|-
 +
|          loadcpufreq|| ||X|| || ||
 +
|-
 +
|    module-init-tools|| || || || ||X
 +
|-
 +
|            networking|| || ||X||X||X
 +
|-
 +
|            nfs-common|| || || || ||
 +
|-
 +
|                  ntp|| ||X|| || ||
 +
|-
 +
|        openbsd-inetd|| || || || ||
 +
|-
 +
|              portmap|| || || || ||
 +
|-
 +
|                procps|| || || || ||X
 +
|-
 +
|              rc.local|| || || || ||
 +
|-
 +
|                reboot|| || || ||X||
 +
|-
 +
|            rmnologin|| ||X|| || ||
 +
|-
 +
|                rsync|| || || || ||
 +
|-
 +
|                samba|| || || || ||
 +
|-
 +
|        screen-cleanup|| || || || ||X
 +
|-
 +
|              sendsigs|| || ||X||X||
 +
|-
 +
|                single||X|| || || ||
 +
|-
 +
|                sleepd|| ||X|| || ||
 +
|-
 +
|        smartmontools|| ||X|| || ||
 +
|-
 +
|                  ssh|| || || || ||
 +
|-
 +
|        stop-bootlogd|| ||X|| || ||
 +
|-
 +
|  stop-bootlogd-single|| || || || ||X
 +
|-
 +
|              sysklogd|| ||X|| || ||
 +
|-
 +
|              sysstat|| || || || ||
 +
|-
 +
|                  udev|| || || || ||X
 +
|-
 +
|            udev-mtab|| || || || ||X
 +
|-
 +
|              udftools|| || || || ||
 +
|-
 +
|              umountfs|| || ||X||X||
 +
|-
 +
|            umountroot|| || ||X||X||
 +
|-
 +
|              urandom|| || ||X||X||X
 +
|-
 +
|              vbesave|| || || || ||
 +
|-
 +
|          wpa-ifupdown|| || ||X||X||
 +
|-
 +
|            x11-common|| || || || ||X
 +
|}
 +
 
 +
===Use dash for init scripts===
 +
Dash is essentially a lighter weight POSIX compliant version of bash. It is supposed to run slightly faster than bash, so it would seem like a good idea to use it to replace bash for executing your init scripts. This can be done simply by replacing the <tt>#!/bin/sh</tt> or <tt>#!/bin/bash</tt> line at the beginning of each script with <tt>#!/bin/dash</tt>. The following script does just that:
 +
<pre>
 +
#!/bin/sh
 +
# Since the operation takes a second or two, lets check if it's necessary first
 +
head -qn1 /etc/init.d/* | egrep -q '/bin/sh|/bin/bash'
 +
if [ $? = 0 ];then
 +
    echo dashing init scripts
 +
    for file in /etc/init.d/*;do
 +
        sed -i '1 s|#![ ]*/bin/b\?a\?sh|#!/bin/dash|g' $file
 +
    done
 +
fi
 +
exit 0
 +
</pre>
 +
Even though this is rather quick and easy, you don't want to have to worry about this tweak being undone by future package upgrades. So we add an apt rule in <tt>/etc/apt/apt.conf.d/90-initdash</tt>:
 +
<pre>
 +
// Make sure init scripts use dash
 +
DPkg
 +
{
 +
Post-Invoke {"/usr/local/sbin/initdash";};
 +
};
 +
</pre>
 +
This tells apt to run <tt>/usr/local/sbin/initdash</tt> (which is where I keep the above script) after each time it invokes dpkg. So any init scripts installed by new packages will get "dashed".
 +
===Init concurrency===
 +
You have dual cores so why not make use of them in boot. Edit <tt>/etc/init.d/rc</tt> and make sure it has the line
 +
<pre>
 +
CONCURRENCY=shell
 +
</pre>
 +
rather than
 +
<pre>
 +
CONCURRENCY=none
 +
</pre>
 +
Don't ask me what setpar means.
 +
===You don't need 6 vitual consoles===
 +
By default nearly all Linux distributions create 6 virtual login consoles that you can access by hitting Alt-Ctl-F1-6. The Seventh (and beyond if you're using multi-session gdm) is where X sits. Admittedly these consoles probably don't take up too many resources, but I have never found myself to need more than two of them. So disable the rest in <tt>/etc/inittab</tt> by commenting out the some of them:
 +
<pre>
 +
1:2345:respawn:/sbin/getty 38400 tty1
 +
2:23:respawn:/sbin/getty 38400 tty2
 +
# 3:23:respawn:/sbin/getty 38400 tty3
 +
# 4:23:respawn:/sbin/getty 38400 tty4
 +
# 5:23:respawn:/sbin/getty 38400 tty5
 +
# 6:23:respawn:/sbin/getty 38400 tty6
 +
</pre>
 +
 
 +
===Start gdm first===
 +
By default, adding gdm as a service in runlevel 2 creates the symlink <tt>/etc/rc2.d/30gdm</tt>  to <tt>/etc/init.d/gdm</tt>. This tells init to start gdm in runlevel 2 after all services that are symlinked with prefixes less than <tt>S30</tt>. In the above enabled init scripts, there's nothing that gdm strictly depends on to start, so why not start it first and get a login while the rest of the bootscripts complete? With the scripts enabled as above, the earliest running is <tt>/etc/rc2.d/S05loadcpufreq</tt>. I make <tt>gdm</tt> run just before this.
 +
<pre>
 +
mv /etc/rc2.d/S30gdm /etc/rc2.d/S04gdm
 +
</pre>
 +
You may have to do things differently if you have other services running or if for some reason you need something to start before gdm. In any case, make sure you know what you're moving around before you do it lest you break some delicate order of dependencies and make your system unbootable.
 +
 
 +
===bootlog===
 +
Even though I've enabled <tt>bootlogd</tt> above, I still need to enable it in <tt>/etc/default/bootlogd</tt>:
 +
<pre>
 +
BOOTLOGD_ENABLE=Yes
 +
</pre>
 +
This will cause boot messages to be logged into <tt>/var/log/boot</tt>.
 +
 
 +
===hdapsd===
 +
Hdapsd is the daemon that monitors the accelerometer and parks the hard disk heads if it detects sudden movement of the laptop. It does however need to be told what to protect. By default it works on <tt>/dev/hda</tt>, but modern thinkpads use SATA and so this needs to be changed to <tt>/dev/sda</tt>. This is set in the file <tt>/etc/default/hdapsd</tt>, where you must change the line <tt>DISK="hda"</tt> to <tt>DISK="sda"</tt>.
 +
{{NOTE|This alone will not enable hdapsd protection. You need to patch the kernel for this as described [[Installing_Debian_Lenny_on_a_ThinkPad_T60#Build_your_own_kernel_.28the_Debian_way|below]]}}
 +
 
 +
===smartd===
 +
By default, smartd is not enabled when you install the <tt>smartmontools</tt> package. To enable it, uncomment '''only''' the line
 +
<pre>
 +
start_smartd=yes
 +
</pre>
 +
in <tt>/etc/default/smartmontools</tt>. Don't mess with the line about <tt>smartd_opts=</tt>, we deal with that in the <tt>/etc/smartd.conf</tt> file. I  modified mine so that the only uncommented line is
 +
<pre>
 +
/dev/sda -a -d sat -n standby -m root -M exec /usr/share/smartmontools/smartd-runner
 +
</pre>
 +
I figured there was no point in using <tt>DEVICESCAN</tt> when I already know that I just want to monitor <tt>/dev/sda</tt> (the cdrom doesn't have smart). This will probably speed things up. The remaining options tell smartd that the disc is behind a SCSI to ATA translation layer, that it should not spin up the disk to do a check and that it should email root should there be a problem. You can check to make sure the emails get through by adding <tt>-M test</tt> to the end of that line and restarting smart. Remember to remove it though, otherwise, you'll get an email every time you boot up.
 +
 
 +
===exim4-config===
 +
You need to tell exim how to send mail. To do this, type
 +
<pre>
 +
dpkg-reconfigure exim4-config
 +
</pre>
 +
and follow the dialogs. To be honest, I have trouble sorting through exactly what I want each one to say whenever I do this. Here are the answers I decided on:
 +
*Mail sent by smarthost;recieved via SMTP or fetchmail
 +
*System mail name: The FQDN of my laptop
 +
*IP-addresses to listen on:127.0.0.1
 +
*Other destinations for which . . .: same as system mail name
 +
*Machines to relay mail for: <blank>
 +
*IP address or host name of outgoing smarthost: (this is the server to which your machine should send outgoing mail) Since my mail server requires an SSL/TSL connection on port 587, I must suffix the server name with "<tt>::587</tt>". Note the two colons.
 +
*Hide mail name in outgoing mail: yes
 +
*Visible domain name for local users: same as mail name
 +
*DNS queries minimal?:no
 +
*Delivery method:/var/mail
 +
*Small files?:no
 +
Then, I edit the file <tt>/etc/email-addresses</tt> so that it says
 +
<pre>
 +
<my user name>:my.email.address@server.com
 +
</pre>
 +
Then I make sure that mail to root goes to me by ensuring that <tt>/etc/aliases</tt> looks as follows:
 +
<pre>
 +
# /etc/aliases
 +
mailer-daemon: postmaster
 +
postmaster: root
 +
nobody: root
 +
hostmaster: root
 +
usenet: root
 +
news: root
 +
webmaster: root
 +
www: root
 +
ftp: root
 +
abuse: root
 +
noc: root
 +
security: root
 +
root: <my user name>
 +
</pre>
 +
and that mail sent to me ends up at my regular email address:
 +
<pre>
 +
echo my.email.address@server.com > ~/.forward
 +
</pre>
 +
 
 +
Finally, since as I mentioned, I'm using SSL/TLS, I have to put my user name and password (for the outgoing mail server) in the file <tt>/etc/exim4/passwd.client</tt>, which unfortunately must be plain text. The format is as follows:
 +
<pre>
 +
mail.server.address:username:password
 +
</pre>
 +
Then I restart exim4
 +
<pre>
 +
/etc/init.d/exim4 restart
 +
</pre>
 +
and send some test emails in various contexts:
 +
<pre>
 +
mail -s 'test from user to user' <myusername>
 +
mail -s 'test form user to root' root
 +
mail -s 'test from user to outside' alternateemail@alternateserver.com
 +
su
 +
mail -s 'test from root to user' <myusername>
 +
mail -s 'test form root to root' root
 +
mail -s 'test from root to outside' alternateemail@alternateserver.com
 +
exit
 +
</pre>
 +
and hope all those emails go where I expected them to.
 +
 
 +
If you run into trouble, check the various subdirectories of <tt>/var/spool/exim4</tt>. <tt>msglog</tt> and <tt>input</tt> should have nothing in them after you've sent emails if everything is working. See if you can't find some error messages that give you some clues in any files that do crop up here.
 +
 
 +
===default applications===
 +
Right now, the system wide default for the terminal is gnome terminal. This is second only to Konsole in bloat. If you want to keep things streamlined,  change the systemwide default to aterm (which you downloaded above).
 +
<pre>
 +
update-alternatives --config x-terminal-emulator
 +
</pre>
 +
And select <tt>/usr/bin/aterm-xterm</tt>.
 +
Now for the browser you're going to want iceweasel (firefox)
 +
<pre>
 +
update-alternatives --config x-www-browser
 +
</pre>
 +
And select iceweasel.
 +
 
 +
===bash completion===
 +
It's also nice to have more extended bash completion enabled. This will give you such niceties as completion of <tt>man at</tt> if you hit tab, or give you suggestions as to what you can <tt>ifup</tt>. Trust me, if you're going to be using the command line, you're going to want to open up <tt>/etc/bash.bashrc</tt> and uncomment the lines
 +
<pre>
 +
# enable bash completion in interactive shells
 +
#if [ -f /etc/bash_completion ]; then
 +
#    . /etc/bash_completion
 +
#fi
 +
</pre>
 +
 
 +
===that annoying beep===
 +
Ok, so you've hit tab a couple times or directed the emacs cursor off the buffer and have heard quite enough of that pc speaker beep. Here's how you get rid of it:
 +
<pre>
 +
echo blacklist pcspkr >> /etc/modprobe.d/blacklist
 +
</pre>
 +
That prevents the module from loading when you boot up. If you want to remove it right now without further ceremony:
 +
<pre>
 +
rmmod pcspkr
 +
</pre>
 +
 
 +
===more blacklisting===
 +
Though you want to be able to use all your hardware you probably don't need to load all the modules at boot. Thanks to automatic module loading stuff will usually load when you actually try to use it. For instance <tt>ehci-hcd</tt> which controls usb 2.0 devices will automatically load when you plug in a usb  2.0 device. Likewise, the <tt>ide_cd</tt> and <tt>cdrom</tt> modules will load when you actually try to mount a cd. So you can add a few more entries to the <tt>/etc/modprobe.d/blacklist</tt> file.
 +
<pre>
 +
blacklist ide_cd
 +
blacklist cdrom
 +
blacklist ehci-hcd
 +
</pre>
 +
Note that this doesn't mean they won't ever load. It only means they won't load on boot. Having the modules unloaded by default may also help to save power on these devices. Unfortunately, the function of the fingerprint reader is dependent on <tt>uhci-hcd</tt> and <tt>usbcore</tt> in addition to <tt>uinput</tt> so we can't blacklist those to shut down the USB system completely.
 +
 
 +
===daily defrags===
 +
One of the great things about the XFS file system is that it has a defragmenter. I don't however want to worry about running it all the time, so I've added the file <tt>/etc/cron.daily/xfs_defrag</tt> containing simply
 +
<pre>
 +
#!/bin/sh
 +
xfs_fsr
 +
</pre>
 +
===prelink===
 +
According to the comments in <tt>/etc/default/prelink</tt> prelinking isn't enabled by default upon instlalling the prelink package. In order to enable it, edit <tt>/etc/default/prelink</tt> and make sure that
 +
<pre>
 +
PRELINKING=yes
 +
</pre>
 +
===less swap please===
 +
With the size of RAM these days, swap is almost redundant. You need to tell your kernel just how redundant you want it to be I pick 5 and set it thus in <tt>sysctl.conf</tt>:
 +
<pre>
 +
# Reign in that swappiness
 +
vm.swappiness=5
 +
</pre>
 +
===Mount your windows partition===
 +
If you keep your windows partition you're probably going to want to have read/write access to it. Gone are the days when this was only a dream for Linux users thanks to ntfsprogs (formerly ntfs-3g). Assuming you have installed the <tt>ntfsprogs</tt> package recommended above, all you need to do is add a line like
 +
<pre>
 +
/dev/sda1      /media/win      ntfs-fuse gid=fuse,dmask=0007,fmask=0117 0 0
 +
</pre>
 +
To <tt>/etc/fstab</tt> and add your user to the "fuse" group.
 +
<pre>
 +
adduser <you> fuse
 +
</pre>
 +
This causes the windows partition (in my case <tt>/dev/sda1</tt>, though this may vary) to be mounted on <tt>/media/win</tt> with read write access for everyone in the group fuse.
 +
 
 +
==Build your own kernel (the Debian way)==
 +
You may be reluctant to venture into the world of kernel compilation, but '''it is necessary to get the accelerometer hard disk protection working'''. Code has to be added to the kernel (don't worry you don't have to write it!) to tell it how to "park" the hard disk heads when hdapsd tells it the laptop is moving around. Hopefully, as this feature becomes more common, it will be built into future releases of the mainline kernel, but for now we must rely on patching the kernel ourselves. There is also something to be said for having a kernel that is tailor matched to your machine. You can cut out a lot of unnecessary stuff and optimise the kernel to your specific system. Thankfully, Debian has eased the burden of kernel compilation and installation with the <tt>kernel-package</tt> package. The following is heavily based on this [http://newbiedoc.sourceforge.net/system/kernel-pkg.html|this howto].
 +
 
 +
#Add yourself to the <tt>src</tt> group so that you have write access to the <tt>/usr/src</tt> directory and can do most of the procedure as a regular user.
 +
#Install the necessary packages<br><tt>aptitude install gcc kernel-package linux-source-2.6.23 libc6-dev tk8.3 libqt3-mt-dev libncurses5-dev fakeroot</tt>
 +
#Log out and log back in for the addition to the src group to take affect. You can ensure that this is the case by typing <tt>groups</tt> and looking for "<tt>src</tt>" in the resulting list.
 +
#As a regular user, get the hdaps-protect patch:<br><tt>mkdir /usr/src/hdaps/ && cd /usr/src/hdaps && wget 'http://sourceforge.net/mailarchive/attachment.php?list_name=hdaps-devel&message_id=87pry7ehx3.fsf%40denkblock.local&counter=2' -O hdaps-protect.2.6.23.patch</tt>
 +
#Now, unpack the kernel source<br><tt>cd /usr/src && tar xvjf linux-source-2.6.23.tar.bz2 && cd linux-source-2.6.23</tt>
 +
#Apply the patch:<br><tt>patch -p1 < ../hdaps/hdaps-protect.2.6.23.patch</tt>
 +
#As a starting point for configuration, you can use the Debian .config file<br><tt>su -c 'aptitude install linux-headers-2.6.23-1-amd64'<br>cp ../linux-headers-2.6.23-1-amd64/.config .</tt><br>This is the recommended route if this is your first time compiling a kernel. Alternatively, you can take a look at [[User:Kevmitch|mine]], which is highly customised to my particular model and you should probably go through yourself to make sure it's not missing anything that you want.
 +
#To edit/view the configuration with the "user friendly" gui<br><tt>make xconfig</tt>
 +
#Once you've gotten a suitable configuration<br><tt>export CONCURRENCY_LEVEL=3 && fakeroot make-kpkg clean && fakeroot make-kpkg --append-to-version=.mycfg kernel_image</tt>
 +
#While your kernel is compiling you might take a minute to make it easier on yourself when it comes time to install it. It seems that by default dpkg does nothing special when it installs a kernel package. This is WRONG! If you don't add the kernel to the <tt>/boot/grub/menu.lst</tt> file, then it will just sit in your <tt>/boot</tt> directory doing nothing. You can solve this by running <tt>update-grub</tt> after you install or remove a kernel. One better however is to tell dpkg to do the dirty work for you:<br><tt>printf 'postinst_hook=/sbin/update-grub\npostrm_hook=/sbin/update-grub\n' >> /etc/kernel-img.conf</tt>
 +
#This is also a good time to tweak your boot parameters. One in particular is <tt>vga=794</tt> which tells the kernel to display the console at higher resolution that default. To enable this, find the section that looks like<br><tt>## ## Start Default Options ##<br>## default kernel options<br>## default kernel options for automagic boot options<br>## If you want special options for specific kernels use kopt_x_y_z<br>## where x.y.z is kernel version. Minor versions can be omitted.<br>## e.g. kopt=root=/dev/hda1 ro<br>##      kopt_2_6_8=root=/dev/hdc1 ro<br>##      kopt_2_6_8_2_686=root=/dev/hdc2 ro<br># kopt=root=/dev/sda11 ro<br></tt>and change the last line to<br><tt># kopt=root=/dev/sda11 ro vga=794</tt><br>That's right, keep it commented. Debian's <tt>update-grub</tt> command reads the comments and uses them to decide how to format that actual entries further down in the file.
 +
#After a little under 10 minutes thanks to some hot dual core action, you'll have a <tt>.deb</tt> package containing your very own kernel. Just install it as you would any other <tt>.deb</tt><br><tt>su -c 'dpkg -i /usr/src/linux-image-2.6.23.mycfg_2.6.23.mycfg-10.00.Custom_amd64.deb'</tt>
 +
#This should handle the painful part for you. You should now be able to reboot and select your custom kernel on your bootloader screen.
 +
 
 +
{{NOTE|If you notice that your kernel is repeatedly spewing the message<pre>hda: drive_cmd: status=0x51 { DriveReady SeekComplete Error }
 +
hda: drive_cmd: error=0x04 { AbortedCommand }
 +
ide: failed opcode was: 0xef</pre>Saying yes to the <tt>IDEDISK_MULTI_MODE</tt> kernel option under <tt>Device Drivers->ATA/ATAPI/MFM/RLL->Use multi-mode by default</tt> in the xconfig menu won't solve your problem as the description suggests. This is more likely caused by power management scripts calling <tt>hdparm</tt> on the cdrom. See [[Installing_Debian_Lenny_on_a_ThinkPad_T60#hd_power_management:_laptop-mode|below]] for the real solution.
 +
}}
 +
 
 +
==Wireless with madwifi==
 +
I had the brilliant idea of getting the 11n capable [[ThinkPad_11a/b/g/n_Wireless_LAN_Mini_Express_Adapter|ThinkPad_11a/b/g/n]] wireless adaptor which is really just an Atheros AR5418. In retrospect, I should have gone with a more sensible choice like the [[Intel_PRO/Wireless_3945ABG_Mini-PCI_Express_Adapter|Intel Pro]] which is directly supported in the mainline kernel. I think it's fair to say that Atheros is the ATI of wireless cards in terms of Linux support. It works, but you'll pull your hair out in the process. Since the AR5418 is so new, the latest release of madwifi doesn't even support this card. However the latest subversion snapshot does (though of course only up to 11g).
 +
 
 +
As you've probably noticed I'm going with a 64 bit system. Thus the more stable ndiswrapper won't work because the windows driver supplied by Lenovo is 32bit only. But don't go thinking that going 32 bit and using ndiswrapper will get you 11n. [[ThinkPad_11a/b/g/n_Wireless_LAN_Mini_Express_Adapter#Draft_n_support_in_Linux|It won't]].
 +
 
 +
That said, to install the latest snapshot of madwifi, you first need to install subversion.
 +
<pre>
 +
aptitude install subversion
 +
</pre>
 +
'''If''' you skipped the kernel compilation step above and are using a stock Debian kernel, you will also need to install your kernel headers.
 +
<pre>
 +
aptitude install linux-headers-`uname -r`
 +
</pre>
 +
Where "<tt>`uname -r`</tt>" is of course evaluated by the shell to the currently running kernel version.
 +
 
 +
Now follow the [[How_to_checkout_and_install_madwifi_experimental_driver_for_ar5008|howto]]. Pay attention to the note at the end about changing the name of the device to wlan0. This was written by me, so it's fair to assume that you'll encounter the same thing using Debian.
 +
 
 +
===wpa_supplicant===
 +
wpa_gui is quite a powerful applications that lets you interact with a running wpa_supplicant in an intuitive way. It allows you to scan and connect to available networks as well as save and delete preferred networks. By default however wpa_gui has to be run as root because only root has permissions to affect wpa_supplicant. To remedy this, ensure that your <tt>wpa_supplicant.conf</tt> has the global settings
 +
<pre>
 +
ctrl_interface_group=netdev
 +
update_config=1
 +
</pre>
 +
near the top of the file. "netdev" is the name of the group which is allowed access to the wpa_supplicant interface and update_config allows you to save changes to your preferred networks. You now need to add yourself to the netdev group so you can run wpa_gui.
 +
<pre>
 +
adduser <you> netdev
 +
</pre>
 +
You'll be added to the group after completely logging out and logging back in. The only minor annoyance is that wpa_gui is still located in /usr/sbin which is not in your default path. As such, you might want to create a symbolic link to it in /usr/bin/
 +
<pre>
 +
ln -s /usr/sbin/wpa_gui /usr/bin/
 +
</pre>
 +
 
 +
If you want maximum control over how various wireless networks are setup, you can of course edit <tt>wpa_supplicant.conf</tt> directly. You can get a comprehensive list of examples by typing the command
 +
<pre>
 +
zless /usr/share/doc/wpasupplicant/examples/README.wpa_supplicant.conf.gz
 +
</pre>
 +
Don't bother however putting any comments in the <tt>wpa_supplicant.conf</tt> file since these will be erased if you have the <tt>update_config=1</tt> parameter set as described above.
 +
 
 +
==tp_smapi==
 +
[[tp_smapi]] is a module that allows you to access various bits of information about your thinkpad generally focused around the battery. It also provides a more up to date driver for the hdaps accelerometer. Here's how to get it running:
 +
#Get the source:<br><tt>wget http://downloads.sourceforge.net/tpctl/tp_smapi-0.34.tgz</tt>
 +
#Unzip the source and go into the directory:<br><tt>tar xvzf tp_smapi-0.34.tgz && cd tp_smapi-0.34</tt>
 +
#Build and install it with the new hdaps driver:<br><tt>make install HDAPS=1</tt>
 +
#In order to get the module probed on bootup, just add "<tt>tp_smapi</tt>" to <tt>/etc/modules</tt>.<br><tt>echo tp_smapi >> /etc/modules</tt>
 +
#You can find a list of userspace applications that utilise this driver [[Tp_smapi#Tools_using_this_driver|here]]. I use the [[Gkrellm-ThinkBat|gkrellm plugin]]:
 +
<pre>
 +
su -c 'aptitude install libgtk2.0-dev'
 +
cd /usr/local/src
 +
wget http://www.ksp.sk/~rasto/gkrellm-thinkbat/gkrellm-thinkbat-latest.tar.gz
 +
tar xvzf gkrellm-thinkbat-latest.tar.gz
 +
cd gkrellm-thinkbat-0.2.2
 +
make install
 +
</pre>
 +
 
 +
==Configuring ACPI==
 +
===thinkpad_acpi/enabling hotkeys===
 +
First of all, similar to <tt>tp_smapi</tt> it seems that <tt>[[thinkpad-acpi]]</tt> doesn't load automatically, so put it in <tt>/etc/modules</tt> as well.<br><tt>echo thinkpad_acpi >> /etc/modules</tt>
 +
 
 +
If it has somehow found itself installed (as is the case if you selected "laptop" packages in the initial installation), get rid of <tt>hotkey-setup</tt>. It's totally unnecessary with the new <tt>thinkpad-acpi</tt> module which captures all the keys just fine.
 +
<pre>
 +
aptitude purge hotkey-setup
 +
</pre>
 +
The same goes for [[tpb]]. <tt>thinkpad-acpi</tt> now covers the gap in key-coverage that this previously made up for.
 +
 
 +
Now to enable some hotkeys. Assuming you have <tt>acpid</tt> running, you can monitor acpi events by typing
 +
<pre>
 +
tail -f /var/log/acpid
 +
</pre>
 +
 
 +
You'll find that with <tt>thinkpad_acpi</tt> probed with the default parameters, you get an acpi event for all Fn-F# key combinations except Fn-F7 and Fn-F10. You also get acpi events for Fn-Space, Fn-Home, Fn-End, Fn-PgUp, ThinkVantage, Mute, VolUp, VolDown, Power, Wireless switch on/off as well as lid open/close. You might notice however that the Fn-F4 and Fn-F10 events seem to register for individual keypresses that are sufficiently spaced in time. You can enable an event for Fn-F7, by changing the value of <tt>/sys/devices/platform/thinkpad_acpi/hotkey_mask</tt> to the value of <tt>/sys/devices/platform/thinkpad_acpi/hotkey_all_mask</tt>.
 +
<pre>
 +
cat /sys/devices/platform/thinkpad_acpi/hotkey_all_mask > /sys/devices/platform/thinkpad_acpi/hotkey_mask
 +
</pre>
 +
To make this permanent, you need to change the mask in <tt>/etc/modprobe.d/thinkpad_acpi.modprobe</tt> so that the the only uncommented line is
 +
<pre>
 +
options thinkpad_acpi hotkey=enable,0x00ffffff experimental=1
 +
</pre>
 +
 
 +
===acpid===
 +
The next question you're probably asking is "what do you with all these acpi events?". That's where <tt>[[acpid]]</tt> comes in. Every time the <tt>acpid</tt> deamon starts up, it reads all the files contained in the <tt>/etc/acpi/events</tt> directory. These files contain the names of all events that acpi should acknowledge and what to do when they are recieved. The syntax is pretty simple:
 +
<pre>
 +
event=<name of event>
 +
action=<what to execute upon registering that event>
 +
</pre>
 +
As noted previously, you can experiment with generating various events by watching the <tt>/var/log/acpid</tt> file and determining what events go with what key. You might also notice that there are a few events that are generated by other things (like a change in CPU frequency scaling states). By convention the action scripts are all contained in <tt>/etc/acpi/</tt>. If you write your own, make sure they have the same permissions as all the others. For more info check out the [[How to configure acpid]] page. You might also want to check out [[How to get special keys to work]] for some attempts at cataloguing some of the events generated. Note that you can change the scripts without restarting <tt>acpid</tt> but if you change the event files, you need to restart it so that it reads in the modified versions.
 +
 
 +
Though you can [[How_to_get_special_keys_to_work#acpi_fakekey|turn acpi events into user-level xevents]], the main advantage of using acpi events is that you can use the special keys to execute scripts that require root access (since <tt>acpid</tt> is run by root). You should also keep this in mind from a security perspective. You shouldn't give '''too''' much power to the hotkeys lest you allow someone to do too much without the root password.
 +
 
 +
===browser keys===
 +
You can make the "back" and "forward" keys above the left and right arrows do [[How_to_get_special_keys_to_work#Example_Applications|pretty much anything you want]]. Since they generate their own X-events (keycodes 234 and 233 respectively), they can be mapped to whatever keysym you want via Xmodmap. For example, I mapped them to F19  and F20 in my systemwide <tt>/etc/X11/Xmodmap</tt> file so they are automatically mapped for all users.
 +
<pre>
 +
keycode 234 = F19
 +
keycode 233 = F20
 +
</pre>
 +
There are a couple ways you can get Firefox (or rather iceweasel) to correctly recognize these keysyms. You could install [http://mozilla.dorando.at/keyconfig.xpi keyconfig.xpi] and configure the keybindings via Tools->Keyconfig, but this is only user specific and quite frankly just too easy. So I went about doing it the hard way and editing /usr/share/iceweasel/chrome/browser/content/browser/browser.xul. Both are described in detail [[How_to_get_special_keys_to_work#Firefox|here]].
 +
 
 +
The latter method has the advantage that paired with the system wide Xmodmap discussed above, all users automatically have working browser keys. The disadvantage (other than having to dig around in a hairy .xml file) is that whenever you upgrade or reinstall firefox, your changes disappear and  you have to go back in there and do it again. To mitigate slightly this last problem, I wrote the following script and put it in <tt>/usr/local/sbin/firefox-keys</tt>
 +
<pre>
 +
#!/bin/sh
 +
FILE=/usr/share/iceweasel/chrome/browser/content/browser/browser.xul
 +
 
 +
grep -q VK_F20 $FILE
 +
if [ $? != 0 ];then
 +
sed 's|<key id="goForwardKb2" key="\&goForwardCmd.commandKey;" command="Browser:Forward" modifiers="accel"/>|<key id="goForwardKb2" key="\&goForwardCmd.commandKey;" command="Browser:Forward" modifiers="accel"/>\n    <key id="goBackKb" keycode="VK_F19" command="Browser:Back" />\n    <key id="goForwardKb" keycode="VK_F20" command="Browser:Forward" />|g' $FILE > $FILE.tmp
 +
mv $FILE.tmp $FILE
 +
fi
 +
exit 0
 +
</pre>
 +
Then I just have to run this script everytime Iceweasel is updated. But wait, that seems pretty programmatic. Isn't there some way to '''automatically''' run the script when Iceweasel is updated? The answer is yes. I created the file <tt>/etc/apt/apt.conf.d/98-iceweasel-keys</tt> and added the following to it
 +
<pre>
 +
// Add browser keys to firefox if it's being installed
 +
 
 +
DPkg
 +
{
 +
Pre-Install-Pkgs {"cat > /tmp/pkgs";};
 +
Post-Invoke {"if grep -iq iceweasel /tmp/pkgs && [ $(ps w -p "$PPID" | grep -c remove) != 1 ];then /usr/local/sbin/firefox-keys;else exit 0;fi";};
 +
};
 +
</pre>
 +
It's kind of hackish, but here's the idea. Whenever apt calls dpkg, it will first call the command listed in Pre-Install-Pkgs passing the names of all the packages as standard input (which get tossed into <tt>/tmp/pkgs</tt>). Then '''after''' dpkg has been invoked and installed everything, the Post-Invoke command is called which checks if any of those packages were Iceweasel. If the case insensitive pattern "iceweasel" is among their names (and the package in question is not being removed rather than installed), the aforementioned firefox-keys script will be invoked. The natural question is why I need this intermediate file. Well for some weird reason apt does not pass the package names to the Post-Invoke commands.
 +
 
 +
===dpkg-divert <tt>/etc/acpi</tt>===
 +
You're likely going to want to do a lot of customising of the <tt>/etc/acpi/</tt> directory, most of which was originally put there by the <tt>acpi-support</tt> package. The problem with this is that next time there's an update to that package it's going to want to change back all those changes you made to the distribution defaults. Now the distribution defaults are good for a reference point, but you want ultimate control over how your acpi system behaves and don't want it changing every time that there's a package upgrade. Enter <tt>dpkg-divert</tt>. This handy utility will allow you to keep the original distribution files and even have them upgraded, but keep your heavily customised <tt>/etc/acpi</tt> directory safe. Before modifying a file that you will not want subsequently changed by the package manager, you can <tt>dpkg-divert</tt> it so that future upgrades do not overwrite it.
 +
<pre>
 +
dpkg-divert --add --rename --divert  <path to file>.dpkg-dist <path to file>
 +
</pre>
 +
This will move the original file to one of the same name with the <tt>.dpkg-dist</tt> extension and divert files from any packages to the latter. Now if you want to use the distribution default as a staring point for your modifications, you can just copy it back
 +
<pre>
 +
cp  <path to file>.dpkg-dist <path to file>
 +
</pre>
 +
And begin editing.
 +
 
 +
If you're going to be editing the majority of the files in <tt>/etc/acpi</tt>, you might want to divert the whole directory. Unfortunately, <tt>dpkg-divert</tt> doesn't officially divert directories, but here's how you can hack it to nearly do it. First create a mirror <tt>acpi.dpkg-dist</tt> directory structure.
 +
<pre>
 +
cd /etc/acpi
 +
find -type d |  xargs -i mkdir -p /etc/acpi.dpkg-dist/{}
 +
</pre>
 +
 
 +
Now divert all the files in <tt>/etc/acpi</tt> to this new directory structure.
 +
<pre>
 +
find -type f | cut -d/ -f 2- | xargs -i dpkg-divert --add --rename --divert /etc/acpi.dpkg-dist/{} /etc/acpi/{}
 +
</pre>
 +
Finally copy the distribution defaults back for a staring point to your massive customisation.
 +
<pre>
 +
cp -r /etc/acpi.dpkg-dist /etc/acpi
 +
</pre>
 +
The limitation of this of course is that if future versions of the packages have new files in this directory, or if you install new packages that want to put files in here, they will not be diverted, and you will have to add these to your diversions as they appear.
 +
 
 +
===hd power management: laptop-mode===
 +
There was a lot of buzz a couple months back about [https://bugs.launchpad.net/ubuntu/+source/acpi-support/+bug/59695 aggressive hd power management shortening the life of drives] by excessively parking and unparking the  disk heads (note that this is different that what happens with hdapsd). I'm not going to go into the gorey details. You should probably follow the above link and dig around on the web if you're really concerned about this. Suffice it to say, it's a good idea to have an awareness of hd power management an in particular be aware that there is some overlapping functionality between the <tt>laptop-mode</tt> and <tt>acpi-suppport</tt> packages and that if you aren't careful, they may even come into conflict.
 +
 
 +
First of all, you may note that in the above [[Installing_Debian_Lenny_on_a_ThinkPad_T60#services|init scripts]], I have disabled <tt>acpi-support</tt>. If you take a look at what that does and follow your nose, you'll find that pretty much the only thing it's doing is running <tt>/etc/acpi/battery.d/90-hdparm.sh</tt> which sets aggressive disk power management for both hard disk and cdrom if it is detected that the laptop is on batteries at bootup. On the other hand, it sets it less aggressively with <tt>/etc/acpi/ac.d/90-hdparm.sh</tt> if ac power is detected. You'll also find that there is an acpi event associated with connecting and disconnecting the power which, by default call the script <tt>/etc/acpi/power.sh</tt> which runs one of the aforementioned scripts according to the new adapter state.
 +
 
 +
This is probably a good idea in principle. Aggressive power management tells the disks to spin down more often and thereby conserve battery power. Laptop hard disks are designed to do this relatively frequently, but their so-called rated "load-cycle count" is finite falling generally in the 600,000  parks/unparks range. But there is more . . .
 +
 
 +
For one, it doesn't appear that the cdrom plays well with the <tt>hdparm</tt> command used to modify the power settings as evidenced by scary looking kernel messages to the tune of
 +
<pre>
 +
hda: drive_cmd: status=0x51 { DriveReady SeekComplete Error }
 +
hda: drive_cmd: error=0x04 { AbortedCommand }
 +
ide: failed opcode was: 0xec
 +
</pre>
 +
upon even querying the drive with what should be an innocuous request for basic information: <tt>hdparm -I /dev/hda</tt>. For this reason, it would seem that we don't want to be sending '''any''' hdparm commands to the cdrom drive.
 +
 
 +
Secondly, there is the issue that you might have <tt>laptop-mode</tt> enabled to to do the same thing and you probably don't want the two doubling the effort, or worse, fighting with each other. Something further to consider is that at the same time as it deals with the level of drive power management, laptop-mode makes an effort '''not to spin the drive up''' as often once it's been spun down. It would seem to make sense then, to have both these efforts coordinated by the broader scope of <tt>laptop-mode</tt> alone. As an added bonus, <tt>laptop-mode</tt> doesn't touch the cdrom.
 +
 
 +
So here's how I hand the matter over to laptop mode:
 +
#Disable the /etc/init.d/acpi-support boot script with <tt>sysv-rc-conf</tt> as described [[Installing_Debian_Lenny_on_a_ThinkPad_T60#services|above]].
 +
#Remove, or better yet, [[Installing_Debian_Lenny_on_a_ThinkPad_T60#dpkg-divert_.2Fetc.2Facpi|divert]] the files <tt>90-hdparm.sh</tt> from <tt>/etc/acpi/ac.d</tt> and <tt>/etc/acpi/battery.d</tt> and <tt>/etc/acpi/resume.d</tt>.
 +
#Make sure <tt>laptop-mode</tt> gets started at boot up with <tt>sysv-rc-conf</tt> also as described in the init script section.
 +
#Enable hardrive power managment from within laptop mode by editing <tt>/etc/laptop-mode/laptop-mode.conf</tt> so that the line<br><tt>CONTROL_HD_POWERMGMT=0</tt><br>becomes<br><tt>CONTROL_HD_POWERMGMT=1</tt><br>
 +
#If you want to be a more conservative with your drive life (at the expense of battery life), you probably want to change the line<br><tt>BATT_HD_POWERMGMT=1</tt><br>to something more like<br><tt>BATT_HD_POWERMGMT=180</tt>
 +
#Now you can enhance laptop mode to further reduce drive spin up. First, you can have syslog not sync all the time on battery which requires disk write access and consequently spinup. Just run <tt>lm-syslog-setup</tt> and answer yes to the question of whether or not you want to create the split syslog configuration.
 +
#You can crank up the <tt>LM_READAHEAD=8192</tt> if you have lots of RAM (don't forget to make sure that <tt>CONTROL_READAHEAD=1</tt>).
 +
#You can set <tt>CONTROL_NOATIME=1</tt> to prevent disk writes related to updating file access times while on battery.
 +
This is only the [http://samwel.tk/laptop_mode/faq tip of the iceberg] for laptop-mode configuration.
 +
 
 +
===sleep===
 +
Though you can make your laptop sleep, by simply executing
 +
<pre>
 +
echo -n $ACPI_SLEEP_MODE >/sys/power/state
 +
</pre>
 +
The <tt>/etc/acpi/sleep.sh</tt> script wraps this command in some other niceties that may ease the transition in and out of sleep. In particular, it sources the scripts in <tt>/etc/acpi/suspend.d</tt> before sleeping and those in <tt>/etc/acpi/resume.d</tt> after awaking. If you feel uneasy about playing with these scripts yourself, you can alter some of their behaviour by editing the <tt>/etc/defaults/acpi-support</tt>.
 +
 
 +
It would seem to make sense to bind the Fn-F4 key with the moon on it to the <tt>/etc/acpi/sleep.sh</tt> script.
 +
 
 +
====automated sleep====
 +
You could also set it up so that your laptop [[How_to_configure_acpid#Example:_go_to_sleep_on_lid_close|goes to sleep when you close the lid]]. I however prefer to have my laptop remain awake when the lid is closed so that it can continue background tasks such as ripping a cd, downloading a file, compiling a kernel, playing music, etc. I do however want to have some system of going to sleep during inactivity. For this I use the <tt>sleepd</tt> package which automatically puts the laptop to sleep after a period of inactivity. It does however requires some configuration to make it actually do this.
 +
 
 +
First of all, if you haven't already installed it, do so
 +
<pre>
 +
aptitude install sleepd
 +
</pre>
 +
Now edit the configuration file <tt>/etc/default/sleepd</tt>. Set <tt>PARAMS</tt> to the arguments you want to give the sleepd daemon as started by init. You can take a look at the sleepd man page to get an idea of what you might want to put here. As an example, you might have
 +
<pre>
 +
PARAMS="-u 180 -U 1800 -s /etc/acpi/sleep.sh -i 1 -i 12 -i 23"
 +
</pre>
 +
This tells sleepd to sleep after three minutes of inactivity while on battery(<tt>-u 180</tt>) and after half an hour of inactivity while on ac (<tt>-U 1800</tt>). I have defined "activity" as signals on irqs 1(keyboard), 12(mouse), and 23(usb mouse) (<tt>-i 1 -i 12 -i 23</tt>). 1 and 12 will be autodetected, but 23 may not be. You can see what uses the various interrupts by running the command <tt>cat /proc/interupts</tt>.You can also use the <tt>xosview</tt> utility to discover when the various IRQ's are used. Finally sleepd itself doesn't actually know how to put the computer to sleep, so you have to supply it with the command to do so (<tt>-s /etc/acpi/sleep.sh</tt>). You could really put anything at all here.
 +
 
 +
You'll note however, that the above is a rather limited definition of "inactivity". Unfortunately, it's the best sleepd has to offer. Alas, none of the above mentioned background tasks that I want my computer to continue doing can be reliably mapped to the use of a particular IRQ. The next best thing then is to have our sleep command be a script that before putting the computer to sleep checks for a wider range of activity before actually going to sleep and aborts the sleep process if such activity is detected. This will reset the sleepd timer so that it must wait for an other interval of human inactivity before running the sleep/check script again.
 +
 
 +
There are four checks that I want to do before going to sleep:
 +
#CPU activity
 +
#Disk activity
 +
#Network activity
 +
#Is sound playing?
 +
The first three can be checked using the <tt>sar</tt> utility included in the <tt>sysstat</tt> package, while the latter can be checked using the <tt>rec</tt> utility included in the <tt>sox</tt> package. If you haven't already, install those packages. Sox is additionally going to <tt>need alsa support</tt>, so you could install that package, or just go ahead an install off of <tt>sox</tt> since its a handy program to have the full functionality of.
 +
<pre>
 +
aptitude install sysstat sox sox-fmt-all
 +
</pre>
 +
 
 +
The following script <tt>autosleep.sh</tt> is intended to be called by sleepd after user inactivity to check for the background inactivity described above. If there is inactivity in these four fronts, it calls the sleep.sh script and puts the computer to sleep.
 +
 
 +
<pre>
 +
#!/bin/bash
 +
# autosleep.sh
 +
# Checks if the computer is inactive before going to sleep. Aborts if it looks like
 +
# there's some action.
 +
#
 +
 
 +
# Thresholds - these may depend on what you do with your computer and what
 +
# you want it to stay awake for.
 +
CPUTHRESH=5        # in percent
 +
DISKTHRESH=500    # in blocks/sec (the sar manpage says blocks are 512 bytes in normal cases)
 +
NETTHRESH=10      # in kB/s
 +
SNDTHRESH=200      # in ???? rms
 +
# (no sound playing is ~25 while playing mp3 w/ pcm+master turned all the way to zero is ~250)
 +
 
 +
# Sample times (in seconds) - again needs may vary
 +
CPUTIME=1 
 +
DISTTIME=2 
 +
NETTIME=2
 +
SNDTIME=2
 +
 
 +
 
 +
# Check CPU usage defined as non-idle time.
 +
CPU=`sar $CPUTIME 1 | awk '/Average/ { printf "%d\n",100-$8}'`
 +
echo "CPU = $CPU%"
 +
if [ $CPUTHRESH -lt $CPU ];then
 +
    echo CPU is working, not sleeping
 +
    exit;
 +
fi
 +
 
 +
# Check disk usage (read + write)
 +
DISK=`sar -b $DISKTIME 1 | awk '/Average:/ { printf "%d",$5 + $6 }'`
 +
echo "DISK = $DISK"
 +
if [ $DISKTHRESH -lt $DISK ];then
 +
    echo Disk is working, not sleeping
 +
    exit;
 +
fi
 +
 
 +
# Check net usage (exclude wifi0 which appears to have activity all the time for some weird reason)
 +
NET=`sar -n DEV $NETTIME 1 | awk '/Average:/ && $2 !~ /(IFACE|wifi0)/ { SUM += $5 + $6 } END { printf ("%d\n",SUM)}'`
 +
echo "NETWORK = $NET"
 +
if [ $NETTHRESH -lt $NET ]; then
 +
    echo Network is in use, not sleeping
 +
    exit;
 +
fi
 +
 
 +
# Set the mixer to some controlled values and set it to record the mixed sound output
 +
# This unfortunately is going to be sound-chip specific.
 +
alsactl -f /var/tmp/sound.state store
 +
amixer sset Capture 20% cap
 +
amixer sset Digital 20%
 +
amixer sset Mix cap
 +
# Record to null and use RMS amplitude in resulting statistics with a convenience
 +
# factor to make it integer
 +
SND=`rec -n stat trim 0 $SNDTIME 2>&1 | sed -n 's/^RMS[ ]*amplitude:[ ]*/1000000 * /gp' | bc | cut -d. -f 1`
 +
# Restore previous mixer state
 +
alsactl -f /var/tmp/sound.state restore
 +
echo "SOUND = $SND"
 +
if [ $SNDTHRESH -lt $SND ];then
 +
    echo Sound is playing, not sleeping
 +
    exit;
 +
fi
 +
 
 +
. /etc/acpi/sleep.sh
 +
</pre>
 +
 
 +
===hibernate===
 +
Hibernate works with the described setup (my custom compiled kernel in particular) by running <tt>/etc/acpi/hibernate.sh</tt> as long as I don't have the uswsusp package installed. I could probably get it to work with uswsusp if I worked at it, but I don't really care since I don't hibernate all that often. Of note, I have the boot parameter <tt>resume=/dev/sda2</tt> (my swap partion) added to the kopt= variable in my <tt>/boot/grub/menu.lst</tt> so that running <tt>update-grub</tt> appends this option to my kernel:
 +
<pre>
 +
# kopt=root=/dev/sda11 ro resume=/dev/sda2 vga=792
 +
</pre>
 +
results in
 +
<pre>
 +
title Debian GNU/Linux, kernel 2.6.23-amd64.005
 +
root (hd0,2)
 +
kernel /vmlinuz-2.6.23-amd64.005 root=/dev/sda11 ro resume=/dev/sda2 vga=792
 +
savedefault
 +
</pre>
 +
The above is actually probably unnecessary in my case as I have set <tt>PM_STD_PARTITION=/dev/sda2</tt> in my kernel config which can be found under <tt>Power Management Options -> Hibernation (aka 'suspend to disk') -> Default resume partition:</tt>.
 +
 
 +
==64-bit headaches==
 +
===Java===
 +
Ok, so Sun is being lazy and though they've made an amd64 java, they didn't bother to make the accompanying browser plugin. So you're left to try and use the 32-bit version that I've included in my package list above. Unfortunately, this won't work in iceweasel as flash does. You don't however have to start mucking about with chroots if you really need that no doubt ridiculous java app to work. Go to the [http://www.mozilla.com/en-US/firefox/ Firefox download site] and grab the linux version. Also if you didn't get it with the rest of the packages I recommended above, get <tt>ia32-sun-java5-bin</tt>. For some reason this trick doesn't work with <tt>ia32-sun-java6-bin</tt>, it ends up just hanging the browser.
 +
<pre>
 +
aptitude install ia32-sun-java5-bin
 +
</pre>
 +
Now go to the directory where you saved the firefox tarball (it can even be in a subdirectory of your home directory), unzip it and put a symlink to <tt>libjavaplugin_oij.so</tt> in the <tt>firefox/plugins</tt> directory.
 +
<pre>
 +
tar xvzf firefox-2.0.0.11.tar.gz
 +
ln -sf /usr/lib/jvm/ia32-java-1.5.0-sun-1.5.0.13/jre/plugin/i386/ns7/libjavaplugin_oji.so firefox/plugins/
 +
</pre>
 +
Now, you're ready to enjoy all the wonderful java content the web has to offer via your personal firefox installation. First close any iceweasels you have running, then run
 +
<pre>
 +
firefox/firefox http://www.java.com/en/download/help/testvm.xml
 +
</pre>
 +
You should see the stupid java guy. Until Sun joins the rest of us in the 21st century, you're going to have to use this firefox to view web-applets. The good news is that the vanilla firefox will seamlessly use the same profile directory as iceweasel. You can even use it as your main browser if you want. There's also this blackdown java I've heard of that has a 64-bit web plugin, but the things I've read about its instability have not encouraged me to go hunting for it.
 +
===32-bit Maple 11===
 +
This takes a bit of fiddling, but it will work. First, you're going to want to use 32 bit java to run the installer.
 +
<pre>
 +
aptitude install aptitude install ia32-sun-java6-bin
 +
update-alternatives --config java
 +
</pre>
 +
And select <tt>/usr/lib/jvm/ia32-java-6-sun/jre/bin/java</tt>. Then
 +
<pre>
 +
mount /media/cdrom
 +
/media/cdrom/Maple11Linux32Installer.bin
 +
</pre>
 +
The problem is that maple tries to be all smart when you actually run <tt>maple11/bin/maple</tt> or <tt>maple11/bin/xmaple</tt> which call end up calling <tt>maple11/bin/maple.system.type</tt>. Of course the answer is going to be  which of course it determines is <tt>bin.X86_64_LINUX</tt>. Trouble is you've only installed <tt>bin.IBM_INTEL_LINUX</tt> which you can run fine on the detected platform, but which maple won't let you. To remedy this, prevent <tt>maple11/bin/maple</tt> calling <tt>maple11/bin/maple.system.type</tt> in the first place and just hard-code the desired architecture.
 +
<pre>
 +
MAPLE_SYS_BIN=bin.IBM_INTEL_LINUX
 +
</pre>
 +
Once you have it installed, you can <tt>update-alternatives</tt> again and go back to a 64 bit java if you like.
 +
 
 +
[[Category: Debian]]
 +
[[Category: T60]]

Latest revision as of 16:49, 5 August 2011

Debian Lenny on a T60 6371-6NU

You might also want to check out Debian Etch on a Thinkpad T60 HowTo and Installing_Debian_Lenny_on_a_ThinkPad_T61.

In case you can't decode the Thinkpad model number above, here are the specs (I've left out modem, infrared, cardbus since I haven't ever used them):

Processor Intel Core 2 Duo (Merom) 1.83GHz
Graphics Adaptor Intel Graphics Media Accelerator 950
Display 15.4" TFT display with 1200x800 resolution (widescreen)
RAM 1 GB PC2-5300 (upgraded to 2GB)
Harddisk 120GB 5400 RPM Hitatchi HTS54161
Audio AD1981HD HD Audio 1.0 controller
Ethernet 82573L Gigabit Ethernet Controller
Optical LG-Hitatchi HL-DT-ST DVDRAM GSA-4083N Dual Layer DVD+/-RW
Wireless Atheros AR5418.
Biometric STMicroelectronics Fingerprint Reader

Before I begin

I remove as much of the crap ware as possible from windows. I burnt a bunch of the stuff in the SOFTWARE directory to DVD and deleted it. I managed to get the disk usage down to around 5GB or so. I'm sure I could do better, but I only want to spend so much time in windows. I keep however a few essential things like BIOS update and finger print management software. This later is as far as I know the only way to paper writing service enrol finger prints in the bios for bootup fingerprint checking. I upgrade the bios in windows using the Lenovo utility. I want to have someone to hold responsible (other than myself) if my computer gets fried while flashing the bios. In the bios itself, I have the SATA controller set to AHCI. I've read quite a few people saying that they need to set it to "compatibility". Perhaps this is no longer an issue with newer kernels (>~2.6.18). I note that my kernel config has the SATA_AHCI option enabled (module should be fine as long as you use an initrd).

Installation

These are instructions for getting the most customised, minimal base Debian system running. As such, you can probably go with your gut and ignore some of these steps for example using the "expert" install mode or deselecting all but the base system packages.

  1. First of all, get the "businesscard" cd image for amd64 if you want to run 64 bit or i386 if you want 32 bit. Note that flash now works in 64 bit(see this article on the "debian adminstration" blog), java is possible, but a little trickier (see below). If you do however go 64 bit you won't be able to use proprietary 32 bit modules in your kernel. Most notably, ndiswrapper won't work with 32-bit windows drivers.
  2. Burn the cd image to a cd with the command
    cdrecord -v debian-testing-amd64-businesscard.iso
    You may find that you need to add dev=/dev/cdrom (or whatever your burning device is) to the above command.
  3. Now stick in the newly burned disc and reboot.
  4. At the "boot:" prompt type "expert (you could also just hit enter, but you won't get as much control over what's about to be installed on your computer).
  5. Go through the install menu using my answers as outlined below as a guide. You will obviously want to tailor things to your specific situation:
  • Choose Language
    • Choose Language:
      English
    • Choose a locale:
      en_CA (stick with ascii for the default since UTF screws up some terminals)
    • Choose other locales to be supported:
      en_CA.UTF-8
      en_GB.UTF-8
      en_GB
      en_GB.ISO-8859-15
      en_US.UTF-8
      en_US
      en_US.ISO_8859_15
  • Select a Keyboard layout
    • Type of Keyboard:
      PC-Style
    • Keymap to use:
      American English
  • Detect and mount CD-ROM
    • Modules to load:
      <none> (deselect usb-storage, its not needed unless your using a external USB CD drive to read the install disc)
  • Load installer components from CD:
    • Installer components to load:
      <none>
  • Detect network hardware
    • Modules to load:
      <none>(I don't imagine you'd need usb-storage here either unless you were using a USB networking device)
  • Configure the network
    • Auto-configure DHCP:
      yes
    • Hostname:
      <omitted>
    • Domain Name:
      <omitted>
  • Choose a mirror of the Debian archive
    • Protocol for file downloads:
      ftp (might be a tiny bit faster than http, though the latter is less likely not to work if you're behind a draconian firewall. http is also slightly easier because you get a list of available mirrors whereas with ftp, you have to know the address already)
    • Debian archive mirror hostname:
      mirrors.kernel.org
    • Debian archive mirror directory:
      /debian
    • FTP proxy information:
      <blank> (unless you're behind one of the draconian firewalls mentioned above, in which case figure out the proxy to use from your network administrator.)
    • Debian version to install:
      testing
  • Configure the clock
    • Set the clock using NTP?:
      yes
    • NTP Server to use:
      ntp.ubc.ca (though the default provided or any other you prefer should work just as well.)
    • Select your timezone:
      Pacific
  • Detect disks
    • Modules to load:
      <none> (again not necessary unless you want to install onto a USB drive)
  • Partition Disks
    • Partition Method:
      manual
    • This depends largely on personal preference, and needs, but here's how I set up the disks:
      200MB EXT3 /boot
      1.0GB swap
      15GB XFS /
      2GB XFS /var
      All remaining disk space XFS /home
      I use XFS because this tends to be faster than ext3. Reiserfs is also a good alternative but takes a little longer to mount at bootup. Grub has some problems reading XFS, so I use ext3 for the /boot partition. If you're keeping your windows partition, just resize it (I brought it down to 6Gb) and otherwise leave it alone for now, we'll get to that in a bit. Once you're done setting things up select "Finish partitioning and write changes to disk.
    • Write chages to disk?:
      yes
  • Install the base system
    • Kernel to install:
      linux-image-2.6.22-3-amd64 (or whatever newer one is available by the time you read this).
  • Setup users and passwords
    • Enable shadow passwords:
      yes (duh)
    • Allow login as root:
      yes (unless you're really paranoid)
    • Root password:
      <omitted>
    • Create a normal user account now?:
      yes
    • Full Name:
      <omitted>
    • Username for your account:
      <omitted>
    • Password:
      <omitted>
  • Configured the package manager
    • Use non-free packages:
      yes (unless you have some restrictions ideological or otherwise)
    • Services to use:
      security updates
      volatile updates
  • Select and install software
    • Participate in package usage survey?:
      yes (why not help make Debian even better?)
    • Choose software to install:
      It's up to you to decide whether you want to select go with the default Desktop environment, Laptop and Standard System or just install a bare bones system and deal with it later. I will assume however that you have selected none of them in the remainder of this howto.
  • Install GRUB boot loader on hard disk
    • Install GRUB 2:
      no (for some reason it doesn't work)
    • Device for bootloader installation:
      /dev/sda (unless you have some other bootloader you want to use to chain to GRUB).
    • Grub password:
      <omitted> (don't make this your root password as it ends up in your menu.lst file as plaintext).
  • Skip LILO (unless you like pain)
  • Debconf priority:
    • Prompt at or above:
      critical (I want to be able to automate updates)
    • Finish the installation
    • Finish the installation

The First Boot: getting the ball rolling

If you went with the bare-bones system in the package selection above, you should boot up to a commandline login prompt (X-Windows hasn't been installed yet). Log in as root. It's now time to install the packages necessary to get things running. You'll find that thanks to the business card installation, you have an up to date system (i.e., aptitude update&& aptitude dist-upgrade won't find any packages needing upgrade. So lets get on with installing all the packages necessary to get things looking a little more like home.

First of all, there are a few things even in the base system that you probably won't need so get rid of them:

aptitude purge nano pcmciautils tasksel tasksel-data vim-common vim-tiny

Of course, you'll want to keep pcmciautils if you plan on using antiquated pcmcia cards. Similarly you may want to keep vim and/or nano if you use those editors. If on the other hand, you're like me, you don't and you'll then want to

aptitude install emacs

Now if you're like me and you're craving a windowed multitasking work environment before you go any further, you can just do

aptitude install xorg gdm <your favourite window manager (e.g. gnome or openbox)>

Now do a

/etc/init.d/gdm start

And you should get a login screen.

Xorg.conf

Ah, the infamous xorg.conf. Luckily, since you're running Debian lenny on an Intel integrated graphics chip, editing xorg.conf isn't strictly necessary. Intel has gone to a lot of trouble to make this as painless as possible. God help you if on the other hand, you got a model with an ATI X1300 or ATI X1400 graphics card. I made a few modifications to the automatically generated xorg.conf that might be of interest.

Horizontal edge scrolling

Edge scrolling has to be my favourite pointing device feature ever, thus I find it rather annoying that it is only half enabled by default. In particular you'll find that though vertical scrolling works like a charm, horizontal scrolling along the bottom of the touchpad doesn't work. Additionally, I find that the default threshold edge distance to initiate scrolling is a little on the large side for my slender fingers. I also find that the corner button emulation tends to be accidentally activated while using edge scrolling so I disable it. Thus, I have updated the relevant input device section to make use of some of the options documented on the Synaptics Touchpad page

Xinerama

There is also the issue of using dual monitors. You'll be surprised to find that it "just works" if you have an external monitor plugged in. Well, it kind of "just works" if you like having the displays that is. If, on the other hand you want to expand your desktop, you can either do the configuration on the fly with XRandR, or make it permanent by making the appropriate modifications to xorg.conf

Configuring the package manager

The best thing about Debian is the package manager. Thus, you want to make sure it's configured optimally to get the best use out of it before you go any further. Once you're logged in, you can edit the /etc/apt/sources.list file so that it can find more packages than the default. Below is my sources.list file.

# testing - lenny
deb ftp://mirrors.kernel.org/debian/ lenny main contrib non-free
deb-src ftp://mirrors.kernel.org/debian/ lenny main contrib non-free

# stable - etch
deb ftp://mirrors.kernel.org/debian/ etch main contrib non-free
deb-src  ftp://mirrors.kernel.org/debian/ etch main contrib non-free

# unstable - sid
deb ftp://mirrors.kernel.org/debian/ sid main contrib non-free
deb-src ftp://mirrors.kernel.org/debian/ sid main contrib non-free

# experimental
deb ftp://mirrors.kernel.org/debian/ experimental main contrib non-free
deb-src ftp://mirrors.kernel.org/debian/ experimental main contrib non-free

# security updates
deb http://security.debian.org/ lenny/updates main contrib non-free
deb-src http://security.debian.org/ lenny/updates main contrib non-free

You'll notice that I've also included entries for etch and sid in addition to experimental. If you use a different mirror than mirrors.kernel.org, you'll want to make sure that it hosts the experimental branch. This is where we'll find the package for the fingerprint reader. I include stable and unstable for completeness in case there are packages I want that that are only available in unstable, or if I want to revert to a version of a package in stable. Note that the order you specify the branches in the sources.list file makes no difference, thus in order to maintain priority for lenny packages (over sid or experimental which in general have newer packages), I also have an /etc/apt/preferences file with pin priorties:

Package: *
Pin: release o=Debian,a=stable
Pin-Priority: 300

Package: *
Pin: release o=Debian,a=testing
Pin-Priority: 600

Package: *
Pin: release o=Debian,a=unstable
Pin-Priority: 200

Package: *
Pin: release o=Debian,a=experimental
Pin-Priority: 100

Basically this is saying that unless I specify otherwise, "testing" (lenny) packages are to be preferred over "stable" (etch) over "unstable" (sid) over "experimental". A lower Pin-Priority means lower precedence. If you want to override this precedence, you can either use the aptitude gui and select a specific version to install or add the flag -t <target branch> to your aptitude install <package> command. If you do this in such a way as to select a package that has a newer, higher priority alternative available, it will be upgraded next time you do an aptitude upgrade unless you pin that particular package version (see the relevant section of the apt howto).

Now that we have that sorted out we should do an

aptitude update

If by some chance you get an annoying message like

W: GPG error: <servername> <branch> Release: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 07DC563D1F41B907
W: You may want to run apt-get update to correct these problems

(especially annoying because it happens when you run apt-get update as well), the solution is to run the following command:

gpg --keyserver wwwkeys.eu.pgp.net --recv-keys 07DC563D1F41B907 && apt-key add /root/.gnupg/pubring.gpg && aptitude update

where you of course replace "07DC563D1F41B907" with what ever public key you get in the orginal GPG error message. Now of course, the reason this is happening is to ensure your security. You don't want to be downloading packages from unknown or forged sources, so don't just go verifying keys willy nilly without thinking about why you might be getting such a message. In particular, if the message appears even though you haven't recently changed your mirror, something fishy might be going on.

Debian multimedia

If you're looking for those extras that the Debian project doesn't include for a variety of legal reasons like lame or libdvdcss and you don't want to worry about compiling them yourself, you could add one of the one of the debian-multimedia mirrors to /etc/apt/sources.list.d directory. For example, to use the ftp://gulus.usherbrooke.ca/ mirror, we type

cat << EOF > /etc/apt/sources.list.d/debian-multimedia.list
deb ftp://gulus.usherbrooke.ca/debian-multimedia/ stable main
deb ftp://gulus.usherbrooke.ca/debian-multimedia/ testing main
deb ftp://gulus.usherbrooke.ca/debian-multimedia/ unstable main
EOF

Note that each file in /etc/apt/sources.list.d/ is sourced and concatenated to the contents of /etc/apt/sources.list whenever you do an aptitude update. This is a convenient way to manage multiple diverse mirrors for different programs you may have installed. Note however that the more mirrors you have listed here, the longer it's generally going to take to do an aptitude update. Though the access is parallelised, you probably only have so much bandwidth on your end and the less official mirrors can be kind of slow.

Installing Packages

You might notice that even once you have your favourite window manager running, you're still missing quite a bit in terms of software beyond the basic operating system.

Essentials

Here are a few highly recommended packages:

acpi-support a set of scripts intended to respond to acpi events such as Fn-_ key combinations.
apt-file allows you to search file names in uninstalled pacakges
aterm a lightweight terminal
cabextract extract files from windows installation executables
colordiff like your old friend diff for identifying dissimilarities between files, but easier on the eyes
cpufrequtils init scripts to setup cpu frequency scaling at boot
cupsys cups print server (you'll need it if you want to print)
dash a light weight bash-like-shell (use it for your init scripts or anything else you want to speed up)
deborphan find unused packages
defoma Debian font manager - makes activating fonts easier
emacs-goodies-el like it says, nice addons for emacs
flashplugin-nonfree yep, it works on 64 bit
gimp Opensource gui image editor rivalling Photoshop in power, quality and comprehensiveness.
gv Ghost View for viewing .ps documents
hdapsd Daemon to stop the disk if the accelerometer detects shocks.
ia32-sun-java5-bin 32 bit java 5 (with plugin)
iceweasel Rebranded Firefox web browser
ifplugd monitors the hard-wired Ethernet and brings the interface up or down automatically depending on link presence.
imagemagick Command line image editor and conversion utilities unrivalled in batch processing power.
laptop-mode-tools Reduce power consumption by reducing hard disk use while on battery
less command line text reader with backscrolling
libpam-thinkfinger used to get the finger print reader running
localepurge Clean up documentation in unused languages.
menu Manage system-wide menus
msttcorefonts Microsoft fonts
ntfsprogs mount your windows ntfs partition read/write
ntp daemon to regularly syncronise system clock with network time servers
ntpdate used to do one-off on-demand syncrhonisation with network time servers
openoffice.org open source productivity software
prelink optimises share libraries for better program load performance
sleepd automated sleep daemon
mlocate periodically indexes the file system for fast searching
smartmontools monitor harddisk health
sysv-rc-conf ncurses gui to activate and deactivate init scripts
ttf-bitstream-vera bitstream vera true type fonts
ttf-dejavu dejavu truetype fonts
ttf-freefont free truetype fonts
unrar extractor for the archive format popular among hackers
unzip extractor for the winzip archive format
wpagui gui for the wireless wpa supplicant
wpasupplicant the wpa supplicant backend
xfsdump for backing up mounted xfs filesystems
xpdf for viewing pdf files

To install all of the above:

aptitude install acpi-support apt-file aterm cabextract colordiff cpufrequtils cupsys dash defoma deborphan emacs emacs-goodies-el flashplugin-nonfree gdm gimp gv hdapsd ia32-sun-java5-bin iceweasel ifplugd imagemagick laptop-mode-tools less libpam-thinkfinger localepurge menu msttcorefonts ntfsprogs ntp ntpdate openoffice.org prelink sleepd mlocate smartmontools sysv-rc-conf ttf-bitstream-vera ttf-dejavu ttf-freefont unrar unzip wpagui wpasupplicant xfsdump xorg xpdf

Recommended

Then there are a few package I like that you may also want to check out depending on your preferences/habits.

alsamixergui nice mixer app
arping like ping, but gives you mac address if its available
bc arbitrary precision command line calculator (good for scripting)
bmon command line network bandwidth monitor
css-mode css syntax for emacs
devilspie Watches for new xwindows matching configured parameters and acts on them. Very powerful.
dmz-cursor-theme Make your cursors a little easier on the eyes
equivs for making "ghost" packages to satisfy dependences for example when you compile something from source
ftnchek check Fortran syntax
gawk extended version of awk
genisoimage create cdrom ISO's before burning them.
gkrellm performance monitoring gui
gkrelltop plugin for above showing top resource consuming processes
gkrellmwireless plugin for above showing wireless signal strength
gparted graphical partition manager
gphotofs for mounting digital cameras
grip excellent cd ripping functionality using cdparanoia backend
gsl-bin binary files for powerful scientific computing library
gsl-ref-html documentation for powerful scientific computing library
gtkguitune guitar tuner gui with oscilloscope-like interface
hdaps-utils for reading and visualising the accelerometer output
html-helper-mode enhanced emacs html syntax
ibritish british flavour of ispell
id3v2 id3v2 (and v1) mp3 tag reader and editor
k3b powerful cd/dvd burning gui
lastfm preference based internet radio and social networking
libgsl0-dev powerful scientific computing library headers for compiling your own code
libsox-fmt-all audio file formats for sox, the command line audio player/recorder
lsdvd view the contents of a video dvd
lshw show comprehensive list of system hardware and specifications
lsof display currently open files (good for figuring out what the hell is going on)
mp3gain losslessly normalise mp3's
mp3rename rename mp3's based on id3 tags
mutt powerful terminal-based email client
myspell-en-gb british myspell (used by open office)
nfs-common for mounting nfs drives
nmap for probing open ports locally and remotely
nxml-mode xml syntax for emacs
obconf configuration gui for openbox
offlineimap sync imap folder so you have a local copy accesible when no internet is available
openbox versatile lightweight window manager
openssh-server allows remote login
pbzip2 make full use of the dual core when bzipping things.
post-el emacs email syntax intended for use with mutt
powertop see what's causing your processor to wake up and use more battery power
pypanel lightweight configurable panel
qiv quick image viewer good for slide shows
rsync efficient remote and local copying. Copies only differences and ssh for secure communication
samba windows file server/client software
screen powerful detachable/reattachable terminal interface
smbfs allows mounting of windows shares
sox command line audio recording and playing utilities
sshfs allows mount of remote trees on ssh server machines with no special remote configuration
sux su that passes proper Xauthority
sysstat command line system monitoring
udftools tools dealing with the filesystem common in optical media
unclutter hide of mouse cursor when its not being used.
unison keep local and remote filesystems in sync using the rsync protocol and ssh
urlview open urls in mutt with your favourite browser
wbritish-huge large british words list
whois detailed domain querying command
wmctrl control window manager from the command line
wodim command line cd buring (successor to cdrecord)
xclip command line x clipboard tool feed standard input into clipboard, extract clipboard to standard output.
xmms x multimedia system winamp-like mp3/media player
xmms-cdread read cd's via the digital link rather than rely on that annoying analogue cable
xmms-crossfade for gapless playback
xmms-shell for command line control of xmms
xmms-skins skins for xmms
xosd-bin for writing on screen display messages from the command line
xosview performance monitor gui (key feature is the irq monitor)
xscreensaver locks the screen after inactivity

To install all of the above:

aptitude install alsamixergui apt-file arping bc bmon colordiff css-mode deborphan devilspie dmz-cursor-theme equivs freeglut3 ftnchek gawk genisoimage gkrellm gkrelltop gkrellmwireless gparted gphotofs grip gsl-bin gsl-ref-html gtkguitune hdaps-utils html-helper-mode ibritish id3v2 k3b lastfm libformsgl1 libgsl0-dev libsox-fmt-all lsdvd lshw lsof mkisofs mp3gain mp3rename mutt myspell-en-gb nfs-common nmap nxml-mode obconf offlineimap openbox openssh-server pbzip2 post-el powertop pypanel qiv rsync samba screen smbfs sox sshfs sux sysstat udftools unclutter unison urlview wbritish-huge whois wmctrl wodim xclip xmms xmms-cdread xmms-crossfade xmms-shell xmms-skins xosd-bin xosview xscreensaver

Fingerprint reader

Ok, admit it. This is the real reason you got a ThinkPad. Getting the integrated fingerprint reader working is surprisingly easy with the new open source thinkfinger driver. This is highly recommended over the binary only driver which much more difficult to install and less stable even leading xscreensaver to crash and expose the desktop without a provided fingerprint or password!

If you didn't install it among the packages above, see the relevant section of the howto.

Once you have it installed, you must instruct PAM to use it so that it will ask for your fingerprint when you login with gdm or at the command line (or any thing else that uses PAM). To make it brief and more Debian-specific, you want your /etc/pam.d/common-auth file's only uncommented lines to be

auth    sufficient      pam_thinkfinger.so
auth    required        pam_unix.so nullok_secure try_first_pass

Then you want to enroll the fingerprints of any users as well as root

tf-tool --add-user <username>
tf-tool --add-user root

This will put the fingerprint patterns in /etc/pam_thinkfinger/<username>.bir. You may also want to make sure you have the uinput module probed by typing lsmod | grep uinput. If not, then probe it (modprobe uinput) and put it into your /etc/modules file to be probed on boot

echo uinput >> /etc/moduleds

Now for the icing on the cake. If you have xscreensaver (>=5.0) or a sufficiently recent version of gnome-screensaver, you can use your fingerprint to unlock the screen as well.

Update: See How to enable the integrated fingerprint reader.

A few /etc configurations

services

By default, you'll probably have a bunch of services running at startup that are going to lengthen your boot time and likely eat up system resources as long as they're running. You can use the bum or sysv-rc-conf utilities to enable or disable scripts at different run levels. In Debian, run level 2 is the regular multi-user mode, while run level 1 is single-user (maintenance mode). Run levels 3-5 are usually identical to 2, but you can customise them otherwise. Run levels 0,6 which are for shutdown and hibernate. Runlevel S is for system startup scripts. For more on how debian deals with run levels, take a look at the Debian Policy Manual. Below is a table with all of the services I have and when they are started. Keep in mind that I don't use gnome or kde which might be aversely affected by disabling dbus or hal as I have. I have also completely removed the discover1 package.

aptitude purge discover1
service runlevel 1 runlevel 2-5 runlevel 0 runlevel 6 runlevel S
acpi-support
acpid X
alsa-utils
anacron X
atd
avahi-daemon
bootclean
bootlogd X
cpufrequtils X
cron X
cupsys
dbus
exim4 X
fuse X
gdm X
hal
halt
hdapsd X
hdparm
hibernate
ifplugd X
ifupdown X X X
ifupdown-clean X
killprocs X
klogd X
laptop-mode X
loadcpufreq X
module-init-tools X
networking X X X
nfs-common
ntp X
openbsd-inetd
portmap
procps X
rc.local
reboot X
rmnologin X
rsync
samba
screen-cleanup X
sendsigs X X
single X
sleepd X
smartmontools X
ssh
stop-bootlogd X
stop-bootlogd-single X
sysklogd X
sysstat
udev X
udev-mtab X
udftools
umountfs X X
umountroot X X
urandom X X X
vbesave
wpa-ifupdown X X
x11-common X

Use dash for init scripts

Dash is essentially a lighter weight POSIX compliant version of bash. It is supposed to run slightly faster than bash, so it would seem like a good idea to use it to replace bash for executing your init scripts. This can be done simply by replacing the #!/bin/sh or #!/bin/bash line at the beginning of each script with #!/bin/dash. The following script does just that:

#!/bin/sh
# Since the operation takes a second or two, lets check if it's necessary first
head -qn1 /etc/init.d/* | egrep -q '/bin/sh|/bin/bash'
if [ $? = 0 ];then
    echo dashing init scripts
    for file in /etc/init.d/*;do
        sed -i '1 s|#![ ]*/bin/b\?a\?sh|#!/bin/dash|g' $file
    done
fi
exit 0

Even though this is rather quick and easy, you don't want to have to worry about this tweak being undone by future package upgrades. So we add an apt rule in /etc/apt/apt.conf.d/90-initdash:

// Make sure init scripts use dash
DPkg
{
Post-Invoke {"/usr/local/sbin/initdash";};
};

This tells apt to run /usr/local/sbin/initdash (which is where I keep the above script) after each time it invokes dpkg. So any init scripts installed by new packages will get "dashed".

Init concurrency

You have dual cores so why not make use of them in boot. Edit /etc/init.d/rc and make sure it has the line

CONCURRENCY=shell

rather than

CONCURRENCY=none

Don't ask me what setpar means.

You don't need 6 vitual consoles

By default nearly all Linux distributions create 6 virtual login consoles that you can access by hitting Alt-Ctl-F1-6. The Seventh (and beyond if you're using multi-session gdm) is where X sits. Admittedly these consoles probably don't take up too many resources, but I have never found myself to need more than two of them. So disable the rest in /etc/inittab by commenting out the some of them:

1:2345:respawn:/sbin/getty 38400 tty1
2:23:respawn:/sbin/getty 38400 tty2
# 3:23:respawn:/sbin/getty 38400 tty3
# 4:23:respawn:/sbin/getty 38400 tty4
# 5:23:respawn:/sbin/getty 38400 tty5
# 6:23:respawn:/sbin/getty 38400 tty6

Start gdm first

By default, adding gdm as a service in runlevel 2 creates the symlink /etc/rc2.d/30gdm to /etc/init.d/gdm. This tells init to start gdm in runlevel 2 after all services that are symlinked with prefixes less than S30. In the above enabled init scripts, there's nothing that gdm strictly depends on to start, so why not start it first and get a login while the rest of the bootscripts complete? With the scripts enabled as above, the earliest running is /etc/rc2.d/S05loadcpufreq. I make gdm run just before this.

mv /etc/rc2.d/S30gdm /etc/rc2.d/S04gdm

You may have to do things differently if you have other services running or if for some reason you need something to start before gdm. In any case, make sure you know what you're moving around before you do it lest you break some delicate order of dependencies and make your system unbootable.

bootlog

Even though I've enabled bootlogd above, I still need to enable it in /etc/default/bootlogd:

BOOTLOGD_ENABLE=Yes

This will cause boot messages to be logged into /var/log/boot.

hdapsd

Hdapsd is the daemon that monitors the accelerometer and parks the hard disk heads if it detects sudden movement of the laptop. It does however need to be told what to protect. By default it works on /dev/hda, but modern thinkpads use SATA and so this needs to be changed to /dev/sda. This is set in the file /etc/default/hdapsd, where you must change the line DISK="hda" to DISK="sda".

NOTE!
This alone will not enable hdapsd protection. You need to patch the kernel for this as described below

smartd

By default, smartd is not enabled when you install the smartmontools package. To enable it, uncomment only the line

start_smartd=yes

in /etc/default/smartmontools. Don't mess with the line about smartd_opts=, we deal with that in the /etc/smartd.conf file. I modified mine so that the only uncommented line is

/dev/sda -a -d sat -n standby -m root -M exec /usr/share/smartmontools/smartd-runner

I figured there was no point in using DEVICESCAN when I already know that I just want to monitor /dev/sda (the cdrom doesn't have smart). This will probably speed things up. The remaining options tell smartd that the disc is behind a SCSI to ATA translation layer, that it should not spin up the disk to do a check and that it should email root should there be a problem. You can check to make sure the emails get through by adding -M test to the end of that line and restarting smart. Remember to remove it though, otherwise, you'll get an email every time you boot up.

exim4-config

You need to tell exim how to send mail. To do this, type

dpkg-reconfigure exim4-config

and follow the dialogs. To be honest, I have trouble sorting through exactly what I want each one to say whenever I do this. Here are the answers I decided on:

  • Mail sent by smarthost;recieved via SMTP or fetchmail
  • System mail name: The FQDN of my laptop
  • IP-addresses to listen on:127.0.0.1
  • Other destinations for which . . .: same as system mail name
  • Machines to relay mail for: <blank>
  • IP address or host name of outgoing smarthost: (this is the server to which your machine should send outgoing mail) Since my mail server requires an SSL/TSL connection on port 587, I must suffix the server name with "::587". Note the two colons.
  • Hide mail name in outgoing mail: yes
  • Visible domain name for local users: same as mail name
  • DNS queries minimal?:no
  • Delivery method:/var/mail
  • Small files?:no

Then, I edit the file /etc/email-addresses so that it says

<my user name>:my.email.address@server.com

Then I make sure that mail to root goes to me by ensuring that /etc/aliases looks as follows:

# /etc/aliases
mailer-daemon: postmaster
postmaster: root
nobody: root
hostmaster: root
usenet: root
news: root
webmaster: root
www: root
ftp: root
abuse: root
noc: root
security: root
root: <my user name>

and that mail sent to me ends up at my regular email address:

echo my.email.address@server.com > ~/.forward

Finally, since as I mentioned, I'm using SSL/TLS, I have to put my user name and password (for the outgoing mail server) in the file /etc/exim4/passwd.client, which unfortunately must be plain text. The format is as follows:

mail.server.address:username:password

Then I restart exim4

/etc/init.d/exim4 restart

and send some test emails in various contexts:

mail -s 'test from user to user' <myusername>
mail -s 'test form user to root' root
mail -s 'test from user to outside' alternateemail@alternateserver.com
su 
mail -s 'test from root to user' <myusername>
mail -s 'test form root to root' root
mail -s 'test from root to outside' alternateemail@alternateserver.com
exit

and hope all those emails go where I expected them to.

If you run into trouble, check the various subdirectories of /var/spool/exim4. msglog and input should have nothing in them after you've sent emails if everything is working. See if you can't find some error messages that give you some clues in any files that do crop up here.

default applications

Right now, the system wide default for the terminal is gnome terminal. This is second only to Konsole in bloat. If you want to keep things streamlined, change the systemwide default to aterm (which you downloaded above).

update-alternatives --config x-terminal-emulator 

And select /usr/bin/aterm-xterm. Now for the browser you're going to want iceweasel (firefox)

update-alternatives --config x-www-browser 

And select iceweasel.

bash completion

It's also nice to have more extended bash completion enabled. This will give you such niceties as completion of man at if you hit tab, or give you suggestions as to what you can ifup. Trust me, if you're going to be using the command line, you're going to want to open up /etc/bash.bashrc and uncomment the lines

# enable bash completion in interactive shells
#if [ -f /etc/bash_completion ]; then
#    . /etc/bash_completion
#fi

that annoying beep

Ok, so you've hit tab a couple times or directed the emacs cursor off the buffer and have heard quite enough of that pc speaker beep. Here's how you get rid of it:

echo blacklist pcspkr >> /etc/modprobe.d/blacklist

That prevents the module from loading when you boot up. If you want to remove it right now without further ceremony:

rmmod pcspkr

more blacklisting

Though you want to be able to use all your hardware you probably don't need to load all the modules at boot. Thanks to automatic module loading stuff will usually load when you actually try to use it. For instance ehci-hcd which controls usb 2.0 devices will automatically load when you plug in a usb 2.0 device. Likewise, the ide_cd and cdrom modules will load when you actually try to mount a cd. So you can add a few more entries to the /etc/modprobe.d/blacklist file.

blacklist ide_cd
blacklist cdrom
blacklist ehci-hcd

Note that this doesn't mean they won't ever load. It only means they won't load on boot. Having the modules unloaded by default may also help to save power on these devices. Unfortunately, the function of the fingerprint reader is dependent on uhci-hcd and usbcore in addition to uinput so we can't blacklist those to shut down the USB system completely.

daily defrags

One of the great things about the XFS file system is that it has a defragmenter. I don't however want to worry about running it all the time, so I've added the file /etc/cron.daily/xfs_defrag containing simply

#!/bin/sh
xfs_fsr

prelink

According to the comments in /etc/default/prelink prelinking isn't enabled by default upon instlalling the prelink package. In order to enable it, edit /etc/default/prelink and make sure that

PRELINKING=yes

less swap please

With the size of RAM these days, swap is almost redundant. You need to tell your kernel just how redundant you want it to be I pick 5 and set it thus in sysctl.conf:

# Reign in that swappiness
vm.swappiness=5

Mount your windows partition

If you keep your windows partition you're probably going to want to have read/write access to it. Gone are the days when this was only a dream for Linux users thanks to ntfsprogs (formerly ntfs-3g). Assuming you have installed the ntfsprogs package recommended above, all you need to do is add a line like

/dev/sda1       /media/win      ntfs-fuse gid=fuse,dmask=0007,fmask=0117 0 0

To /etc/fstab and add your user to the "fuse" group.

adduser <you> fuse

This causes the windows partition (in my case /dev/sda1, though this may vary) to be mounted on /media/win with read write access for everyone in the group fuse.

Build your own kernel (the Debian way)

You may be reluctant to venture into the world of kernel compilation, but it is necessary to get the accelerometer hard disk protection working. Code has to be added to the kernel (don't worry you don't have to write it!) to tell it how to "park" the hard disk heads when hdapsd tells it the laptop is moving around. Hopefully, as this feature becomes more common, it will be built into future releases of the mainline kernel, but for now we must rely on patching the kernel ourselves. There is also something to be said for having a kernel that is tailor matched to your machine. You can cut out a lot of unnecessary stuff and optimise the kernel to your specific system. Thankfully, Debian has eased the burden of kernel compilation and installation with the kernel-package package. The following is heavily based on this howto.

  1. Add yourself to the src group so that you have write access to the /usr/src directory and can do most of the procedure as a regular user.
  2. Install the necessary packages
    aptitude install gcc kernel-package linux-source-2.6.23 libc6-dev tk8.3 libqt3-mt-dev libncurses5-dev fakeroot
  3. Log out and log back in for the addition to the src group to take affect. You can ensure that this is the case by typing groups and looking for "src" in the resulting list.
  4. As a regular user, get the hdaps-protect patch:
    mkdir /usr/src/hdaps/ && cd /usr/src/hdaps && wget 'http://sourceforge.net/mailarchive/attachment.php?list_name=hdaps-devel&message_id=87pry7ehx3.fsf%40denkblock.local&counter=2' -O hdaps-protect.2.6.23.patch
  5. Now, unpack the kernel source
    cd /usr/src && tar xvjf linux-source-2.6.23.tar.bz2 && cd linux-source-2.6.23
  6. Apply the patch:
    patch -p1 < ../hdaps/hdaps-protect.2.6.23.patch
  7. As a starting point for configuration, you can use the Debian .config file
    su -c 'aptitude install linux-headers-2.6.23-1-amd64'
    cp ../linux-headers-2.6.23-1-amd64/.config .

    This is the recommended route if this is your first time compiling a kernel. Alternatively, you can take a look at mine, which is highly customised to my particular model and you should probably go through yourself to make sure it's not missing anything that you want.
  8. To edit/view the configuration with the "user friendly" gui
    make xconfig
  9. Once you've gotten a suitable configuration
    export CONCURRENCY_LEVEL=3 && fakeroot make-kpkg clean && fakeroot make-kpkg --append-to-version=.mycfg kernel_image
  10. While your kernel is compiling you might take a minute to make it easier on yourself when it comes time to install it. It seems that by default dpkg does nothing special when it installs a kernel package. This is WRONG! If you don't add the kernel to the /boot/grub/menu.lst file, then it will just sit in your /boot directory doing nothing. You can solve this by running update-grub after you install or remove a kernel. One better however is to tell dpkg to do the dirty work for you:
    printf 'postinst_hook=/sbin/update-grub\npostrm_hook=/sbin/update-grub\n' >> /etc/kernel-img.conf
  11. This is also a good time to tweak your boot parameters. One in particular is vga=794 which tells the kernel to display the console at higher resolution that default. To enable this, find the section that looks like
    ## ## Start Default Options ##
    ## default kernel options
    ## default kernel options for automagic boot options
    ## If you want special options for specific kernels use kopt_x_y_z
    ## where x.y.z is kernel version. Minor versions can be omitted.
    ## e.g. kopt=root=/dev/hda1 ro
    ## kopt_2_6_8=root=/dev/hdc1 ro
    ## kopt_2_6_8_2_686=root=/dev/hdc2 ro
    # kopt=root=/dev/sda11 ro
    and change the last line to
    # kopt=root=/dev/sda11 ro vga=794
    That's right, keep it commented. Debian's update-grub command reads the comments and uses them to decide how to format that actual entries further down in the file.
  12. After a little under 10 minutes thanks to some hot dual core action, you'll have a .deb package containing your very own kernel. Just install it as you would any other .deb
    su -c 'dpkg -i /usr/src/linux-image-2.6.23.mycfg_2.6.23.mycfg-10.00.Custom_amd64.deb'
  13. This should handle the painful part for you. You should now be able to reboot and select your custom kernel on your bootloader screen.
NOTE!
If you notice that your kernel is repeatedly spewing the message
hda: drive_cmd: status=0x51 { DriveReady SeekComplete Error }
hda: drive_cmd: error=0x04 { AbortedCommand }
ide: failed opcode was: 0xef
Saying yes to the IDEDISK_MULTI_MODE kernel option under Device Drivers->ATA/ATAPI/MFM/RLL->Use multi-mode by default in the xconfig menu won't solve your problem as the description suggests. This is more likely caused by power management scripts calling hdparm on the cdrom. See below for the real solution.

Wireless with madwifi

I had the brilliant idea of getting the 11n capable ThinkPad_11a/b/g/n wireless adaptor which is really just an Atheros AR5418. In retrospect, I should have gone with a more sensible choice like the Intel Pro which is directly supported in the mainline kernel. I think it's fair to say that Atheros is the ATI of wireless cards in terms of Linux support. It works, but you'll pull your hair out in the process. Since the AR5418 is so new, the latest release of madwifi doesn't even support this card. However the latest subversion snapshot does (though of course only up to 11g).

As you've probably noticed I'm going with a 64 bit system. Thus the more stable ndiswrapper won't work because the windows driver supplied by Lenovo is 32bit only. But don't go thinking that going 32 bit and using ndiswrapper will get you 11n. It won't.

That said, to install the latest snapshot of madwifi, you first need to install subversion.

aptitude install subversion

If you skipped the kernel compilation step above and are using a stock Debian kernel, you will also need to install your kernel headers.

aptitude install linux-headers-`uname -r`

Where "`uname -r`" is of course evaluated by the shell to the currently running kernel version.

Now follow the howto. Pay attention to the note at the end about changing the name of the device to wlan0. This was written by me, so it's fair to assume that you'll encounter the same thing using Debian.

wpa_supplicant

wpa_gui is quite a powerful applications that lets you interact with a running wpa_supplicant in an intuitive way. It allows you to scan and connect to available networks as well as save and delete preferred networks. By default however wpa_gui has to be run as root because only root has permissions to affect wpa_supplicant. To remedy this, ensure that your wpa_supplicant.conf has the global settings

ctrl_interface_group=netdev
update_config=1

near the top of the file. "netdev" is the name of the group which is allowed access to the wpa_supplicant interface and update_config allows you to save changes to your preferred networks. You now need to add yourself to the netdev group so you can run wpa_gui.

adduser <you> netdev

You'll be added to the group after completely logging out and logging back in. The only minor annoyance is that wpa_gui is still located in /usr/sbin which is not in your default path. As such, you might want to create a symbolic link to it in /usr/bin/

ln -s /usr/sbin/wpa_gui /usr/bin/

If you want maximum control over how various wireless networks are setup, you can of course edit wpa_supplicant.conf directly. You can get a comprehensive list of examples by typing the command

zless /usr/share/doc/wpasupplicant/examples/README.wpa_supplicant.conf.gz

Don't bother however putting any comments in the wpa_supplicant.conf file since these will be erased if you have the update_config=1 parameter set as described above.

tp_smapi

tp_smapi is a module that allows you to access various bits of information about your thinkpad generally focused around the battery. It also provides a more up to date driver for the hdaps accelerometer. Here's how to get it running:

  1. Get the source:
    wget http://downloads.sourceforge.net/tpctl/tp_smapi-0.34.tgz
  2. Unzip the source and go into the directory:
    tar xvzf tp_smapi-0.34.tgz && cd tp_smapi-0.34
  3. Build and install it with the new hdaps driver:
    make install HDAPS=1
  4. In order to get the module probed on bootup, just add "tp_smapi" to /etc/modules.
    echo tp_smapi >> /etc/modules
  5. You can find a list of userspace applications that utilise this driver here. I use the gkrellm plugin:
su -c 'aptitude install libgtk2.0-dev'
cd /usr/local/src
wget http://www.ksp.sk/~rasto/gkrellm-thinkbat/gkrellm-thinkbat-latest.tar.gz
tar xvzf gkrellm-thinkbat-latest.tar.gz
cd gkrellm-thinkbat-0.2.2
make install

Configuring ACPI

thinkpad_acpi/enabling hotkeys

First of all, similar to tp_smapi it seems that thinkpad-acpi doesn't load automatically, so put it in /etc/modules as well.
echo thinkpad_acpi >> /etc/modules

If it has somehow found itself installed (as is the case if you selected "laptop" packages in the initial installation), get rid of hotkey-setup. It's totally unnecessary with the new thinkpad-acpi module which captures all the keys just fine.

aptitude purge hotkey-setup

The same goes for tpb. thinkpad-acpi now covers the gap in key-coverage that this previously made up for.

Now to enable some hotkeys. Assuming you have acpid running, you can monitor acpi events by typing

tail -f /var/log/acpid

You'll find that with thinkpad_acpi probed with the default parameters, you get an acpi event for all Fn-F# key combinations except Fn-F7 and Fn-F10. You also get acpi events for Fn-Space, Fn-Home, Fn-End, Fn-PgUp, ThinkVantage, Mute, VolUp, VolDown, Power, Wireless switch on/off as well as lid open/close. You might notice however that the Fn-F4 and Fn-F10 events seem to register for individual keypresses that are sufficiently spaced in time. You can enable an event for Fn-F7, by changing the value of /sys/devices/platform/thinkpad_acpi/hotkey_mask to the value of /sys/devices/platform/thinkpad_acpi/hotkey_all_mask.

cat /sys/devices/platform/thinkpad_acpi/hotkey_all_mask > /sys/devices/platform/thinkpad_acpi/hotkey_mask

To make this permanent, you need to change the mask in /etc/modprobe.d/thinkpad_acpi.modprobe so that the the only uncommented line is

options thinkpad_acpi hotkey=enable,0x00ffffff experimental=1

acpid

The next question you're probably asking is "what do you with all these acpi events?". That's where acpid comes in. Every time the acpid deamon starts up, it reads all the files contained in the /etc/acpi/events directory. These files contain the names of all events that acpi should acknowledge and what to do when they are recieved. The syntax is pretty simple:

event=<name of event>
action=<what to execute upon registering that event>

As noted previously, you can experiment with generating various events by watching the /var/log/acpid file and determining what events go with what key. You might also notice that there are a few events that are generated by other things (like a change in CPU frequency scaling states). By convention the action scripts are all contained in /etc/acpi/. If you write your own, make sure they have the same permissions as all the others. For more info check out the How to configure acpid page. You might also want to check out How to get special keys to work for some attempts at cataloguing some of the events generated. Note that you can change the scripts without restarting acpid but if you change the event files, you need to restart it so that it reads in the modified versions.

Though you can turn acpi events into user-level xevents, the main advantage of using acpi events is that you can use the special keys to execute scripts that require root access (since acpid is run by root). You should also keep this in mind from a security perspective. You shouldn't give too much power to the hotkeys lest you allow someone to do too much without the root password.

browser keys

You can make the "back" and "forward" keys above the left and right arrows do pretty much anything you want. Since they generate their own X-events (keycodes 234 and 233 respectively), they can be mapped to whatever keysym you want via Xmodmap. For example, I mapped them to F19 and F20 in my systemwide /etc/X11/Xmodmap file so they are automatically mapped for all users.

keycode 234 = F19
keycode 233 = F20

There are a couple ways you can get Firefox (or rather iceweasel) to correctly recognize these keysyms. You could install keyconfig.xpi and configure the keybindings via Tools->Keyconfig, but this is only user specific and quite frankly just too easy. So I went about doing it the hard way and editing /usr/share/iceweasel/chrome/browser/content/browser/browser.xul. Both are described in detail here.

The latter method has the advantage that paired with the system wide Xmodmap discussed above, all users automatically have working browser keys. The disadvantage (other than having to dig around in a hairy .xml file) is that whenever you upgrade or reinstall firefox, your changes disappear and you have to go back in there and do it again. To mitigate slightly this last problem, I wrote the following script and put it in /usr/local/sbin/firefox-keys

#!/bin/sh
FILE=/usr/share/iceweasel/chrome/browser/content/browser/browser.xul

grep -q VK_F20 $FILE
if [ $? != 0 ];then
sed 's|<key id="goForwardKb2" key="\&goForwardCmd.commandKey;" command="Browser:Forward" modifiers="accel"/>|<key id="goForwardKb2" key="\&goForwardCmd.commandKey;" command="Browser:Forward" modifiers="accel"/>\n    <key id="goBackKb" keycode="VK_F19" command="Browser:Back" />\n    <key id="goForwardKb" keycode="VK_F20" command="Browser:Forward" />|g' $FILE > $FILE.tmp
mv $FILE.tmp $FILE
fi
exit 0

Then I just have to run this script everytime Iceweasel is updated. But wait, that seems pretty programmatic. Isn't there some way to automatically run the script when Iceweasel is updated? The answer is yes. I created the file /etc/apt/apt.conf.d/98-iceweasel-keys and added the following to it

// Add browser keys to firefox if it's being installed

DPkg
{
Pre-Install-Pkgs {"cat > /tmp/pkgs";};
Post-Invoke {"if grep -iq iceweasel /tmp/pkgs && [ $(ps w -p "$PPID" | grep -c remove) != 1 ];then /usr/local/sbin/firefox-keys;else exit 0;fi";};
};

It's kind of hackish, but here's the idea. Whenever apt calls dpkg, it will first call the command listed in Pre-Install-Pkgs passing the names of all the packages as standard input (which get tossed into /tmp/pkgs). Then after dpkg has been invoked and installed everything, the Post-Invoke command is called which checks if any of those packages were Iceweasel. If the case insensitive pattern "iceweasel" is among their names (and the package in question is not being removed rather than installed), the aforementioned firefox-keys script will be invoked. The natural question is why I need this intermediate file. Well for some weird reason apt does not pass the package names to the Post-Invoke commands.

dpkg-divert /etc/acpi

You're likely going to want to do a lot of customising of the /etc/acpi/ directory, most of which was originally put there by the acpi-support package. The problem with this is that next time there's an update to that package it's going to want to change back all those changes you made to the distribution defaults. Now the distribution defaults are good for a reference point, but you want ultimate control over how your acpi system behaves and don't want it changing every time that there's a package upgrade. Enter dpkg-divert. This handy utility will allow you to keep the original distribution files and even have them upgraded, but keep your heavily customised /etc/acpi directory safe. Before modifying a file that you will not want subsequently changed by the package manager, you can dpkg-divert it so that future upgrades do not overwrite it.

dpkg-divert --add --rename --divert  <path to file>.dpkg-dist <path to file>

This will move the original file to one of the same name with the .dpkg-dist extension and divert files from any packages to the latter. Now if you want to use the distribution default as a staring point for your modifications, you can just copy it back

cp  <path to file>.dpkg-dist <path to file>

And begin editing.

If you're going to be editing the majority of the files in /etc/acpi, you might want to divert the whole directory. Unfortunately, dpkg-divert doesn't officially divert directories, but here's how you can hack it to nearly do it. First create a mirror acpi.dpkg-dist directory structure.

cd /etc/acpi
find -type d |  xargs -i mkdir -p /etc/acpi.dpkg-dist/{}

Now divert all the files in /etc/acpi to this new directory structure.

find -type f | cut -d/ -f 2- | xargs -i dpkg-divert --add --rename --divert /etc/acpi.dpkg-dist/{} /etc/acpi/{}

Finally copy the distribution defaults back for a staring point to your massive customisation.

cp -r /etc/acpi.dpkg-dist /etc/acpi

The limitation of this of course is that if future versions of the packages have new files in this directory, or if you install new packages that want to put files in here, they will not be diverted, and you will have to add these to your diversions as they appear.

hd power management: laptop-mode

There was a lot of buzz a couple months back about aggressive hd power management shortening the life of drives by excessively parking and unparking the disk heads (note that this is different that what happens with hdapsd). I'm not going to go into the gorey details. You should probably follow the above link and dig around on the web if you're really concerned about this. Suffice it to say, it's a good idea to have an awareness of hd power management an in particular be aware that there is some overlapping functionality between the laptop-mode and acpi-suppport packages and that if you aren't careful, they may even come into conflict.

First of all, you may note that in the above init scripts, I have disabled acpi-support. If you take a look at what that does and follow your nose, you'll find that pretty much the only thing it's doing is running /etc/acpi/battery.d/90-hdparm.sh which sets aggressive disk power management for both hard disk and cdrom if it is detected that the laptop is on batteries at bootup. On the other hand, it sets it less aggressively with /etc/acpi/ac.d/90-hdparm.sh if ac power is detected. You'll also find that there is an acpi event associated with connecting and disconnecting the power which, by default call the script /etc/acpi/power.sh which runs one of the aforementioned scripts according to the new adapter state.

This is probably a good idea in principle. Aggressive power management tells the disks to spin down more often and thereby conserve battery power. Laptop hard disks are designed to do this relatively frequently, but their so-called rated "load-cycle count" is finite falling generally in the 600,000 parks/unparks range. But there is more . . .

For one, it doesn't appear that the cdrom plays well with the hdparm command used to modify the power settings as evidenced by scary looking kernel messages to the tune of

hda: drive_cmd: status=0x51 { DriveReady SeekComplete Error }
hda: drive_cmd: error=0x04 { AbortedCommand }
ide: failed opcode was: 0xec

upon even querying the drive with what should be an innocuous request for basic information: hdparm -I /dev/hda. For this reason, it would seem that we don't want to be sending any hdparm commands to the cdrom drive.

Secondly, there is the issue that you might have laptop-mode enabled to to do the same thing and you probably don't want the two doubling the effort, or worse, fighting with each other. Something further to consider is that at the same time as it deals with the level of drive power management, laptop-mode makes an effort not to spin the drive up as often once it's been spun down. It would seem to make sense then, to have both these efforts coordinated by the broader scope of laptop-mode alone. As an added bonus, laptop-mode doesn't touch the cdrom.

So here's how I hand the matter over to laptop mode:

  1. Disable the /etc/init.d/acpi-support boot script with sysv-rc-conf as described above.
  2. Remove, or better yet, divert the files 90-hdparm.sh from /etc/acpi/ac.d and /etc/acpi/battery.d and /etc/acpi/resume.d.
  3. Make sure laptop-mode gets started at boot up with sysv-rc-conf also as described in the init script section.
  4. Enable hardrive power managment from within laptop mode by editing /etc/laptop-mode/laptop-mode.conf so that the line
    CONTROL_HD_POWERMGMT=0
    becomes
    CONTROL_HD_POWERMGMT=1
  5. If you want to be a more conservative with your drive life (at the expense of battery life), you probably want to change the line
    BATT_HD_POWERMGMT=1
    to something more like
    BATT_HD_POWERMGMT=180
  6. Now you can enhance laptop mode to further reduce drive spin up. First, you can have syslog not sync all the time on battery which requires disk write access and consequently spinup. Just run lm-syslog-setup and answer yes to the question of whether or not you want to create the split syslog configuration.
  7. You can crank up the LM_READAHEAD=8192 if you have lots of RAM (don't forget to make sure that CONTROL_READAHEAD=1).
  8. You can set CONTROL_NOATIME=1 to prevent disk writes related to updating file access times while on battery.

This is only the tip of the iceberg for laptop-mode configuration.

sleep

Though you can make your laptop sleep, by simply executing

echo -n $ACPI_SLEEP_MODE >/sys/power/state

The /etc/acpi/sleep.sh script wraps this command in some other niceties that may ease the transition in and out of sleep. In particular, it sources the scripts in /etc/acpi/suspend.d before sleeping and those in /etc/acpi/resume.d after awaking. If you feel uneasy about playing with these scripts yourself, you can alter some of their behaviour by editing the /etc/defaults/acpi-support.

It would seem to make sense to bind the Fn-F4 key with the moon on it to the /etc/acpi/sleep.sh script.

automated sleep

You could also set it up so that your laptop goes to sleep when you close the lid. I however prefer to have my laptop remain awake when the lid is closed so that it can continue background tasks such as ripping a cd, downloading a file, compiling a kernel, playing music, etc. I do however want to have some system of going to sleep during inactivity. For this I use the sleepd package which automatically puts the laptop to sleep after a period of inactivity. It does however requires some configuration to make it actually do this.

First of all, if you haven't already installed it, do so

aptitude install sleepd

Now edit the configuration file /etc/default/sleepd. Set PARAMS to the arguments you want to give the sleepd daemon as started by init. You can take a look at the sleepd man page to get an idea of what you might want to put here. As an example, you might have

PARAMS="-u 180 -U 1800 -s /etc/acpi/sleep.sh -i 1 -i 12 -i 23"

This tells sleepd to sleep after three minutes of inactivity while on battery(-u 180) and after half an hour of inactivity while on ac (-U 1800). I have defined "activity" as signals on irqs 1(keyboard), 12(mouse), and 23(usb mouse) (-i 1 -i 12 -i 23). 1 and 12 will be autodetected, but 23 may not be. You can see what uses the various interrupts by running the command cat /proc/interupts.You can also use the xosview utility to discover when the various IRQ's are used. Finally sleepd itself doesn't actually know how to put the computer to sleep, so you have to supply it with the command to do so (-s /etc/acpi/sleep.sh). You could really put anything at all here.

You'll note however, that the above is a rather limited definition of "inactivity". Unfortunately, it's the best sleepd has to offer. Alas, none of the above mentioned background tasks that I want my computer to continue doing can be reliably mapped to the use of a particular IRQ. The next best thing then is to have our sleep command be a script that before putting the computer to sleep checks for a wider range of activity before actually going to sleep and aborts the sleep process if such activity is detected. This will reset the sleepd timer so that it must wait for an other interval of human inactivity before running the sleep/check script again.

There are four checks that I want to do before going to sleep:

  1. CPU activity
  2. Disk activity
  3. Network activity
  4. Is sound playing?

The first three can be checked using the sar utility included in the sysstat package, while the latter can be checked using the rec utility included in the sox package. If you haven't already, install those packages. Sox is additionally going to need alsa support, so you could install that package, or just go ahead an install off of sox since its a handy program to have the full functionality of.

aptitude install sysstat sox sox-fmt-all

The following script autosleep.sh is intended to be called by sleepd after user inactivity to check for the background inactivity described above. If there is inactivity in these four fronts, it calls the sleep.sh script and puts the computer to sleep.

#!/bin/bash
# autosleep.sh
# Checks if the computer is inactive before going to sleep. Aborts if it looks like 
# there's some action.
#

# Thresholds - these may depend on what you do with your computer and what 
# you want it to stay awake for.
CPUTHRESH=5        # in percent 
DISKTHRESH=500     # in blocks/sec (the sar manpage says blocks are 512 bytes in normal cases) 
NETTHRESH=10       # in kB/s
SNDTHRESH=200      # in ???? rms 
# (no sound playing is ~25 while playing mp3 w/ pcm+master turned all the way to zero is ~250)

# Sample times (in seconds) - again needs may vary
CPUTIME=1   
DISTTIME=2  
NETTIME=2 
SNDTIME=2 


# Check CPU usage defined as non-idle time.
CPU=`sar $CPUTIME 1 | awk '/Average/ { printf "%d\n",100-$8}'`
echo "CPU = $CPU%"
if [ $CPUTHRESH -lt $CPU ];then
    echo CPU is working, not sleeping
    exit;
fi

# Check disk usage (read + write)
DISK=`sar -b $DISKTIME 1 | awk '/Average:/ { printf "%d",$5 + $6 }'`
echo "DISK = $DISK"
if [ $DISKTHRESH -lt $DISK ];then
    echo Disk is working, not sleeping
    exit;
fi

# Check net usage (exclude wifi0 which appears to have activity all the time for some weird reason)
NET=`sar -n DEV $NETTIME 1 | awk '/Average:/ && $2 !~ /(IFACE|wifi0)/ { SUM += $5 + $6 } END { printf ("%d\n",SUM)}'`
echo "NETWORK = $NET"
if [ $NETTHRESH -lt $NET ]; then
    echo Network is in use, not sleeping
    exit;
fi

# Set the mixer to some controlled values and set it to record the mixed sound output
# This unfortunately is going to be sound-chip specific.
alsactl -f /var/tmp/sound.state store
amixer sset Capture 20% cap
amixer sset Digital 20%
amixer sset Mix cap
# Record to null and use RMS amplitude in resulting statistics with a convenience 
# factor to make it integer
SND=`rec -n stat trim 0 $SNDTIME 2>&1 | sed -n 's/^RMS[ ]*amplitude:[ ]*/1000000 * /gp' | bc | cut -d. -f 1`
# Restore previous mixer state
alsactl -f /var/tmp/sound.state restore
echo "SOUND = $SND"
if [ $SNDTHRESH -lt $SND ];then
    echo Sound is playing, not sleeping
    exit;
fi

. /etc/acpi/sleep.sh

hibernate

Hibernate works with the described setup (my custom compiled kernel in particular) by running /etc/acpi/hibernate.sh as long as I don't have the uswsusp package installed. I could probably get it to work with uswsusp if I worked at it, but I don't really care since I don't hibernate all that often. Of note, I have the boot parameter resume=/dev/sda2 (my swap partion) added to the kopt= variable in my /boot/grub/menu.lst so that running update-grub appends this option to my kernel:

# kopt=root=/dev/sda11 ro resume=/dev/sda2 vga=792

results in

title		Debian GNU/Linux, kernel 2.6.23-amd64.005
root		(hd0,2)
kernel		/vmlinuz-2.6.23-amd64.005 root=/dev/sda11 ro resume=/dev/sda2 vga=792 
savedefault

The above is actually probably unnecessary in my case as I have set PM_STD_PARTITION=/dev/sda2 in my kernel config which can be found under Power Management Options -> Hibernation (aka 'suspend to disk') -> Default resume partition:.

64-bit headaches

Java

Ok, so Sun is being lazy and though they've made an amd64 java, they didn't bother to make the accompanying browser plugin. So you're left to try and use the 32-bit version that I've included in my package list above. Unfortunately, this won't work in iceweasel as flash does. You don't however have to start mucking about with chroots if you really need that no doubt ridiculous java app to work. Go to the Firefox download site and grab the linux version. Also if you didn't get it with the rest of the packages I recommended above, get ia32-sun-java5-bin. For some reason this trick doesn't work with ia32-sun-java6-bin, it ends up just hanging the browser.

aptitude install ia32-sun-java5-bin

Now go to the directory where you saved the firefox tarball (it can even be in a subdirectory of your home directory), unzip it and put a symlink to libjavaplugin_oij.so in the firefox/plugins directory.

tar xvzf firefox-2.0.0.11.tar.gz
ln -sf /usr/lib/jvm/ia32-java-1.5.0-sun-1.5.0.13/jre/plugin/i386/ns7/libjavaplugin_oji.so firefox/plugins/

Now, you're ready to enjoy all the wonderful java content the web has to offer via your personal firefox installation. First close any iceweasels you have running, then run

firefox/firefox http://www.java.com/en/download/help/testvm.xml

You should see the stupid java guy. Until Sun joins the rest of us in the 21st century, you're going to have to use this firefox to view web-applets. The good news is that the vanilla firefox will seamlessly use the same profile directory as iceweasel. You can even use it as your main browser if you want. There's also this blackdown java I've heard of that has a 64-bit web plugin, but the things I've read about its instability have not encouraged me to go hunting for it.

32-bit Maple 11

This takes a bit of fiddling, but it will work. First, you're going to want to use 32 bit java to run the installer.

aptitude install aptitude install ia32-sun-java6-bin 
update-alternatives --config java

And select /usr/lib/jvm/ia32-java-6-sun/jre/bin/java. Then

mount /media/cdrom
/media/cdrom/Maple11Linux32Installer.bin

The problem is that maple tries to be all smart when you actually run maple11/bin/maple or maple11/bin/xmaple which call end up calling maple11/bin/maple.system.type. Of course the answer is going to be which of course it determines is bin.X86_64_LINUX. Trouble is you've only installed bin.IBM_INTEL_LINUX which you can run fine on the detected platform, but which maple won't let you. To remedy this, prevent maple11/bin/maple calling maple11/bin/maple.system.type in the first place and just hard-code the desired architecture.

MAPLE_SYS_BIN=bin.IBM_INTEL_LINUX

Once you have it installed, you can update-alternatives again and go back to a 64 bit java if you like.