Name

warning, notifications.warning, kPMRPCNotificationsWarning, kPMObserveNotificationsWarning — Warnings of host affecting actions.

Synopsis

array of queued warning structures notifications.warning( );

Description

Warnings of host affecting actions.

warning provides a list of critical queued warnings. warnings are used to notify the user to actions that will affect the host's availability.

Typically a warning will appear a few seconds before an event. You should immediately present a clear and vivid warning to the user. Remove the warning once the warning has been removed from this list.

Returns

warning is an array of queued warning structures. Each item in warning must be unique.

Observable

Changes to warning can be observed, without polling, using notifications.warning, kPMObserveNotificationsWarning.

Security

warning can be requested by any authenticated client.

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

Availablility

pmdctl

Examples

Example 84. C: notifications.warning

CFMutableDictionaryRef myRequest = PMRequestCreate(kCFAllocatorDefault,kPMRPCNotificationsWarning);

Example 85. Objective-C: notifications.warning

DSSWPMRequest* myRequest = [DSSWPMRequest requestWithRequest:kPMRPCNotificationsWarning];

Example 86. AppleScript: notifications.warning

tell application "Power Manager Scripting"
    set myResult to warning of Notifications
end tell

Example 87. Shell: notifications.warning

./pmctl notifications.warning