SHTK_PROCESS_RUN(3)

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.

SEE ALSO
shtk(3), shtk_process(3)

HISTORY
shtk_process_run first appeared in shtk 1.0.

The -t flag appeared in shtk 1.5.