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