class Process

• Process
• Reference
• Object

Defined in:

Constant Summary

PATH_DELIMITER = {% if flag?(:windows) %} ';' {% else %} ':' {% end %}

Constructors

• .fork : self?

  Duplicates the current process.

• .new(command : String, args = nil, env : Env = nil, clear_env : Bool = false, shell : Bool = false, input : Stdio = false, output : Stdio = false, error : Stdio = false, chdir : String? = nil)

  Creates a process, executes it, but doesn't wait for it to complete.

Class Method Summary

• .after_fork_child_callbacks

  Hooks are defined here due to load order problems.

• .exec(command : String, args = nil, env : Env = nil, clear_env : Bool = false, shell : Bool = false, input : Bool | IO::FileDescriptor = true, output : Bool | IO::FileDescriptor = true, error : Bool | IO::FileDescriptor = true, chdir : String? = nil)

  Replaces the current process with a new one.

• .executable_path

  Returns an absolute path to the executable file of the currently running program.

• .exists?(pid : Int)

  Returns true if the process identified by pid is valid for a currently registered process, false otherwise.

• .exit(status = 0)

  Terminate the current process immediately.

• .find_executable(name, path = ENV["PATH"]?, pwd = Dir.current)

  Searches an executable, checking for an absolute path, a path relative to pwd or absolute path, then eventually searching in directories declared in path.

• .fork(&block)

  Runs the given block inside a new process and returns a Process representing the new child process.

• .kill(signal : Signal, *pids : Int)

  Sends a signal to the processes identified by the given pids.

• .pgid : LibC::PidT

  Returns the process group identifier of the current process.

• .pgid(pid : Int32) : LibC::PidT

  Returns the process group identifier of the process identified by pid.

• .pid : LibC::PidT

  Returns the process identifier of the current process.

• .ppid : LibC::PidT

  Returns the process identifier of the parent process of the current process.

• .run(command : String, args = nil, env : Env = nil, clear_env : Bool = false, shell : Bool = false, input : Stdio = false, output : Stdio = false, error : Stdio = false, chdir : String? = nil) : Process::Status

  Executes a process and waits for it to complete.

• .run(command : String, args = nil, env : Env = nil, clear_env : Bool = false, shell : Bool = false, input : Stdio = nil, output : Stdio = nil, error : Stdio = nil, chdir : String? = nil, &block)

  Executes a process, yields the block, and then waits for it to finish.

• .times : Tms

  Returns a Tms for the current process.

Instance Method Summary

• #close

  Closes any pipes to the child process.

• #error

  A pipe to this process's error.

• #error? : IO::FileDescriptor?

  A pipe to this process's error.

• #exists?

  Whether the process is still registered in the system.

• #input

  A pipe to this process's input.

• #input? : IO::FileDescriptor?

  A pipe to this process's input.

• #kill(sig = Signal::TERM)

  See also: Process.kill

• #output

  A pipe to this process's output.

• #output? : IO::FileDescriptor?

  A pipe to this process's output.

• #pid : Int32
• #terminated?

  Whether this process is already terminated.

• #wait : Process::Status

  Waits for this process to complete and closes any pipes.

Constructor Detail

Class Method Detail

Instance Method Detail