NAME

Tapper::PRC::Testcontrol - Control running test programs

FUNCTIONS

capture_handler_tap

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_output

Send the captured TAP output to the report receiver.

@param string - TAP text

@return success - 0 @return error - error string

testprogram_execute

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

@return success - 0 @return error - error string

guest_start

Start guest images for virtualisation. Only Xen guests can be started at the moment.

@return success - 0 @return error - error string

create_log

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

nfs_mount

Mount the output directory from an NFS server. This method is used since we only want to mount this NFS share in live mode.

@return success - 0 @return error - error string

control_testprogram

Control running of one program including caring for its input, output and the environment variables some testers asked for.

@return success - 0 @return error - error string

get_peers_from_file

Read syncfile and extract list of peer hosts (not including this host).

@param string - file name

@return success - hash ref

@throws plain error message

wait_for_sync

Synchronise with other hosts belonging to the same interdependent testrun.

@param array ref - list of hostnames of peer machines

@return success - 0 @return error - error string

send_keep_alive_loop

Send keepalive messages to MCP in an endless loop.

@param int - sleep time between two keepalives

run

Main function of Program Run Control.

AUTHOR

AMD OSRC Tapper Team <tapper@amd64.org>

COPYRIGHT AND LICENSE

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

This is free software, licensed under:

  The (two-clause) FreeBSD License

cpanm Tapper::PRC

perl -MCPAN -e shell
install Tapper::PRC