Patch: radeonhd manpage
![](https://seccdn.libravatar.org/avatar/484d09dce4d53c8e1a4965c3ffe927c0.jpg?s=120&d=mm&r=g)
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Cheers, I have just added documentation for ForceLowPowerMode and LowPowerModeEngineClock to the radeonhd manpage. Here's the patch (any feedback is appreciated): diff --git a/man/radeonhd.man b/man/radeonhd.man index 1cece43..490d9d1 100644 - --- a/man/radeonhd.man +++ b/man/radeonhd.man @@ -485,6 +485,15 @@ This option isn't implemented yet and has no effect. .RE .PP .PD +.TP +.BI "Option \*qForceLowPowerMode\*q \*q" boolean \*q +Enable a static low power mode. This can help reduce heat and increase battery +life by reducing power usage at the expense of performance. The default is +.B off. +.TP +.BI "Option \*qLowPowerModeEngineClock\*q \*q" integer \*q +LowPowerModeEngineClock controls what the clock is set to, in Hz. +If unset, (default_engine_clock / 2) is used .\" .\" .SH RANDR OUTPUT PROPERTIES -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) Comment: Using GnuPG with SUSE - http://enigmail.mozdev.org iEYEARECAAYFAkn0n5AACgkQSufthXk+NIHeuwCgqF2c2ilYWho87nR+QI3Yl2OO RKQAoJHNU4ZXj9G3R9DulrBXTo25Ane6 =10e1 -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: radeonhd+unsubscribe@opensuse.org For additional commands, e-mail: radeonhd+help@opensuse.org
![](https://seccdn.libravatar.org/avatar/1964acfaf091476dc23e13fcb67f2e0c.jpg?s=120&d=mm&r=g)
2009/4/26 Tristan Hoffmann
+.BI "Option \*qForceLowPowerMode\*q \*q" boolean \*q +Enable a static low power mode. This can help reduce heat and increase battery +life by reducing power usage at the expense of performance. The default is +.B off.
Some additional info would be nice. What does this option actually changes? Engine clock? Memory clock? Number of used lanes? Should I use this with LowPowerModeEngineClock?
+.BI "Option \*qLowPowerModeEngineClock\*q \*q" integer \*q +LowPowerModeEngineClock controls what the clock is set to, in Hz. +If unset, (default_engine_clock / 2) is used
It's quite hard for not-technical person to use it. I have no idea what is my default_engine_clocl (grepped Xorg.0.log for "Hz" without result). If unset is this always equal (default_engine_clock / 2)? Or only when using LowPowerModeEngineClock? -- Rafał Miłecki -- To unsubscribe, e-mail: radeonhd+unsubscribe@opensuse.org For additional commands, e-mail: radeonhd+help@opensuse.org
![](https://seccdn.libravatar.org/avatar/1964acfaf091476dc23e13fcb67f2e0c.jpg?s=120&d=mm&r=g)
W dniu 26 kwietnia 2009 21:06 użytkownik Rafał Miłecki
+.BI "Option \*qLowPowerModeEngineClock\*q \*q" integer \*q +LowPowerModeEngineClock controls what the clock is set to, in Hz. +If unset, (default_engine_clock / 2) is used
It's quite hard for not-technical person to use it. I have no idea what is my default_engine_clocl (grepped Xorg.0.log for "Hz" without result). If unset is this always equal (default_engine_clock / 2)? Or only when using LowPowerModeEngineClock?
Oops, just found it by grepping for "Clock" (not "clock"). Almost then OK. Just one question: can I use any value here? Or does it have to be power of 2? -- Rafał Miłecki -- To unsubscribe, e-mail: radeonhd+unsubscribe@opensuse.org For additional commands, e-mail: radeonhd+help@opensuse.org
![](https://seccdn.libravatar.org/avatar/aa24984c190be65ba9054306350706f9.jpg?s=120&d=mm&r=g)
2009/4/26 Tristan Hoffmann
+.BI "Option \*qForceLowPowerMode\*q \*q" boolean \*q +Enable a static low power mode. This can help reduce heat and increase battery +life by reducing power usage at the expense of performance. The default is +.B off.
Something more concise that explains what it does instead of what can be achieved by setting it might be better. It essentially enables statically setting the GPU engine clock.
+.TP +.BI "Option \*qLowPowerModeEngineClock\*q \*q" integer \*q +LowPowerModeEngineClock controls what the clock is set to, in Hz. +If unset, (default_engine_clock / 2) is used
This is only effective when ForceLowPowerMode is turned on; the relationship should be made clear. Also redundant to repeat the option name. I really should have documented these myself, but I'm all for other people doing the work. :) -- Yang Zhao http://yangman.ca -- To unsubscribe, e-mail: radeonhd+unsubscribe@opensuse.org For additional commands, e-mail: radeonhd+help@opensuse.org
![](https://seccdn.libravatar.org/avatar/484d09dce4d53c8e1a4965c3ffe927c0.jpg?s=120&d=mm&r=g)
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Yang Zhao wrote:
2009/4/26 Tristan Hoffmann
: +.BI "Option \*qForceLowPowerMode\*q \*q" boolean \*q +Enable a static low power mode. This can help reduce heat and increase battery +life by reducing power usage at the expense of performance. The default is +.B off.
Something more concise that explains what it does instead of what can be achieved by setting it might be better. It essentially enables statically setting the GPU engine clock.
+.TP +.BI "Option \*qLowPowerModeEngineClock\*q \*q" integer \*q +LowPowerModeEngineClock controls what the clock is set to, in Hz. +If unset, (default_engine_clock / 2) is used
This is only effective when ForceLowPowerMode is turned on; the relationship should be made clear. Also redundant to repeat the option name.
I really should have documented these myself, but I'm all for other people doing the work. :)
So what about describing ForceLowPowerMode with the following: Enabling this option will set the GPU engine clock to a low value, statically. This can help reduce heat and increase battery life by reducing power usage at the expense of performance. You can specify the GPU engine clock with the LowPowerModeEngineClock option. If you don't specify the engine clock it will be set to (default_engine_clock / 2). LowPowerModeEngineClock: This option controls what the GPU engine clock is set to (in Hz), when the option ForceLowPowerMode is used. Otherwise this option will have no effect. Any other suggestions? If not I'll shortly sent a reworked patch. Tristan -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) Comment: Using GnuPG with SUSE - http://enigmail.mozdev.org iEYEARECAAYFAkn0vLgACgkQSufthXk+NIEfsACfY7kEjYz2uZrTTFUdfb3xxJ4d hXoAn3kuhRTlUnofzxd4ZADyKouHt4Mo =ejQQ -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: radeonhd+unsubscribe@opensuse.org For additional commands, e-mail: radeonhd+help@opensuse.org
![](https://seccdn.libravatar.org/avatar/aa24984c190be65ba9054306350706f9.jpg?s=120&d=mm&r=g)
2009/4/26 Tristan Hoffmann
So what about describing ForceLowPowerMode with the following: Enabling this option will set the GPU engine clock to a low value, statically. This can help reduce heat and increase battery life by reducing power usage at the expense of performance. You can specify the GPU engine clock with the LowPowerModeEngineClock option. If you don't specify the engine clock it will be set to (default_engine_clock / 2).
Even simpler: Enable to statically set GPU engine clock to a lower than default value. This can help reduce power consumption. Default is off.
LowPowerModeEngineClock: This option controls what the GPU engine clock is set to (in Hz), when the option ForceLowPowerMode is used. Otherwise this option will have no effect.
Engine clock frequency to use when ForceLowPowerMode is enabled, in Hz. If not set, half of default clock frequency is used. -- Yang Zhao http://yangman.ca -- To unsubscribe, e-mail: radeonhd+unsubscribe@opensuse.org For additional commands, e-mail: radeonhd+help@opensuse.org
participants (3)
-
Rafał Miłecki
-
Tristan Hoffmann
-
Yang Zhao