High-risk tools in 3do Dev
28 of the 48 tools in 3do Dev are classified as high risk. This page profiles those tools specifically, with recommended policy actions and the attack patterns that target them.
Every operation listed below is an action PolicyLayer recommends controlling at the transport layer. Open any tool to see the full profile, risk score, and YAML policy snippet.
Tools at high risk
-
buildExecuteCompile projects/<project> (Norcroft ARM C) and pack a signed ISO + ELF/symbols.
-
emu_attachExecuteAttach to a running session (e.g. a window started with `./3do run demo`, control
-
emu_bootExecuteemu_boot
-
emu_breakExecuteSet (or remove) a halting breakpoint at a function/symbol ("update_plasma", "main+0x20")
-
emu_cmdExecuteAny session control command, e.g. emu_cmd("help"), emu_cmd("find_mem", {"text": "DEMO"}),
-
emu_continueExecuteResume a halted CPU and run until the next breakpoint/watchpoint or max_frames
-
emu_haltExecuteStop the CPU now (before its next instruction); shows where.
-
emu_holdExecuteHold buttons across steps/free-run until changed; "" releases.
-
emu_inputExecuteNon-pad input. device: joypad|flightstick|mouse|lightgun|arcade_lightgun|orbatak_trackball|none
-
emu_lookExecuteOptionally press BUTTONS, run FRAMES, then return new debug output + a screenshot.
-
emu_pauseExecuteStop free-running (frames then only advance on step/press).
-
emu_pressExecutePress+release pad buttons: "A", "UP+B", "P". Buttons: A B C P(play) X(stop) L R UP DOWN LEFT RIGHT
-
emu_rebootExecutePower-cycle the console, optionally inserting another disc (project name or ISO).
-
emu_record_gifExecuteRun FRAMES frames capturing every Nth into an animated GIF (path relative to repo root).
-
emu_regsExecuteCPU registers with symbolized pc/lr and mode. set_name/set_value change one (e.g. r0, 0x10).
-
emu_resetExecuteSoft reset (console reset button).
-
emu_restartExecuteKill and respawn the session process (same disc, same window setting). Use if it hangs.
-
emu_runExecuteFree-run continuously (speed 1.0 = real time, 0 = max). Also resumes a halted CPU.
-
emu_run_untilExecuteStep until TEXT appears in debug output emitted after the last emu_log call.
-
emu_sequenceExecuteemu_sequence
-
emu_stepExecuteAdvance N frames (60 = 1 s of 3DO time). Stops early on a breakpoint/watchpoint.
-
emu_stepiExecuteExecute COUNT machine instructions then halt; returns the new pc and symbol.
-
emu_stopExecuteEnd the current session (stops it if this server started it; detaches otherwise).
-
emu_traceExecuteTracepoints (log args without stopping): action add|remove|clear|hits; plus action
-
emu_watchExecuteData watchpoint on a global/symbol or address (kind: write|read|access); halts after
-
emu_write_memExecuteWrite bytes (hex) or one 32-bit value (u32="0x1234") at an address or symbol.
-
gdb_runExecuteRun gdb commands against the current session with full source-level symbols
-
run_testsExecuteRun a project's tests headless (`./3do test <project>`), or every project (`./3do selftest`).
Attacks that target this class
High-risk tools in any server share these documented attack patterns. Each links to the full case and the defensive policy.