NAME

shtk_process_run —

Executes a command in a controlled environment

LIBRARY

shtk_import run

SYNOPSIS

shtk_process_run [-t seconds] command [arg1 .. argN]

DESCRIPTION

The shtk_process_run function executes the command provided in the list of arguments starting at command and logs, using the logging functions offered by shtk_cli(3), the invocation of the command and its termination status.

Optionally, shtk_process_run can enforce a maximum run time for the executed command. If the -t is provided, then the executed command will be forcibly terminated with a ‘KILL’ signal if its run time exceeds the given seconds.

RETURN VALUES

shtk_process_run returns the exit code of the executed command, or 127 if a timeout was provided and the command timed out.

HISTORY

shtk_process_run first appeared in shtk 1.0.

The -t flag appeared in shtk 1.5.