Difference between revisions of "Package:ACPI Daemon"

From Funtoo
Jump to navigation Jump to search
 
 
(29 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Introduction ==
{{Ebuild
==== What is acpi? ====
|Summary=Daemon for Advanced Configuration and Power Interface
|CatPkg=sys-power/acpid
|Maintainer=
|Homepage=http://sourceforge.net/projects/acpid2/
|Repository=Gentoo Portage Tree
}}
=== What is ACPI? ===
<blockquote>
"In computing, the Advanced Configuration and Power Interface (ACPI) specification provides an open standard for device configuration and power management by the operating system." ([http://en.wikipedia.org/wiki/Advanced_Configuration_and_Power_Interface Wikipedia])
"In computing, the Advanced Configuration and Power Interface (ACPI) specification provides an open standard for device configuration and power management by the operating system." ([http://en.wikipedia.org/wiki/Advanced_Configuration_and_Power_Interface Wikipedia])
</blockquote>


==== What is acpid? ====
=== What is acpid? ===
"ACPID is a completely flexible, totally extensible daemon for delivering ACPI events. It listens on a file (/proc/acpi/event) and when an event occurs, executes programs to handle the event. The programs it executes are configured through a set of configuration files, which can be dropped into place by packages or by the admin." [(http://acpid.sourceforge.net/ acpid Sourceforge)]
<blockquote>
"ACPID is a completely flexible, totally extensible daemon for delivering ACPI events. It listens on a file (''<code>/proc/acpi/event</code>'') and when an event occurs, executes programs to handle the event. The programs it executes are configured through a set of configuration files, which can be dropped into place by packages or by the admin." ([http://acpid.sourceforge.net/ acpid Sourceforge])
</blockquote>


== Preparing to install ==
== Preparing to install ==
==== Kernel configuration ====
=== Kernel configuration ===
Before we are ready to emerge acpid, it is a good idea to modify a few things in the kernel. If you have not modified your kernel before, you may want to check out the following page on configuring a kernel manually (page to be added..).
Before we are ready to emerge acpid, it is a good idea to modify a few things in the kernel. If you have not modified your kernel before, you may want to check out the following page on configuring a kernel manually (page to be added..).


{{kernelop
{{kernelop|title=Power management and ACPI options|desc=
|'''Power management and ACPI options ---> '''
[*] ACPI (Advanced Configuration and Power Interface) Support
|'''[*] ACPI (Advanced Configuration and Power Interface) Support'''
}}
}}


==== Explanations of different ACPI options in the kernel ====
==== Optional: Other ACPI features ====
Below are the locations and short descriptions of the function of different ACPI options in the kernel. In the majority of cases, you do not have to alter any of these to have a functional ACPI system.  
Below are the locations and short descriptions of the function of different ACPI options in the kernel. In the majority of cases, you do not have to alter any of these to have a functional ACPI system.  


* '''AC Adapter'''
* '''AC Adapter'''
{{kernelop
{{kernelop|title=Power management and ACPI options --->|desc=
|'''Power management and ACPI options ---><br>  ACPI (Advanced Configuration and Power Interface) Support --->'''
ACPI (Advanced Configuration and Power Interface) Support --->
|'''< > AC Adapter'''
      < > AC Adapter
}}
}}
{{Note}} If you have a system that can switch between being plugged into AC and using a battery (i.e. a laptop), you should compile this option into your kernel.
 
{{note|If you have a system that can switch between being plugged into AC and using a battery (i.e. a laptop), you should compile this option into your kernel.}}


*  '''Battery'''
*  '''Battery'''
{{kernelop
{{kernelop
|'''Power management and ACPI options ---><br>  ACPI (Advanced Configuration and Power Interface) Support --->'''
|Power management and ACPI options --->|desc=
|'''< > Battery'''
ACPI (Advanced Configuration and Power Interface) Support --->
      < > Battery
}}
}}
{{Note}} As its name would suggest, this option adds or removes support for the battery. More specifically, through /proc/acpi/battery. If you have a laptop or other mobile system, you should probably compile this into your kernel.
{{note|As its name would suggest, this option adds or removes support for the battery. More specifically, through /proc/acpi/battery. If you have a laptop or other mobile system, you should probably compile this into your kernel.}}


* '''Button'''
* '''Button'''
{{kernelop
{{kernelop|title=Power management and ACPI options|desc=
|'''Power management and ACPI options ---><br>  ACPI (Advanced Configuration and Power Interface) Support --->'''
ACPI (Advanced Configuration and Power Interface) Support --->
|'''< > Button'''
      < > Button
}}
}}
{{Note}} This driver handles power, sleep, and other buttons. This driver is recommended because it is necessary for software controlled power-off.
{{note|This driver handles power, sleep, and other buttons. This driver is recommended because it is necessary for software controlled power-off.}}


* '''Video'''
* '''Video'''
{{kernelop
{{kernelop|title=Power management and ACPI options|desc=
|'''Power management and ACPI options ---><br>  ACPI (Advanced Configuration and Power Interface) Support --->'''
ACPI (Advanced Configuration and Power Interface) Support --->
|'''< > Video'''
      < > Video
}}  
}}  
{{Note}} Implements ACPI extensions for integrated graphics devices. Also adds support for setting up a video output.  
{{note|Implements ACPI extensions for integrated graphics devices. Also adds support for setting up a video output. }}


* '''Fan'''
* '''Fan'''
{{kernelop
{{kernelop|title=Power management and ACPI options|desc=
|'''Power management and ACPI options ---><br>  ACPI (Advanced Configuration and Power Interface) Support --->'''
ACPI (Advanced Configuration and Power Interface) Support --->
|'''< > Fan'''
      < > Fan
}}
}}
{{Note}} Allows user-controlled applications to control fan speeds and access status of fans.  
 
{{note|Allows user-controlled applications to control fan speeds and access status of fans. }}


* '''Dock'''
* '''Dock'''
{{kernelop
{{kernelop|title=Power management and ACPI options|desc=
|'''Power management and ACPI options ---><br>  ACPI (Advanced Configuration and Power Interface) Support --->'''
ACPI (Advanced Configuration and Power Interface) Support --->
|'''[ ] Dock'''
      [ ] Dock
}}
}}
{{Note}} Builds support in the kernel for docking stations like the Dell Module Bay and the IBM Ultrabay.  
{{note|Builds support in the kernel for docking stations like the Dell Module Bay and the IBM Ultrabay. }}


* '''Processor'''
* '''Processor'''
{{Note}}
{{kernelop|title=Power management and ACPI options|desc=
ACPI (Advanced Configuration and Power Interface) Support --->
      < > Processor
}}
{{note|Helps save power while processor is idling and is required by several cpufreq drivers.}}


* '''Processor Aggregator'''
* '''Processor Aggregator'''
{{Note}}
{{kernelop|title=Power management and ACPI options|desc=
ACPI (Advanced Configuration and Power Interface) Support --->
      < > Processor Aggregator
}}
 
{{note|Allows the host system to practice logical processor idling (a way to reduce power consumption)}}


* '''Thermal Zone'''
* '''Thermal Zone'''
{{kernelop|title=Power management and ACPI options|desc=
ACPI (Advanced Configuration and Power Interface) Support --->
      < > Thermal Zone
}}
{{note|Enables support for ACPI thermal zones. It is encouraged to enable this option, as your system may be damaged without it. }}
== USE Flags ==
{| class="wikitable" style="margin: 1em auto;" width=80%
! width="20%" | Use flag
! width="10%" | Default
! width="10%" | Recommended
! width="60%" | Description
|-
| style="text-align:center;" | selinux
| style="text-align:center;" | No
| style="text-align:center; background-color: red;" | No, unless enabled by profile changes
| style="text-align:center;" | !!Internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur.
|}


== Installing acpid ==
== Installing acpid ==
==== Emerging ====
=== Emerging ===
After configuring the kernel power management options, we are ready to install acpid.To emerge acpid, do the following:
After configuring the kernel power management options, we are ready to install {{Package|sys-power/acpid}}. To install acpid, run the following command:
<console>
<console>
##r### ##b##emerge -av acpid
###i## emerge acpid
</console>
</console>


==== Adding to rc ====
=== Adding to rc ===
After you have finished emerging acpid, you may want to add it to the list of rc services to be started with your system at boot.
After you have finished emerging acpid, you may want to add it to the list of rc services to be started with your system at boot.
<console>
<console>
##r### ##b##rc-update add acpid default
###i## rc-update add acpid default
* service acpid added to runlevel default
</console>
</console>
Then, run the following to start acpid:
Then, run the following to start acpid:
<console>
<console>
##r### ##b##rc
###i## rc
* starting acpid ...
</console>
</console>
[[Category:System]]
[[Category:System]]
[[Category:First Steps]]
{{EbuildFooter}}

Latest revision as of 00:34, October 15, 2014

ACPI Daemon

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

What is ACPI?

"In computing, the Advanced Configuration and Power Interface (ACPI) specification provides an open standard for device configuration and power management by the operating system." (Wikipedia)

What is acpid?

"ACPID is a completely flexible, totally extensible daemon for delivering ACPI events. It listens on a file (/proc/acpi/event) and when an event occurs, executes programs to handle the event. The programs it executes are configured through a set of configuration files, which can be dropped into place by packages or by the admin." (acpid Sourceforge)

Preparing to install

Kernel configuration

Before we are ready to emerge acpid, it is a good idea to modify a few things in the kernel. If you have not modified your kernel before, you may want to check out the following page on configuring a kernel manually (page to be added..).

Under Power management and ACPI options:

[*] ACPI (Advanced Configuration and Power Interface) Support

Optional: Other ACPI features

Below are the locations and short descriptions of the function of different ACPI options in the kernel. In the majority of cases, you do not have to alter any of these to have a functional ACPI system.

  • AC Adapter

Under Power management and ACPI options --->:

ACPI (Advanced Configuration and Power Interface) Support --->
      < > AC Adapter
   Note

If you have a system that can switch between being plugged into AC and using a battery (i.e. a laptop), you should compile this option into your kernel.

  • Battery
ACPI (Advanced Configuration and Power Interface) Support --->
      < > Battery
   Note

As its name would suggest, this option adds or removes support for the battery. More specifically, through /proc/acpi/battery. If you have a laptop or other mobile system, you should probably compile this into your kernel.

  • Button

Under Power management and ACPI options:

ACPI (Advanced Configuration and Power Interface) Support --->
      < > Button
   Note

This driver handles power, sleep, and other buttons. This driver is recommended because it is necessary for software controlled power-off.

  • Video

Under Power management and ACPI options:

ACPI (Advanced Configuration and Power Interface) Support --->
      < > Video
   Note

Implements ACPI extensions for integrated graphics devices. Also adds support for setting up a video output.

  • Fan

Under Power management and ACPI options:

ACPI (Advanced Configuration and Power Interface) Support --->
      < > Fan
   Note

Allows user-controlled applications to control fan speeds and access status of fans.

  • Dock

Under Power management and ACPI options:

ACPI (Advanced Configuration and Power Interface) Support --->
      [ ] Dock
   Note

Builds support in the kernel for docking stations like the Dell Module Bay and the IBM Ultrabay.

  • Processor

Under Power management and ACPI options:

ACPI (Advanced Configuration and Power Interface) Support --->
      < > Processor
   Note

Helps save power while processor is idling and is required by several cpufreq drivers.

  • Processor Aggregator

Under Power management and ACPI options:

ACPI (Advanced Configuration and Power Interface) Support --->
      < > Processor Aggregator
   Note

Allows the host system to practice logical processor idling (a way to reduce power consumption)

  • Thermal Zone

Under Power management and ACPI options:

ACPI (Advanced Configuration and Power Interface) Support --->
      < > Thermal Zone
   Note

Enables support for ACPI thermal zones. It is encouraged to enable this option, as your system may be damaged without it.

USE Flags

Use flag Default Recommended Description
selinux No No, unless enabled by profile changes !!Internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur.

Installing acpid

Emerging

After configuring the kernel power management options, we are ready to install sys-power/acpid. To install acpid, run the following command:

root # emerge acpid

Adding to rc

After you have finished emerging acpid, you may want to add it to the list of rc services to be started with your system at boot.

root # rc-update add acpid default
 * service acpid added to runlevel default

Then, run the following to start acpid:

root # rc
 * starting acpid ...