diff -r 000000000000 -r 4e1aa6a622a0 sysstatemgmt/systemstarter/sysmonsrc/sysmonclisess.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sysstatemgmt/systemstarter/sysmonsrc/sysmonclisess.cpp Tue Feb 02 00:53:00 2010 +0200 @@ -0,0 +1,197 @@ +// Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of "Eclipse Public License v1.0" +// which accompanies this distribution, and is available +// at the URL "http://www.eclipse.org/legal/epl-v10.html". +// +// Initial Contributors: +// Nokia Corporation - initial contribution. +// +// Contributors: +// +// Description: +// + +#include + +#include "sysmonclisess.h" +#include "sysmoncliserv.h" +#include "../src/SysStartDebug.h" + +/** +Default constructor. +Creates an instance of the RSysMonSession class +@publishedAll +@released +*/ +EXPORT_C RSysMonSession::RSysMonSession() : RSessionBase() + { + } + +/** +Opens connection with SysMonServer +@return returns KErrNone or an error code. +@publishedAll +@released +*/ +EXPORT_C void RSysMonSession::OpenL() + { + DEBUGPRINT1(_L("SysMonCli: Opening session")); + User::LeaveIfError(CreateSession(KSysMonServerName, TVersion(0,0,0), 1)); + } + +/** +Closes connection with SysMonServer +@publishedAll +@released +*/ +EXPORT_C void RSysMonSession::Close() + { + DEBUGPRINT1(_L("SysMonCli: Closing session")); + RSessionBase::Close(); + } + +/** +Used to initiate the monitoring of a started component. +Example use: +@code + CStartupProperties* prop = CStartupProperties::NewLC(KFilename, KNullDesC); + prop->SetMonitored(ETrue); + prop->SetStartupType(EStartApp); + prop->SetStartMethod(EWaitForStart); + prop->SetNoOfRetries(1); + prop->SetTimeout(1000); + prop->SetRecoveryParams(EIgnoreOnFailure, 0); + iMySysMonSession.MonitorL(*prop, process); + CleanupStack::PopAndDestroy(prop); +@endcode + +@param aStartupProperties Properties for the component to be monitored. + Number of retries and timeout in @c aStartupProperties should only be used with + start-method @c EWaitForStart. A monitored component with start-method @c EFireAndForget + will not be restarted on failure, the recovery method will be executed immediately. + Start-method @c EDeferredWaitForStart can not be used for monitoring. +@param aProcess The running instance of the component to be monitored. +@param aExecuteRecoveryMethodOnFailure Gives the option to initiate monitoring on an already + dead process. If the process is already dead, the monitor will be scheduled to recover + the process. The default behaviour is to leave and not allow monitoring to be setup if + the process is already dead. +@capability ECapabilityProtServ +@capability ECapabilityPowerMgmt for ERestartOSWithMode +@publishedAll +@deprecated +@leave KErrDied if @c aProcess is no longer running and @c aExecuteRecoveryMethodOnFailure is false +@leave KErrArgument if @c aStartupProperties contains invalid argument or if @c aProcess contain NULL handle +@leave KErrPermissionDenied if client does not have the requied PlatSec capability +@leave KErrAlreadyExists if the process is already registered for monitoring +*/ +EXPORT_C void RSysMonSession::MonitorL(const CStartupProperties& aStartupProperties, const RProcess& aProcess, TBool aExecuteRecoveryMethodOnFailure) + { + DEBUGPRINT1(_L("SysMonCli: Monitor process")); + DoMonitorL(aStartupProperties, &aProcess, aExecuteRecoveryMethodOnFailure); + } + +/** +Used by a started component to initiate self-monitoring. + +@param aStartupProperties Properties for itself. + Number of retries and timeout in @c aStartupProperties should only be used with + start-method @c EWaitForStart. A monitored component with start-method @c EFireAndForget + will not be restarted on failure, the recovery method will be executed immediately. + Start-method @c EDeferredWaitForStart can not be used for monitoring. +@capability ECapabilityProtServ for ERestartOS and ERestartOSWithMode +@capability ECapabilityPowerMgmt for ERestartOSWithMode +@publishedAll +@deprecated +@leave KErrArgument if @c aStartupProperties contains invalid argument or if @c aProcess contain NULL handle +@leave KErrPermissionDenied if client does not have the requied PlatSec capability +@leave KErrAlreadyExists if the process is already registered for monitoring +*/ +EXPORT_C void RSysMonSession::MonitorSelfL(const CStartupProperties& aStartupProperties) + { + DEBUGPRINT1(_L("SysMonCli: Monitor self")); + DoMonitorL(aStartupProperties, NULL, EFalse); + } + + +void RSysMonSession::DoMonitorL(const CStartupProperties& aStartupProperties, const RProcess* aProcess, TBool aExecuteRecoveryMethodOnFailure) + { + User::LeaveIfError(Validate(aStartupProperties)); + + CBufFlat* const propsBuf = CBufFlat::NewL(aStartupProperties.Size()); + CleanupStack::PushL(propsBuf); + + aStartupProperties.ExternalizeL(*propsBuf); + TPtr8 propsPtr(propsBuf->Ptr(0)); + +#ifdef _DEBUG + TPtrC fileName = aStartupProperties.FileName(); + DEBUGPRINT2(_L("SysMonCli: Initiating monitor for %S"), &fileName); +#endif + + if (aProcess) + { + if (aProcess->Handle() == KNullHandle) + { + User::Leave(KErrArgument); + } + + TPckg pidPckg(aProcess->Id()); + TIpcArgs ipcArgs(&propsPtr, &pidPckg, aExecuteRecoveryMethodOnFailure); + User::LeaveIfError(SendReceive(EMonitor, ipcArgs)); + } + else + { + TIpcArgs ipcArgs(&propsPtr); + User::LeaveIfError(SendReceive(EMonitorSelf, ipcArgs)); + } + + CleanupStack::PopAndDestroy(propsBuf); + } + +/** +Used to cancel self-monitoring of a component. + +This function is to be called by the component being monitored either by calling +MonitorL() or MonitorSelfL() function. By calling this function before exiting, +System Monitor will cancel the monitor request of the component so that System Monitor +will not restart it after it exit. +@publishedAll +@released +*/ +EXPORT_C void RSysMonSession::CancelMonitorSelfL() + { + DEBUGPRINT1(_L("SysMonCli: Cancelling monitor")); + User::LeaveIfError(SendReceive(ECancelSelf)); + } + +/** Validate CStartupProperties parameter +*/ +TInt RSysMonSession::Validate(const CStartupProperties& aProp) + { + if(aProp.FileName().Length() > 0) + { + if(aProp.Monitored()) + { + if(aProp.StartupType() == EStartProcess || aProp.StartupType() == EStartApp) + { + if(((aProp.StartMethod() == EFireAndForget) && (aProp.NoOfRetries() == 0)) || + (aProp.StartMethod() == EWaitForStart)) + { + if(aProp.NoOfRetries() >= 0) + { + if(aProp.Timeout() >= 0) + { + if(aProp.RecoveryMethod() >= EIgnoreOnFailure && aProp.RecoveryMethod() <= ERestartOSWithMode) + { + return KErrNone; + } + } + } + } + } + } + } + return KErrArgument; + }