Linux Certif

Toute la documentation sur la certification Linux LPI

Test::AutoBuild::Stage::SetNice.3pm

NAME

Test::AutoBuild::Stage::SetNice - Alter the scheduling priority of builder

SYNOPSIS

   use Test::AutoBuild::Stage::SetNice
 
 

DESCRIPTION

This module provides the ability to alter the scheduling priority of the build process, typically lowering it to avoid monopolising all the resources of the host machine. This is analogous to launching the builder process through the nice(1) command.

CONFIGURATION

In addition to the standard parameters defined by the Test::AutoBuild::Stage module, this module accepts one entry in the "options" parameter:

nice-level

An integer in the range -20 (highest priority) to 19 (lowest priority) indicating what schedular priority to give to the builder. NB, typically you will be unable to set a priority less than zero, since the builder does not run as root. If omitted, the default value is 19 to ensure lowest priority is taken.

EXAMPLE

   {
     name = renice
     label = Set Process Priority
     module = Test::AutoBuild::Stage::SetNice
     critical = 0
     options = {
       nice-level = 19
     }
   }
 
 

METHODS

$stage->init(%params);

Override super class to initialize the default nice level if non was specified. It is not neccesary to call this method since it is called automatically by the "new" method.

$stage->process($runtime);

Attempt to change the priority of the builder process according to the "nice-level" option. If unsuccessful, marks the stage as having "failed". Since this is a recoverable error, it is usual to set this stage as non-critical.

AUTHORS

Daniel Berrange <dan@berrange.com> Dennis Gregorovic <dgregorovic@alum.mit.edu>

COPYRIGHT

Copyright (C) 2004 Red Hat, Inc.

SEE ALSO

perl(1), Test::AutoBuild::Stage