kill-external-programOS Interfacesvn-versionrun-external-programGoTo Top

run-external-program   program args &key input output wait => bidirectional-stream, os-process[Function]

Run an external program.

Package   :gbbopen-tools

Module   :os-interface

Arguments and values

program     A string specifying the name of the program to be run
args     A list of strings passed to program as arguments
input     A stream specification (default is :stream, see below)
output     A stream specification (default is :stream, see below)
wait     A generalized boolean (default is nil)
bidirectional-stream     A stream or nil
os-process     An implementation-dependent process representation or nil

Two values:

Use of a true value for wait and a :stream value for input or output is problematic or an error in most Common Lisp implementations.

The values of input and output can be:

LispWorks (non-Windows platforms) and SBCL do not use a search path for locating program, the full path must be specified in the program string.

See also


  > (let ((stream (run-external-program "date" nil)))
       (print (read-line stream))
       (close-external-program-stream stream))
  "Mon Jul  4 14:06:04 EDT 2005" 

The GBBopen Project

kill-external-programOS Interfacesvn-versionrun-external-programGoTo Top