{"id":13441269,"url":"https://github.com/fenrus75/powertop","last_synced_at":"2025-05-14T15:00:26.960Z","repository":{"id":45206452,"uuid":"3096701","full_name":"fenrus75/powertop","owner":"fenrus75","description":"The Linux PowerTOP tool  -- please post patches to the mailing list instead of using github pull requests","archived":false,"fork":false,"pushed_at":"2025-02-28T15:16:01.000Z","size":3177,"stargazers_count":1125,"open_issues_count":90,"forks_count":132,"subscribers_count":45,"default_branch":"master","last_synced_at":"2025-04-08T04:09:02.493Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.01.org/powertop","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fenrus75.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-01-03T19:39:38.000Z","updated_at":"2025-04-07T17:45:13.000Z","dependencies_parsed_at":"2023-02-11T13:30:31.861Z","dependency_job_id":"797db177-e10b-4a96-9538-3df01956c1da","html_url":"https://github.com/fenrus75/powertop","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fenrus75%2Fpowertop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fenrus75%2Fpowertop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fenrus75%2Fpowertop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fenrus75%2Fpowertop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fenrus75","download_url":"https://codeload.github.com/fenrus75/powertop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254168084,"owners_count":22026080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T03:01:31.813Z","updated_at":"2025-05-14T15:00:26.915Z","avatar_url":"https://github.com/fenrus75.png","language":"C++","funding_links":[],"categories":["C++","Applications","System Utilities"],"sub_categories":["Utilities","Directory Navigation"],"readme":"# PowerTOP\n\nPowerTOP is a Linux* tool used to diagnose issues with power consumption and\npower management. In addition to being a diagnostic tool, PowerTOP also has an\ninteractive mode you can use to experiment with various power management\nsettings, for cases where the Linux distribution has not enabled those\nsettings.\n\n\n# Build dependencies\n\nPowerTOP is coded in C++. It was written for Linux-based operating systems.\nGNU* libc (`glibc`) and Linux `pthreads` are needed for PowerTOP to function\nproperly. The GNU build system (`autoconf`, `automake`, `make`, `libtool`), as\nwell as `gettext`, are required to build PowerTOP.\n\nIn addition, PowerTOP requires the following:\n\n* kernel version =\u003e 2.6.38\n* `ncurses-devel` (required)\n* `libnl-devel` (required)\n* `pciutils-devel` (is only required if you have PCI)\n* `autoconf-archive` (for building)\n\nExample packages to install in Ubuntu*:\n\n    sudo apt install libpci-dev libnl-3-dev libnl-genl-3-dev gettext \\\n    libgettextpo-dev autopoint gettext libncurses5-dev libncursesw5-dev libtool-bin \\\n    dh-autoreconf autoconf-archive pkg-config\n\n\n## Building PowerTOP\n\nThe `autogen.sh` script needs to be run only once to generate `configure`.\nYou need to re-run it only if the build system configuration files\n(e.g. `configure.ac`) are modified. The remaining steps are required whenever\nsource files are modified.\n\nTo build PowerTOP from the cloned source, use the following commands:\n\n    ./autogen.sh\n    ./configure\n    make\n\n\n# Running PowerTOP\n\nThe following sections go over basic operation of PowerTOP. This includes\nkernel configuration options (or kernel patches) needed for full functionality.\nRun `powertop --help` to see all options.\n\n\n## Kernel parameters and (optional) patches\n\nPowerTOP needs some kernel config options enabled to function\nproperly. As of linux-3.3.0, these are (the list probably is incomplete):\n\n    CONFIG_NO_HZ\n    CONFIG_HIGH_RES_TIMERS\n    CONFIG_HPET_TIMER\n    CONFIG_CPU_FREQ_GOV_ONDEMAND\n    CONFIG_USB_SUSPEND\n    CONFIG_SND_AC97_POWER_SAVE\n    CONFIG_TIMER_STATS\n    CONFIG_PERF_EVENTS\n    CONFIG_PERF_COUNTERS\n    CONFIG_TRACEPOINTS\n    CONFIG_TRACING\n    CONFIG_EVENT_POWER_TRACING_DEPRECATED\n    CONFIG_X86_MSR\n    ACPI_PROCFS_POWER\n    CONFIG_DEBUG_FS\n\nUse these configs from linux-3.13.rc1:\n\n    CONFIG_POWERCAP\n    CONFIG_INTEL_RAPL\n\nThe patches in the `patches/` sub-directory are optional but enable *full*\nPowerTOP functionality.\n\n\n## Outputting a report\n\nWhen PowerTOP is executed as root and without arguments, it runs in\ninteractive mode. In this mode, PowerTOP most resembles `top`.\n\nFor generating reports, or for filing functional bug reports, there are two\noutput modes: CSV and HTML. You can set sample times, the number of iterations,\na workload over which to run PowerTOP, and whether to include\n`debug`-level output.\n\nFor an HTML report, execute PowerTOP with this option:\n\n    powertop --html=report.html\n\nThis creates a static `report.html` file, suitable for sharing.\n\nFor a CSV report, execute PowerTOP with this option:\n\n    powertop --csv=report.csv\n\nThis creates a static `powertop.csv` file, also suitable for sharing.\n\nIf you wish to file a functional bug report, generate and share a\n`debug`-mode HTML report and share it, using the following command:\n\n    powertop --debug --html=report.html\n\n**Important Note:** As PowerTOP is intended for privileged (`root`) use, your\nreports-- especially when run with `--debug`-- will contain verbose system\ninformation. PowerTOP **does not** sanitize, scrub, or otherwise anonymize its\nreports. Be mindful of this when sharing reports.\n\n**Developers:** If you make changes to the HTML reporting code, validate HTML\noutput by using the W3C* Markup Validation Service and the W3C CSS Validation\nService:\n* http://validator.w3.org/#validate_by_upload\n* http://jigsaw.w3.org/css-validator/#validate_by_upload\n\n\n## Calibrating and power numbers\n\nPowerTOP, when running on battery, tracks power consumption and activity on\nthe system. Once there are sufficient measurements, PowerTOP can start to\nreport power estimates for various activities. You can help increase the\naccuracy of the estimation by running a calibration cycle at least once:\n\n    powertop --calibrate\n\n*Calibration* entails cycling through various display brightness levels\n(including \"off\"), USB device activities, and other workloads.\n\n\n## Extech Power Analyzer / Datalogger support\n\nOur analysis teams use the Extech* Power Analyzer/Datalogger (model\nnumber 380803). PowerTOP supports this device over the serial cable by passing\nthe device node on the command line using this command:\n\n    powertop --extech=/dev/ttyUSB0\n\n(where ttyUSB0 is the devicenode of the serial-to-usb adapter on our system)\n\n\n# Contributing to PowerTOP and getting support\n\nThere are numerous ways you and your friends can contribute to PowerTOP. See\nthe `CONTRIBUTE.md` document for more details. Elevator summary: \"fork, and\nsend PRs!\".\n\nWe have a mailing list: `powertop@lists.01.org`:\n* Subscribe at:\n  * https://lists.01.org/postorius/lists/powertop.lists.01.org/\n* Browse archives at:\n  * https://lists.01.org/hyperkitty/list/powertop@lists.01.org/\n\nIf you find bugs, you can file an issue-- see `CONTRIBUTE.md` for further\ndetails:\n* File bugs/wishes at:\n  * https://github.com/fenrus75/powertop/issues\n\n\n# Code from other open source projects\n\nPowerTOP contains some code from other open source projects; we'd like to thank\nthe authors of those projects for their work. Specifically, PowerTOP contains\ncode from\n\n```\nParse Event Library - Copyright 2009, 2010 Red Hat Inc  Steven Rostedt \u003csrostedt@redhat.com\u003e\nnl80211 userspace tool - Copyright 2007, 2008\tJohannes Berg \u003cjohannes@sipsolutions.net\u003e\n```\n\n\n# Copyright and License\n\n    PowerTOP\n    Copyright (C) 2020  Intel Corporation\n\n    This program is free software; you can redistribute it and/or modify\n    it under the terms of the GNU General Public License as published by\n    the Free Software Foundation; version 2.\n\n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n\n    You should have received a copy of the GNU General Public License\n    along with this program; if not, write to the Free Software\n    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA\n\nSee `COPYING` file for a copy of the aforementioned (GPLv2) license.\n\n\n## SPDX Tag\n\n    /* SPDX-License-Identifier: GPL-2.0-only */\n\nFrom: https://spdx.org/licenses/GPL-2.0-only.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffenrus75%2Fpowertop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffenrus75%2Fpowertop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffenrus75%2Fpowertop/lists"}