suspend_target(3)

💤 NAME 💤

okay so bestie, this is suspend_target(3) from the Arcan Lua API 🦋 — it's the call that requests the target suspend execution, awaiting a resume or terminate call. literally "hold please" main character energy, and yes it ate 💅.

✨ SYNOPSIS ✨

no cap, here is the exact synopsis, copied with love:

nil
suspend_target( vid:target )
suspend_target( .B )
suspend_target( vid:target, bool:noblock=false )

🌸 DESCRIPTION 🌸

So suspend_target tells the target frameserver to enter a low-power/passive mode until a resume_target command has been issued. it's giving "nap until further notice" 😴, and the frameserver is fully in on it. highkey iconic.

By default, this will block any attempt at transferring or resizing video buffers. that's the default, bestie — transferring and resizing video buffers are blocked, fr fr. it's a whole vibe check for video buffers 🎀.

This behaviour can be ignored by setting noblock=true — yes, that's the escape hatch, and ngl it's right there in the synopsis as bool:noblock=false by default 🫶.

If suspend_target is set during the preroll stage, the frameserver will not be activated until a corresponding resume_target call has been issued. so it's lowkey waiting at the door like "not yet, not yet" 🙈.

On the client side, this will look like the _open call is blocking/stalling. not me warning you that _open is gonna look stuck 😭 — that's literally the expected look here, iykyk.

💖 SEE ALSO: 💖

• resume_target(3) — the resume side of the equation, obviously 💜.

---

mwah 💋 sign-off time: this page's source/version is targetcontrol, dated October 2026. stay paused, stay iconic, periodt 👑.