Name

licence, legal.licence, kPMRPCLegalLicence, kPMObserveLegalLicence — Engine's licence details.

Synopsis

legal.licence( );  
 

Description

Engine's licence details.

licence details the state of the engine and who, if anyone, holds a licence to use the engine.

Note licence does not include any private licence codes. Licence codes can not be retrieved once they are set; that is, licence codes are write only values.

Returns

licence is a licence structure.

Observable

Changes to licence can be observed, without polling, using legal.licence, kPMObserveLegalLicence.

Security

licence can be requested by any authenticated client.

Unauthenticated clients are authorized using the uk.co.dssw.powermanager.legal.licence right. By default, any local process can request licence.

Availablility

pmdctl

Examples

Example 53. C: legal.licence


CFMutableDictionaryRef myRequest = PMRequestCreate(kCFAllocatorDefault,kPMRPCLegalLicence);


Example 54. Objective-C: legal.licence


DSSWPMRequest* myRequest = [DSSWPMRequest requestWithRequest:kPMRPCLegalLicence];


Example 55. AppleScript: legal.licence


tell application "Power Manager Scripting"
    set myResult to licence of Legal
end tell


Example 56. Shell: legal.licence


./pmctl legal.licence