sigildocs

(sigil sigil process)

(sigil process) - Process Management Library

Process management operations including spawning subprocesses, environment variable access, and command execution. Native functions are implemented in C with higher-level utilities defined here.

Running Commands

(import (sigil process))

;; Run and wait for completion
(process-run "ls" "-l")

;; Capture output as string
(process-output->string "date")  ; => "Thu Jan 15 14:30:00 2025"

;; Capture output as lines
(process-lines "ls")  ; => ("file1" "file2" ...)

Spawning Processes

(let ((p (process-spawn "cat")))
  (display "Hello\n" (process-stdin p))
  (close-output-port (process-stdin p))
  (display (read-line (process-stdout p)))
  (process-wait p))

Environment

(getenv "HOME")      ; => "/home/user"
(setenv! "MY_VAR" "value")

Exports

process-runprocedure

Run a command and wait for it to complete.

Returns the exit status (0 for success).

(process-run "ls" "-l")  ; => 0
process-spawnprocedure

Spawn a subprocess without waiting.

Returns a process object. Use process-wait to wait for completion and retrieve the exit status.

(let ((p (process-spawn "sleep" "10")))
  (process-kill! p))
process-waitprocedure

Wait for a process to complete.

Returns the exit status.

(process-wait p)  ; => 0
process-kill!procedure

Kill a running process.

(process-kill! p)
process?procedure

Check if a value is a process object.

process-alive?procedure

Check if a process is still running.

(process-alive? p)  ; => #t or #f
process-stdinprocedure

Get the stdin port of a spawned process.

Returns an output port for writing to the process.

process-stdoutprocedure

Get the stdout port of a spawned process.

Returns an input port for reading the process output.

process-stderrprocedure

Get the stderr port of a spawned process.

Returns an input port for reading error output.

getenvprocedure

Get an environment variable.

Returns the value as a string, or #f if not set.

(getenv "HOME")    ; => "/home/user"
(getenv "MISSING") ; => #f
setenv!procedure

Set an environment variable.

(setenv! "MY_VAR" "my-value")
command-lineprocedure

Get the command-line arguments.

Returns a list where the first element is the program name.

(command-line)  ; => ("./my-program" "arg1" "arg2")
exitprocedure

Exit the process with a status code.

(exit 0)  ; success
(exit 1)  ; failure
process-idprocedure

Get the current process ID.

(process-id)  ; => 12345
command-exists?procedure

Check if a command exists in PATH.

(command-exists? "ls")   ; => #t
(command-exists? "foo")  ; => #f
call-with-processprocedure

Call a procedure with a spawned process.

The process is automatically waited for when proc returns.

(call-with-process "ls" '("-l")
  (lambda (p)
    (read-line (process-stdout p))))
process-output->stringprocedure

Run a command and capture its stdout as a string.

Returns #f if the process cannot be started.

(process-output->string "echo" "hello")  ; => "hello"
(process-output->string "date")          ; => "Thu Jan 15..."
read-all-stringprocedure

Read all content from a port as a string. Helper for process-output->string.

process-linesprocedure

Run a command and return its stdout as a list of lines.

Returns #f if the process cannot be started.

(process-lines "ls")           ; => ("file1" "file2" ...)
(process-lines "ls" "-la")     ; => ("total 42" "drwxr-x..." ...)
read-all-linesprocedure

Read all lines from a port. Helper for process-lines.

%process-spawn-optsvariable

(No description)

%process-spawn-errorvariable

(No description)

%process-wait-resultvariable

(No description)

%process-signalvariable

(No description)

process-pidvariable

(No description)

process-pgidvariable

(No description)

%process-spawn-ptyvariable

(No description)

process-pty?variable

(No description)

process-pty-fdvariable

(No description)

process-pty-readvariable

(No description)

process-pty-writevariable

(No description)

process-pty-resize!variable

(No description)

process-pty-close!variable

(No description)

%process-spawn-pipevariable

(No description)

process-stdout-fdvariable

(No description)

process-stdin-fdvariable

(No description)

process-pipe-readvariable

(No description)

process-pipe-writevariable

(No description)

%process-pipe-write-or-closedvariable

(No description)

process-pipe-close-stdin!variable

(No description)

%set-exit-hook!variable

(No description)

%set-exit-trap!variable

(No description)

%last-trapped-exit-statusvariable

(No description)

emergency-exitvariable

(No description)

get-environment-variablesvariable

(No description)

executable-pathvariable

(No description)

process-signal!variable

(No description)

process-spawn-ptyvariable

(No description)

process-spawn-pipevariable

(No description)