Solaris::ProcessContract::Contract::Control - Control a Solaris process contract instance via libcontract
# Abandon the process contract $contract->control->abandon(); # Adopt the process contract $contract->control->adopt(); # Reset the control insance $contract->control->reset();
This class allows you to control a process contract using the libcontract control interface.
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();
Arguments: none
none
Returns: undef
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 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 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()
Danny Warren
To install Solaris::ProcessContract, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Solaris::ProcessContract
CPAN shell
perl -MCPAN -e shell install Solaris::ProcessContract
For more information on module installation, please visit the detailed CPAN module installation guide.