Name

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

Synopsis

licence structure 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 59. C: legal.licence

CFMutableDictionaryRef myRequest = PMRequestCreate(kCFAllocatorDefault,kPMRPCLegalLicence);


Example 60. Objective-C: legal.licence

DSSWPMRequest* myRequest = [DSSWPMRequest requestWithRequest:kPMRPCLegalLicence];


Example 61. AppleScript: legal.licence

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


Example 62. Shell: legal.licence

./pmctl legal.licence