LinuxCommandLibrary

upowerd

Manage power and battery information

SYNOPSIS

upowerd [OPTIONS]

Note: upowerd is typically run as a system daemon, managed by an init system like systemd, and is not usually invoked directly by users from the command line.

PARAMETERS

--verbose
    Enables verbose debugging output. This directs additional diagnostic information to syslog or standard error, useful for troubleshooting issues with the daemon.

--replace
    Replaces any existing upowerd instance. This option is primarily used during development or debugging to run a new instance of the daemon without manually stopping the old one.

--help
    Displays a brief help message detailing available command-line options and exits.

--version
    Shows the version information of the upowerd daemon and exits.

DESCRIPTION

upowerd is the daemon for the UPower system service, providing a comprehensive, high-level abstraction for power management on Linux systems. It acts as a central authority for power-related information, enumerating power devices (like batteries, AC adapters, UPS units), tracking their state (e.g., charge level, power source), and providing notifications when their status changes. Applications, including desktop environments and power management utilities, communicate with upowerd via its D-Bus API to retrieve power information, manage power profiles, and handle events such as low battery warnings or suspend/hibernate requests. It unifies power management across various hardware and software configurations, offering a standardized interface for power-aware applications. Its primary role is to abstract away the complexities of interacting directly with hardware and various kernel interfaces for power management.

CAVEATS

Users should generally not attempt to run or manage upowerd directly from the command line. It is a fundamental system service that should be managed by the distribution's init system (e.g., systemd). Direct manipulation can lead to system instability or incorrect power management behavior. Interaction with upowerd's functionality is intended to be done programmatically via its D-Bus interface or through user-facing client utilities like upower(1) or desktop environment power managers.

D-BUS INTERFACE

upowerd exposes its functionality through a well-defined D-Bus interface. Applications and desktop components do not directly execute upowerd commands but instead communicate with the running daemon over D-Bus to query power device status, subscribe to power-related events (like battery level changes), and request power actions (such as suspend or hibernate). This service-oriented architecture ensures robust and secure interaction with power management capabilities, abstracting away the underlying hardware details.

CONFIGURATION

upowerd's behavior can be configured through a configuration file, typically located at /etc/UPower/UPower.conf. This file allows administrators to customize various aspects of power management, such as thresholds for low battery warnings, polling intervals for power devices, and other daemon-specific settings. Changes to this file usually require restarting the upowerd service to take effect for the new configurations to be applied.

HISTORY

upowerd, as part of the UPower project, emerged as a modern, standardized solution for power management on Linux, particularly for desktop environments adhering to the freedesktop.org specifications. It aimed to provide a unified D-Bus API for power information, centralizing power management functionality that was previously handled by more disparate and less integrated mechanisms like acpid for ACPI events and pm-utils for power state transitions. Its development reflects the broader trend in Linux desktop environments towards D-Bus-centric services for system-wide functionalities, ensuring consistent and robust power management across different distributions and desktop environments.

SEE ALSO

upower(1), systemd(1), dbus-daemon(1), acpid(8), pm-utils(8)

Copied to clipboard