CLI Machines Thermal

`ed machines thermal`

ed machines thermal inspects and controls the Linux kernel platform profile exposed by a machine. The Machines overview separately shows every readable hwmon fan in RPM alongside the active profile and the choices the kernel reports. There is no fan-speed write command and the CLI does not print fan RPM.

Profile changes can stay active until changed again, or revert after a chosen number of minutes. Timed changes run through a transient systemd timer on the machine, so the reversion still happens if Edith closes or the SSH connection drops. Starting another timed change keeps the original profile as the eventual destination. Applying a permanent profile cancels any pending reversion.

The machine needs /sys/firmware/acpi/platform_profile and platform_profile_choices for profile controls. Fan readings come from /sys/class/hwmon/hwmon*/fan*_input. Machines without either interface simply omit the matching part of the Cooling card.

status is the default subcommand, so ed machines thermal tuf and ed machines thermal status tuf are equivalent. The machine-first form also works: ed machines tuf thermal status.

Commands

Privilege and safety

Reading profile state needs no privilege on a normal Linux installation. The Machines overview's separate hardware fan readings are unprivileged too. Writing the profile usually needs root. ed uses the sudo password stored by ed machines edit <machine> --sudo-password-stdin, or passwordless sudo when no password is stored. The password goes on standard input and is never placed in the command line.

Profile names are accepted only when the machine reports them as a choice. The command also restricts names to letters, digits, hyphens and underscores before building any shell command.

Timed changes require systemd-run. Scheduling is checked before the profile is changed. If timer creation fails after the write, the command restores the original profile immediately and reports failure.

Both commands reuse Edith's shared SSH connection and the normal machine resolver. Names are matched case-insensitively as an exact name, SSH alias or UUID first, then as an unambiguous name or alias prefix. An unknown or ambiguous machine exits 3, and an unreachable machine exits 4.