The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Tapper::MCP::Child - Control one specific testrun on MCP side

SYNOPSIS

 use Tapper::MCP::Child;
 my $client = Tapper::MCP::Child->new($testrun_id);
 $child->runtest_handling($system);

FUNCTIONS

get_messages

Read all pending messages from database. Try no more than timeout seconds

@param int - timeout

@return success - Resultset class countaining all available messages @return timeout - Resultset class countaining zero messages

wait_for_testrun

Wait for the current testrun and update state based on messages.

@return hash { report_array => reference to report array, prc_state => $prc_state }

generate_configs

@param string - hostname @param int - port number of server

@return success - config hash @return error - string

report_mcp_results

Send TAP reports of MCP results in general and the results collected for each PRC.

@param Tapper::MC::Net object

handle_error

Sends a tap report because an error occured.

@param string - error string

@return error string

start_testrun

Start Installer on testmachine based on the type of testrun.

@param hash ref - config @param bool - revive mode

@return success - 0 @return error - error string

kill_process($pid)

Gracefully kill a single process.

get_process_tree($pid)

Get list of children for a process. The process itself is not contained in the list.

kill_process_tree($pid)

Kill whole tree of processes, depth-first, with extreme prejudice.

kill_local_prc_processes

Kill remaining processes from this testrun. Only done wfor testruns that run 'local'.

@param Tapper::MC::Net object

cancel_minion_prc_processes

Kill remaining processes from this testrun. Only done for testruns that run 'minion'.

@param Tapper::MCP::Net object

wait_for_minion_testrun

Wait until the corresponding Minion job reached its 'finished' state. Only done for testruns that run 'minion'.

@param Tapper::MCP::Net object

runtest_handling

Start testrun and wait for completion.

@param string - system name @param bool - revive mode?

@return success - 0 @return error - error string

AUTHOR

AMD OSRC Tapper Team, <tapper at amd64.org>

BUGS

None.

SUPPORT

You can find documentation for this module with the perldoc command.

 perldoc Tapper

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2008-2011 AMD OSRC Tapper Team, all rights reserved.

This program is released under the following license: freebsd

AUTHORS

  • AMD OSRC Tapper Team <tapper@amd64.org>

  • Tapper Team <tapper-ops@amazon.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2019 by Advanced Micro Devices, Inc..

This is free software, licensed under:

  The (two-clause) FreeBSD License