ATF-EXEC(1)             NetBSD General Commands Manual             ATF-EXEC(1)

NAME
     atf-exec -- executes a command in a controlled manner

SYNOPSIS
     atf-exec [-t secs:file] command
     atf-exec -h

DESCRIPTION
     atf-exec is a wrapper that executes a given command in a controlled man-
     ner.  At the moment, all it can do is set a timeout on the command and
     terminate it (and all of its children) if the timeout expires.

     In the first synopsis form, atf-exec will execute the provided command
     and, unless any options are specified, the command is executed as if
     atf-exec had not been used.  If the -t option is used, atf-exec will
     forcibly terminate the command if a specified amount of time passes.  The
     subprocesses are run on a different process group, so that the termina-
     tion of the parent also causes the termination of all of its children.

     In the second synopsis form, atf-exec will print information about all
     supported options and their purpose.

     The following options are available:

     -h              Shows a short summary of all available options and their
                     purpose.

     -t secs:file    Kills the child process after secs seconds unless it has
                     voluntarily finished before this amount of time has
                     passed.  If the time runs out, the control file file is
                     created and an error code is returned.

SEE ALSO
     atf(7)

NetBSD 5.0                        May 2, 2008                       NetBSD 5.0