Gentoo Archives: gentoo-doc-cvs

From: Jan Kundrat <jkt@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: power-management-guide.xml
Date: Mon, 21 Jan 2008 12:12:15
Message-Id: E1JGvVc-0001zh-Gb@stork.gentoo.org
1 jkt 08/01/21 12:12:12
2
3 Modified: power-management-guide.xml
4 Log:
5 TuxOnIce is new name of former suspend2 (reported by calchan)
6
7 Revision Changes Path
8 1.33 xml/htdocs/doc/en/power-management-guide.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/power-management-guide.xml?rev=1.33&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/power-management-guide.xml?rev=1.33&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/power-management-guide.xml?r1=1.32&r2=1.33
13
14 Index: power-management-guide.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/power-management-guide.xml,v
17 retrieving revision 1.32
18 retrieving revision 1.33
19 diff -u -r1.32 -r1.33
20 --- power-management-guide.xml 3 Dec 2007 19:31:10 -0000 1.32
21 +++ power-management-guide.xml 21 Jan 2008 12:12:12 -0000 1.33
22 @@ -1,6 +1,6 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/power-management-guide.xml,v 1.32 2007/12/03 19:31:10 swift Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/power-management-guide.xml,v 1.33 2008/01/21 12:12:12 jkt Exp $ -->
27 <guide link="/doc/en/power-management-guide.xml">
28 <title>Power Management Guide</title>
29
30 @@ -23,8 +23,8 @@
31 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32 <license/>
33
34 -<version>1.37</version>
35 -<date>2007-12-03</date>
36 +<version>1.38</version>
37 +<date>2008-01-21</date>
38
39 <chapter>
40 <title>Introduction</title>
41 @@ -154,8 +154,8 @@
42
43 <p>
44 There are different kernel sources in Portage. I'd recommend using
45 -<c>gentoo-sources</c> or <c>suspend2-sources</c>. The latter contains patches
46 -for Software Suspend 2, see the chapter about <uri link="#doc_chap7">sleep
47 +<c>gentoo-sources</c> or <c>tuxonice-sources</c>. The latter contains patches
48 +for TuxOnIce, see the chapter about <uri link="#doc_chap7">sleep
49 states</uri> for more details. When configuring the kernel, activate at least
50 these options:
51 </p>
52 @@ -1332,22 +1332,22 @@
53
54 <p>
55 There are two different implementations for S4. The original one is swsusp,
56 -then there is the newer suspend2 with a nicer interface (including fbsplash
57 -support). A <uri link="http://suspend2.net/features.html#compare"> feature
58 -comparison</uri> is available at the <uri link="http://suspend2.net"> suspend2
59 +then there is the newer tuxonice (former suspend2) with a nicer interface (including fbsplash
60 +support). A <uri link="http://tuxonice.net/features.html#compare"> feature
61 +comparison</uri> is available at the <uri link="http://www.tuxonice.net">tuxonice
62 Homepage</uri>. There used to be Suspend-to-Disk (pmdisk), a fork of swsusp,
63 but it has been merged back.
64 </p>
65
66 <p>
67 -Suspend2 is not included in the mainline kernel yet, therefore you either have
68 +TuxOnIce is not included in the mainline kernel yet, therefore you either have
69 to patch your kernel sources with the patches provided by <uri
70 -link="http://suspend2.net">suspend2.net</uri> or use
71 -<c>sys-kernel/suspend2-sources</c>.
72 +link="http://tuxonice.net">tuxonice.net</uri> or use
73 +<c>sys-kernel/tuxonice-sources</c>.
74 </p>
75
76 <p>
77 -The kernel part for both swusp and suspend2 is as follows:
78 +The kernel part for both swusp and TuxOnIce is as follows:
79 </p>
80
81 <pre caption="Kernel configuration for the various suspend types">
82 @@ -1357,8 +1357,8 @@
83 <comment>(replace /dev/SWAP with your swap partition)</comment>
84 (/dev/SWAP) Default resume partition
85
86 - <comment>(hibernate with suspend2)</comment>
87 - Software Suspend 2
88 + <comment>(hibernate with TuxOnIce)</comment>
89 + Enhanced Hibernation (TuxOnIce)
90 --- Image Storage (you need at least one writer)
91 [*] File Writer
92 [*] Swap Writer
93 @@ -1406,7 +1406,7 @@
94 </pre>
95
96 <p>
97 -The following section discusses the setup of suspend2 including fbsplash
98 +The following section discusses the setup of TuxOnIce including fbsplash
99 support for a nice graphical progress bar during suspend and resume.
100 </p>
101
102 @@ -1414,23 +1414,23 @@
103 The first part of the configuration is similar to the configuration of swsusp.
104 In case you didn't store the location of your swap partition in the kernel
105 config, you have to pass it as a kernel parameter with the
106 -<c>resume2=swap:/dev/SWAP</c> directive. If booting is not possible due to a
107 -broken image, append the <c>noresume2</c> parameter. Additionally, the
108 -<c>hibernate-cleanup</c> init script invalidates suspend2 images during the
109 +<c>resume=swap:/dev/SWAP</c> directive. If booting is not possible due to a
110 +broken image, append the <c>noresume</c> parameter. Additionally, the
111 +<c>hibernate-cleanup</c> init script invalidates TuxOnIce images during the
112 boot process.
113 </p>
114
115 -<pre caption="Invalidating suspend2 images during the boot process">
116 +<pre caption="Invalidating TuxOnIce images during the boot process">
117 # <i>rc-update add hibernate-cleanup boot</i>
118 </pre>
119
120 <p>
121 -Now edit <path>/etc/hibernate/suspend2.conf</path>, enable the <c>suspend2</c>
122 +Now edit <path>/etc/hibernate/suspend2.conf</path>, enable the <c>TuxOnIce</c>
123 options you need. Do not enable the <c>fbsplash</c> options in
124 <c>common.conf</c> just yet.
125 </p>
126
127 -<pre caption="Hibernating with suspend2">
128 +<pre caption="Hibernating with TuxOnIce">
129 # <i>nano -w /etc/hibernate/suspend2.conf</i>
130 <comment>(Make sure you have a backup of your data)</comment>
131 # <i>hibernate</i>
132 @@ -1438,16 +1438,16 @@
133
134 <p>
135 Please configure <c>fbsplash</c> now if you didn't do already. To enable
136 -fbsplash support during hibernation, the <c>sys-apps/suspend2-userui</c>
137 +fbsplash support during hibernation, the <c>sys-apps/tuxonice-userui</c>
138 package is needed. Additionally, you've got to enable the <c>fbsplash</c> USE
139 flag.
140 </p>
141
142 -<pre caption="Installing suspend2-userui">
143 -# <i>echo "sys-apps/suspend2-userui fbsplash" >> /etc/portage/package.use</i>
144 +<pre caption="Installing tuxonice-userui">
145 +# <i>echo "sys-apps/tuxonice-userui fbsplash" >> /etc/portage/package.use</i>
146 <comment>(It may be marked ~arch, so first it must be keyworded)</comment>
147 -# <i>echo "sys-apps/suspend2-userui" >> /etc/portage/package.keywords</i>
148 -# <i>emerge suspend2-userui</i>
149 +# <i>echo "sys-apps/tuxonice-userui" >> /etc/portage/package.keywords</i>
150 +# <i>emerge tuxonice-userui</i>
151 </pre>
152
153 <p>
154 @@ -1461,31 +1461,31 @@
155
156 <p>
157 If you don't want a black screen in the first part of the resume process, you
158 -have to add the <c>suspend2ui_fbsplash</c> tool to your initrd image. Assuming
159 +have to add the <c>tuxoniceui_fbsplash</c> tool to your initrd image. Assuming
160 you created the initrd image with <c>splash_geninitramfs</c> and saved it as
161 <path>/boot/fbsplash-emergence-1024x768</path>, here's how to do that.
162 </p>
163
164 -<pre caption="Adding suspend2ui_fbsplash to an initrd image">
165 +<pre caption="Adding tuxoniceui_fbsplash to an initrd image">
166 # <i>mount /boot</i>
167 # <i>mkdir ~/initrd.d</i>
168 # <i>cp /boot/fbsplash-emergence-1024x768 ~/initrd.d/</i>
169 # <i>cd ~/initrd.d</i>
170 # <i>gunzip -c fbsplash-emergence-1024x768 | cpio -idm --quiet -H newc</i>
171 # <i>rm fbsplash-emergence-1024x768</i>
172 -# <i>cp /usr/sbin/suspend2ui_fbsplash sbin/</i>
173 -# <i>find . | cpio --quiet --dereference -o -H newc | gzip -9 > /boot/fbsplash-suspend2-emergence-1024x768</i>
174 +# <i>cp /usr/sbin/tuxoniceui_fbsplash sbin/</i>
175 +# <i>find . | cpio --quiet --dereference -o -H newc | gzip -9 > /boot/fbsplash-tuxonice-emergence-1024x768</i>
176 </pre>
177
178 <p>
179 Afterwards adjust <path>grub.conf</path> (or <path>lilo.conf</path>) so that
180 -your suspend2 kernel uses
181 -<path>/boot/fbsplash-suspend2-emergence-1024x768</path> as initrd image. You can
182 +your TuxOnIce kernel uses
183 +<path>/boot/fbsplash-tuxonice-emergence-1024x768</path> as initrd image. You can
184 now test a dry run to see if everything is setup correctly.
185 </p>
186
187 <pre caption="Test run for fbsplash hibernation">
188 -# <i>suspend2ui_fbsplash -t</i>
189 +# <i>tuxoniceui_fbsplash -t</i>
190 </pre>
191
192 <p>
193 @@ -1627,7 +1627,7 @@
194 </p>
195
196 <p>
197 -<e>Q:</e> I want to use suspend2, but it tells me my swap partition is too
198 +<e>Q:</e> I want to use TuxOnIce, but it tells me my swap partition is too
199 small. Resizing is not an option.
200 </p>
201
202 @@ -1635,7 +1635,7 @@
203 <e>A:</e> If there is enough free space on your system, you can use the
204 filewriter instead of the swapwriter. The <c>hibernate-script</c> supports it
205 as well. More information can be found in
206 -<path>/usr/src/linux/Documentation/power/suspend2.txt</path>.
207 +<path>/usr/src/linux/Documentation/power/tuxonice.txt</path>.
208 </p>
209
210 <p>
211
212
213
214 --
215 gentoo-doc-cvs@l.g.o mailing list