Difference between revisions of "Package:ACPI Daemon"

From Funtoo
Jump to: navigation, search
 
(50 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Introduction ==
+
{{Ebuild
==== What is acpi? ====
+
|Summary=Daemon for Advanced Configuration and Power Interface
"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)]
+
|CatPkg=sys-power/acpid
 +
|Repository=Gentoo Portage Tree
 +
}}
 +
=== 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." ([http://en.wikipedia.org/wiki/Advanced_Configuration_and_Power_Interface Wikipedia])
  
==== 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)]
+
"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])
  
 
== 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|title=Power management and ACPI options|desc=
 +
[*] 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'''
 +
{{kernelop|title=Power management and ACPI options --->|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > AC Adapter
 +
}}
 +
 +
{{fancynote| 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'''
 
{{kernelop
 
{{kernelop
|Enabling acpid (if it is not already enabled)
+
|Power management and ACPI options --->|desc=
|Power management and ACPI options --->
+
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > Battery
 +
}}
 +
{{fancynote| 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'''
 +
{{kernelop|title=Power management and ACPI options|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > Button
 +
}}
 +
{{fancynote| This driver handles power, sleep, and other buttons. This driver is recommended because it is necessary for software controlled power-off.}}
 +
 
 +
* '''Video'''
 +
{{kernelop|title=Power management and ACPI options|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > Video
 +
}}
 +
{{fancynote| Implements ACPI extensions for integrated graphics devices. Also adds support for setting up a video output. }}
 +
 
 +
* '''Fan'''
 +
{{kernelop|title=Power management and ACPI options|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > Fan
 +
}}
 +
 
 +
{{fancynote| Allows user-controlled applications to control fan speeds and access status of fans. }}
 +
 
 +
* '''Dock'''
 +
{{kernelop|title=Power management and ACPI options|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      [ ] Dock
 +
}}
 +
{{fancynote| Builds support in the kernel for docking stations like the Dell Module Bay and the IBM Ultrabay. }}
 +
 
 +
* '''Processor'''
 +
{{kernelop|title=Power management and ACPI options|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > Processor
 +
}}
 +
{{fancynote| Helps save power while processor is idling and is required by several cpufreq drivers.}}
 +
 
 +
* '''Processor Aggregator'''
 +
{{kernelop|title=Power management and ACPI options|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > Processor Aggregator
 +
}}
 +
 
 +
{{fancynote| Allows the host system to practice logical processor idling (a way to reduce power consumption)}}
 +
 
 +
* '''Thermal Zone'''
 +
{{kernelop|title=Power management and ACPI options|desc=
 +
ACPI (Advanced Configuration and Power Interface) Support --->
 +
      < > Thermal Zone
 
}}
 
}}
 +
{{fancynote| Enables support for ACPI thermal zones. It is encouraged to enable this option, as your system may be damaged without it. }}
  
{{Note}} Kernel options after this are not necessary, but are helpful in certain situations.
 
 
== Installing acpid ==
 
== Installing acpid ==
==== Emerging ====
+
=== Emerging ===
To install acpid, run this command:
+
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 installing 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 rc:
+
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 01:00, 27 June 2014

sys-power/acpid


Source Repository:Funtoo Overlay

Summary: Daemon for Advanced Configuration and Power Interface

ACPI Daemon

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.

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:

# 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.

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

Then, run the following to start acpid:

# rc
 * starting acpid ...