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

Download:
Solaris-ProcessContract-1.01.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.01   Source  

NAME ^

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

SYNOPSIS ^

  # Get the latest contract created in the scope of our process
  my $contract = $pc->get_latest_contract();
  
  # Get the id of this contract
  print $contract->id();

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

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

DESCRIPTION ^

This class allows you to query and control a specific solaris process contract.

METHODS ^

new

Use the "get_contract" in Solaris::ProcessContract or "get_latest_contract" in Solaris::ProcessContract methods to create a new instance of this object instead of calling this yourself.

  # Get the most recently created contract in the scope of our process
  my $contract = $pc->get_latest_contract();
  
  # Get a specific contract by id, if we have permission to do so
  my $contract = $pc->get_contract( 12345 );

id

Arguments: none

Returns: $id

Returns the id of this contract.

  print $contract->id();

control

Arguments: none

Returns: $control

Provides access to the Solaris::ProcessContract::Contract::Control object for this contract.

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

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

This allows you to use the libcontract control functions to make changes to this contract.

SEE ALSO ^

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

AUTHOR ^

Danny Warren

syntax highlighting: