Tapper::PRC::Testcontrol - Control running test programs
This function is a handler for the capture function. It handles capture requests of type 'tap'. This means the captured output is supposed to be TAP already and therefore no transformation is needed.
@param file handle - opened file handle
@return string - output in TAP format @return error - die()
Send the captured TAP output to the report receiver.
@param string - TAP text
@return success - 0 @return error - error string
Send the a attachment to the report receiver and add attachements.
Upload files written in one stage of the testrun to report framework.
@param int - report id @param int - testrun id
For testprogram with the same name the output file names will be identical. To prevent this, we append a serial number. This function calculates this appendix and returns the next one to use. If no such serial is needed because no output file of the given name exists yet the empty string is returned.
@param string - name of the output file without appendix
@return string - string to append to output file name to make it unique
Gracefully kill a single process.
Get list of children for a process. The process itself is not contained in the list.
Kill whole tree of processes, depth-first, with extreme prejudice.
Execute one testprogram. Handle all error conditions.
@param hash ref - contains all config options for program to execute * program - program name * timeout - timeout in seconds * outdir - output directory * parameters - arrayref of strings - parameters for test program * environment - hashref of strings - environment variables for test program * chdir - string - where to chdir before executing the testprogram
Start guest images for virtualisation. Only Xen guests can be started at the moment.
Checks whether fifos for guest logging exists and creates them if not. Existing files of wrong type are deleted.
@retval success - 0 @retval error - error string
Mount the output directory from an NFS server. This method is used since we only want to mount this NFS share in live mode.
Control running of one program including caring for its input, output and the environment variables some testers asked for.
Read syncfile and extract list of peer hosts (not including this host).
@param string - file name
@return success - hash ref
@throws plain error message
Synchronise with other hosts belonging to the same interdependent testrun.
@param array ref - list of hostnames of peer machines
Send keepalive messages to MCP in an endless loop.
@param int - sleep time between two keepalives
Main function of Program Run Control.
AMD OSRC Tapper Team <tapper@amd64.org>
Tapper Team <tapper-ops@amazon.com>
This software is Copyright (c) 2016 by Advanced Micro Devices, Inc..
This is free software, licensed under:
The (two-clause) FreeBSD License
To install Tapper::PRC, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Tapper::PRC
CPAN shell
perl -MCPAN -e shell install Tapper::PRC
For more information on module installation, please visit the detailed CPAN module installation guide.