TOI user interface appeared in 2.1.7 as a "Possibly broken developer option". It allows you put the user interface of software suspend into a userspace process which offers a great deal of flexibility as to what can be done. The great thing is NO kernel fbsplash patch is required!
Remember, User interface progress reporting (Splash and even the text UI a little)[http://wiki.tuxonice.net/BenchMarks may slow down suspend/resume].
To get things going, you'll need the following:
- A toi enabled kernel. Test that hibernate/resume works well before you install userUI to facilitate easier debugging.
The userspace UI sources. Download these from the [http://www.tuxonice.net/downloads/] download page under the "Userspace UI" section.
- For tuxoniceui_text - this provides a text-based progress bar
For tuxoniceui_fbsplash - an fbsplash theme, such as the [http://www.tuxonice.net/downloads/all/snowboard-tux*.tar.bz2 Snowboarding Tux] theme or the [http://www.colitti.com/lorenzo/software/tuxonice/Debian-tuxonice/ Debian-tuxonice theme].
Steps:
- Patch, compile and boot your kernel with toi.
- Download the userui sources, extract, and compile them by typing "make", and "make install". This will install tuxoniceui_text and tuxoniceui_fbsplash into "/usr/local/sbin" by default. tuxoniceui_fbsplash will only compile if you have all the relevant libraries and dev files (libpng, libz, libjpeg, libmng and the libfreetype6-dev files).
In your hibernate script, put the path to the tuxoniceui_text or tuxoniceui_fbsplash binary into /proc/software_suspend/userui_program. For example, in the hibernate.conf configuration file usually located in /etc/hibernate, add or uncomment the line {{{ProcSetting userui_program /usr/local/sbin/tuxoniceui_text
}}} If you have your own custom script, use {{{echo /usr/local/sbin/tuxoniceui_text > /proc/software_suspend/userui_program }}}.
(This step is somewhat optional - if you omit it, you simply will not have a user interface for the first portion of resuming).BR Add the tuxoniceui_text or tuxoniceui_fbsplash binary to your initrd image and set your initrd script to set the userui_program path appropriately (if it is in a different location in the initrd image).
(This step for fbsplash only).BR Extract the fbsplash theme into /etc/splash/, and make a symlink from /etc/splash/tuxonice to the theme you want to use for suspending. eg
{{{cd /etc/splash ln -s snowboard-tux tuxonice }}}
- Login on a console as root, and run "/usr/local/sbin/tuxoniceui_text -t" (or tuxoniceui_fbsplash -t ) to check that everything goes to plan. This runs the user interface in test mode. If it doesn't work here, it's unlikely to work when suspending.
- Suspend!
- If you want to bleeding edge code then try:
svn checkout http://svn.tuxonice.net/tuxonice-userui/trunk tuxonice-userui
Troubleshooting:
On Fedora Core if you cannot compile userui due to {{{cannot find -lmng
}}} error, install libmng-static package.BROther packages required: lcms-devel, ...BRYou can download compiled packages at [http://mhensler.de/swsusp/].
[http://www.tuxonice.net/userui Main userUI page]
Please report any bugs to either the tuxonice mailing list at http://www.tuxonice.net/lists Last updated: 13 Jan 2008