[Overview][Constants][Types][Procedures and functions][Variables][Index] | Reference for unit 'Unix' (#rtl)

# fpSystem

Execute and feed command to system shell

## Declaration

Source position: line 0

`function fpSystem(`
`const Command: string`
`):cint; function fpSystem(`
`const Command: AnsiString`
`):cint;`

## Description

Shell invokes the bash shell (/bin/sh), and feeds it the command Command (using the -c option). The function then waits for the command to complete, and then returns the exit status of the command in wait(3) format, or 127 if it could not complete the FpFork or FpExecve calls. To convert the return value of fpsystem to the real return value use WEXITSTATUS().

## Errors

Errors are reported in (fpget)ErrNo

## See also

POpen |  | Pipe file to standard input/output of program
Shell |  | Execute and feed command to system shell
FpFork |  | Create child process
FpExecve |  | Execute process using environment

## Example

    program example56;

    uses Unix;

    { Program to demonstrate the Shell function }

    Var S : Longint;

    begin
      Writeln ('Output of ls -l *.pp');
      S:=fpSystem('ls -l *.pp');
      Writeln ('Command exited wwith status : ',S);
    end.

Documentation generated on: Feb 26 2014