Danny Warren > Solaris-ProcessContract-1.01 > Solaris::ProcessContract::Contract::Control

Download:
Solaris-ProcessContract-1.01.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.01   Source  

NAME ^

Solaris::ProcessContract::Contract::Control - Control a Solaris process contract instance via libcontract

SYNOPSIS ^

  # Abandon the process contract
  $contract->control->abandon();

  # Adopt the process contract
  $contract->control->adopt();

  # Reset the control insance
  $contract->control->reset();

DESCRIPTION ^

This class allows you to control a process contract using the libcontract control interface.

METHODS ^

new

Use the "control" in Solaris::ProcessContract::Contract to access this object instead of creating one yourself.

  # Access the control object the easy way
  $contract->control->abandon();

  # Access the control object by reference
  my $control = $contract->control();
  $control->abandon();

abandon

Arguments: none

Returns: undef

Abandon the contract so that it no longer is in the same contract group as the parent.

  $contract->control->abandon();

Even when creating new contracts for child processes, those contracts are still underneath the parent's contract in the contract hierarchy.

By abandoning the contract, you will be placing it at the top of it's own hierarchy, and any monitoring, event triggers or resource limitations from processes in the contract will no longer affect your own.

adopt

Arguments: none

Returns: undef

Adopt the contract so that it is returned to your contract group.

  $contract->control->adopt();

This is the opposite of "abandon", in that it will bring an abandoned contract back in to your contract hierarchy.

reset

Arguments: none

Returns: undef

Reset the contract control object, if needed. This will make the control object close and then open back up the file descriptor for the contract control instance.

  $contract->control->reset()

SEE ALSO ^

Solaris::ProcessContract
Solaris::ProcessContract::Contract
Solaris::ProcessContract::Exceptions
libcontract(3)
contract(4)
process(4)

AUTHOR ^

Danny Warren

syntax highlighting: