Name

restart, build.restart, kPMRPCBuildRestart — Restart the engine and associated processes.

Synopsis

void build.restart( );

Description

Restart the engine and associated processes.

Issues termination signals to the engine's associated processes in all user sessions. After the signals are sent, the engine is stopped. launchd is responsible for relaunching.

Restart is only available on Mac OS X 10.5 and later. Mac OS X 10.4's launchd does not support the required functionality for relaunching the associated processes.

Parameters

Security

restart can be requested by any authenticated client.

Unauthenticated clients are authorized using the uk.co.dssw.powermanager.build.restart right. By default, only local processes belonging to administrator can send a restart request.

Availablility

pmdctl

Examples

Example 31. C: Minimal build.restart

CFMutableDictionaryRef myRequest = PMRequestCreate(kCFAllocatorDefault, kPMRPCBuildRestart);