CLI Machines Power Power Wake

`ed machines power wake`

Sends a wake-on-LAN magic packet to the machine's stored MAC address.

ed machines power wake <machine> [--json]

Arguments

Name	Type / values	Default	What it does
`<machine>`	machine name, ssh alias or id	required	Which machine to wake. Resolved from the machine file, so it works while the machine is off.

Options

Name	Type / values	Default	What it does
`--json`	flag	off	Emit JSON on stdout instead of the human line.
`--help`, `-h`	flag	off	Print the help for this command on stdout and exit 0.

$ ed machines power wake tuf
sent a wake packet to 04:42:1a:8d:2f:6c

`--json` shape

{
  "action": "wake",
  "applied": true,
  "macAddress": "04:42:1a:8d:2f:6c",
  "machine": "Asus TUF 7"
}

applied: true means the packet left this Mac. It is not a claim that the machine woke.

Examples

ed machines power wake tuf
ed machines tuf power wake
ed machines power wake tuf --json
ed machines edit tuf --mac 04:42:1a:8d:2f:6c

Behaviour notes

There is no SSH here at all. ed builds the magic packet by hand, six 0xFF bytes followed by the six address bytes repeated sixteen times, opens a UDP socket with SO_BROADCAST, and sends it to 255.255.255.255 on port 9. That is a limited broadcast, so it reaches the local link and no further: waking a machine on another subnet needs a router that forwards directed broadcasts, and this command cannot arrange that for you.

Edith learns the address the first time it sees the machine up, by walking /sys/class/net/* and picking a real network card. An interface only counts when it has a device symlink, which is what separates a card from a bridge, a veth or a loopback, and an address that is empty or all zeroes is skipped. Wired wins: the first non-wireless card ends the search immediately, while a wireless one is only remembered as a fallback and used when nothing wired turned up. Waking over Wi-Fi needs the card to support it, so a machine that only reports a wireless address may store one and still not wake.

Until that has happened there is nothing to send to, and the command exits 4:

$ ed machines power wake box
error: no MAC address is stored for Home Box
hint: open the machine in Edith while it is up so it can learn one, or set it with `ed machines edit Home Box --mac <address>`

The hint quotes the display name verbatim, so a name with spaces needs quoting when you retype the suggestion.

A stored value that is not six colon-separated hex pairs exits 1 with <value> is not a MAC address, and a socket that cannot be opened or written exits 1 with Could not open a socket. or The wake packet could not be sent.. Nothing here depends on the machine being reachable, which is the whole point of the verb.