# unix_g

shell (sh) command execution, output redirected to a variable

## Calling Sequence

    rep=unix_g(cmd)
                [rep,stat]=unix_g(cmd)
                [rep,stat,stderr]=unix_g(cmd)

## Arguments

cmd

  a character string

rep

  a column vector of character strings (standard output)

stat

  an integer, the error status. stat=0 if no error occurred

err

  a column vector of character strings (standard error)

## Description

Sends a string `cmd` to Unix for execution by the sh shell. The standard output is redirected to scilab variable `rep`. The standard error is redirected to scilab variable err or displays if you had only 2 output arguments. Unix execution errors are trapped; *NOTE* that only the last shell command error is reported when a list of command separated by ";" is sent: this is not recommended.

## Examples

    function d=DIR(path)
      path=pathconvert(path,%t,%t)
      if getos() == 'Windows' then
        d=unix_g('dir '+path)
      else
        d=unix_g('ls '+path)
      end
    endfunction

    DIR('SCI/etc')

## See Also

- unix_s
- unix_w
- unix_x
- unix