Documentation
¶
Overview ¶
Package process provides subprocess execution primitives.
This extension is NOT included in the Console profile. Embedders must opt in explicitly with WithExtension(process.Extension) or use WithProfile(KitchenSink).
Two security actions gate process creation:
- security.ActionExec gates process-spawn (structured, no shell)
- security.ActionExecShell gates system (shell command string)
Both use security.ResourceProcess with the command as target.
Shell Execution ¶
- system
Structured Process Control ¶
- process-spawn, process-wait, process-kill
- process-stdout, process-stderr, process-stdin
Process Predicates ¶
- process?
Use Extension or AddToRegistry to register all primitives.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var AddToRegistry = Builder.AddToRegistry
AddToRegistry registers all process primitives.
var Builder = registry.NewRegistryBuilder(addPrimitives)
Builder aggregates all process registration functions.
var Extension = registry.NewDescribedExtension("process", "OS processes: command execution, exit, environment variables.", AddToRegistry)
Extension is the process execution extension.
var PrimProcessStderr = helpers.MakeUnaryAccessor(werr.ErrNotAProcess, "process-stderr", func(proc *values.Process) values.Value {
return proc.Stderr()
})
PrimProcessStderr implements the (process-stderr) primitive.
var PrimProcessStdin = helpers.MakeUnaryAccessor(werr.ErrNotAProcess, "process-stdin", func(proc *values.Process) values.Value {
return proc.Stdin()
})
PrimProcessStdin implements the (process-stdin) primitive.
var PrimProcessStdout = helpers.MakeUnaryAccessor(werr.ErrNotAProcess, "process-stdout", func(proc *values.Process) values.Value {
return proc.Stdout()
})
PrimProcessStdout implements the (process-stdout) primitive.
Functions ¶
func PrimProcessKill ¶
func PrimProcessKill(mc machine.CallContext) error
PrimProcessKill implements the (process-kill) primitive. Sends a signal to the process. Signal is a symbol: term, kill, int, hup.
func PrimProcessQ ¶
func PrimProcessQ(mc machine.CallContext) error
PrimProcessQ implements the (process?) predicate.
func PrimProcessSpawn ¶
func PrimProcessSpawn(mc machine.CallContext) error
PrimProcessSpawn implements the (process-spawn) primitive. Creates a subprocess with stdin/stdout/stderr pipes.
func PrimProcessWait ¶
func PrimProcessWait(mc machine.CallContext) error
PrimProcessWait implements the (process-wait) primitive. Blocks until the process exits and returns the exit code.
func PrimSystem ¶
func PrimSystem(mc machine.CallContext) error
PrimSystem implements the (system) primitive. Runs a shell command via /bin/sh -c and returns the exit code.
Types ¶
This section is empty.
Source Files