NAME

Tapper::Installer::Precondition::PRC

SYNOPSIS

use Tapper::Installer::Precondition::PRC;

NAME

Tapper::Installer::Precondition::PRC - Install Program Run Control to a given location

FUNCTIONS

create_common_config

Create the part of the config that is the same for both Windows and Unix.

@return hash ref

create_unix_config

Generate a config for PRC running on Unix system. Take special care for virtualisation environments. In this case, the host system runs a proxy which collects status messages from all virtualisation guests.

@param hash reference - contains all information about the PRC to install

@return hash ref - config

write_unix_config

Generate and write config for unix test.

@param hash reference - contains all information about the PRC to install

@return success - 0 @return error - error string

install_startscript

Install a startscript for init in test state.

@return success - 0 @return error - error string

create_windows_config

Create the config for a windows guest running the special Win-PRC. Win-PRC expects a flat YAML with some different keys and does not want any waste options.

@param hash reference - contains all information about the PRC to install

@return hash ref - windows config

write_windows_config

Generate and write config for windows guest.

@param hash reference - contains all information about the PRC to install

@return success - 0 @return error - error string

install

Install the tools used to control running of programs on the test system. This function is implemented to fullfill the needs of kernel testing and is likely to change dramatically in the future due to limited extensibility. Furthermore, it has the name of the PRC hard coded which isn't a good thing either.

@param hash ref - contains all information about the PRC to install

@return success - 0 @return error - return value of system or error string

get_distro

Find out which distribution is installed below the directory structure given as argument. The guessed distribution is returned as a string.

@param string - path name under which to check for an installed distribution

@return success - name of the distro @return error - empty string

AUTHORS

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

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

COPYRIGHT AND LICENSE

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

This is free software, licensed under:

The (two-clause) FreeBSD License