GEOPM — GEOPM documentation (original) (raw)

Fine-grained low-latency batch access to power metrics and control knobs on Linux

The Global Extensible Open Power Manager (GEOPM) provides a framework to explore power and energy optimizations on platforms with heterogeneous mixes of computing hardware.

Users can monitor their system’s energy and power consumption, and safely optimize system hardware settings to achieve energy efficiency and/or performance objectives.

Source Code

To get the latest source code clone the git repository:

$ git clone https://github.com/geopm/geopm.git

With GEOPM, a system administrator can:

🔐 Utilize fine-grained access management

Grant per-user or per-group access to individual metrics and controls
Gain more granular management of features than the underlying OS access mechanisms provide

🦺 Provide safe access to hardware settings

Ensure that user-driven changes to hardware settings are reverted when the user’s process session terminates

🏗️ Extend the open-core framework

Develop your own platform-specific monitor and control interfaces through the extensible plugin architecture

With GEOPM, an end user can:

🔬 Interact with hardware settings and sensors

Platform-agnostic interface
Support for a wide range of Linux device drivers
Examples: set a CPU power limit, read a GPU’s current power consumption, limit the frequency range of system sub-components

⏱️ Measure application performance

Generate summarized reports of power and energy behavior during execution of an application
Automatically detect MPI and OpenMP phases in an application, generating per-phase summaries within application reports

🏁 Implement optimization objectives

Optimize applications to improve energy efficiency or reduce the effects of work imbalance, system jitter, and manufacturing variation through built-in control algorithms
Develop your own runtime control algorithms through the extensible plugin architecture

🏎️ Build fast efficient software

Gather large groups of signal-reads or control-writes into batch operations
Batch interface often reduces total latency to complete the operations

Documentation

License: BSD 3-Clause

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above
   copyright notice, this list of conditions and the following
   disclaimer in the documentation and/or other materials provided
   with the distribution.

3. Neither the name of the copyright holder nor the names of its
   contributors may be used to endorse or promote products derived
   from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

SPDX Details for BSD 3-Clause License