DragonFly On-Line Manual Pages

SHTK_PROCESS_RUN(3)   DragonFly Library Functions Manual   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.

DragonFly 6.5-DEVELOPMENT      November 7, 2014      DragonFly 6.5-DEVELOPMENT