--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sysstatemgmt/systemstatereferenceplugins/clayer/inc/starterclient.h	Tue Feb 02 00:53:00 2010 +0200
@@ -0,0 +1,164 @@
+/*
+* Copyright (c) 2002-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:
+* Name        : starterclient.h
+* Part of     : System Startup / Starter
+* Interface   : Domain, System State Control API and Extended Startup API
+* Declaration of RStarterSession interface
+* Version     : %version: ou1s60rt#8 %
+* This material, including documentation and any related computer
+* programs, is protected by copyright controlled by Nokia.  All
+* rights are reserved.  Copying, including reproducing, storing,
+* adapting or translating, any or all of this material requires the
+* prior written consent of Nokia.  This material also contains
+* confidential information which may not be disclosed to others
+* without the prior written consent of Nokia.
+* Template version: 4.0
+* Nokia Core OS *
+*
+*/
+
+
+
+#ifndef STARTERCLIENT_H
+#define STARTERCLIENT_H
+
+#include <e32std.h>
+#include <ssm/starter.hrh>
+
+
+/*
+ *   @publishedPartner
+ *   @released
+ */
+
+/**
+*  Client API for Starter server.
+*
+*  ?more_complete_description
+*
+*  lib: StarterClient.lib
+*  @since S60 1.0
+*/
+class RStarterSession : public RSessionBase
+    {
+
+public:
+
+    /**
+     * Connect to Starter server
+     * @return EPOC error code
+     */
+    IMPORT_C TInt Connect();
+
+public: // System State Control API
+
+    // Parameters for SetState.
+    enum TGlobalState
+        {
+        ENormal = 100,  // Possible in alarm, charging, BT SAP and
+                        // offline states, but not in simless offline.
+        EAlarm,         // Only possible in charging state.
+        ECharging,      // Only possible in alarm state.
+        EOffline,       // Possible in normal RF on and BT SAP states.
+        EBTSap          // Possible in normal RF on and normal RF off
+                        // states, but not in simless offline.
+        };
+
+    /**
+    * Change global system state.
+    * @param aState The state to change to.
+    * @return KErrArgument if the state change is illegal (from current state
+    * it is not possible to change to the requested state), KErrNone if the
+    * global state change has been successfully initiated.
+    * If state change from a state to the same state is requested, returns
+    * KErrNone but does nothing.
+    */
+    IMPORT_C TInt SetState( const TGlobalState aState );
+
+    // Parameters for Reset.
+    enum TResetReason
+        {
+        ELanguageSwitchReset = 100,     // A reset due to display language switch.
+        ENormalRFSReset = 101,          // A reset due to restoring factory
+                                        // settings.
+        EDeepRFSReset = 102,            // A reset due to restoring factory
+                                        // settings (deep).
+        EUnknownReset = 104,            // A reset due to an error.
+        EOperatorSettingReset = 105,    // A reset due to removing operator
+                                        // settings.
+        ENetworkModeChangeReset = 106,  // A reset due to network mode change.
+        ESIMStatusChangeReset = 107,    // A reset due to removing/inserting SIM card.
+        EDRMReset = 108,                // A reset due to a DRM -related problem.
+        EFirmwareUpdate = 109,          // A reset due to firmware update.
+        EDataRestoreReset = 110,        // A reset after restoring backed-up data.
+        EFieldTestReset = 111           // A reset required by Field Test software.
+        };
+
+    /**
+    * Execute system reset.
+    * @param aReason Indicates the reason for the reset.
+    */
+    IMPORT_C void Reset( const TResetReason aReason );
+
+    /**
+    * Execute system shutdown.
+    */
+    IMPORT_C void Shutdown();
+
+    /**
+    * Change state to offline and back to online.
+    *
+    * @return
+    * - KErrServerTerminated if system is shutting down or reseting,
+    * - KErrMemory if the state change could not be completed because of lack of memory,
+    * - KErrArgument if global state is not normal RF on,
+    * - KErrNone if a network reset is already going on.
+    */
+    IMPORT_C TInt ResetNetwork();
+
+    /**
+    * Check whether RTC time is valid.
+    * This function should not be called before critical startup phase is
+    * over, and if it is, it will return EFalse.
+    * @return ETrue if RTC time is valid, EFalse otherwise.
+    */
+    IMPORT_C TBool IsRTCTimeValid();
+
+    /**
+    * Activate RF for making an emergency call. May be called in all
+    * global states, but 'normal RF on' state the call has no effect since
+    * RF is already activated.
+    * After the emergency call has finished, DeactivateRfAfterEmergencyCall
+    * should be called.
+    * @return KErrNone on success, one of Symbian error codes otherwise.
+    */
+    IMPORT_C TInt ActivateRfForEmergencyCall();
+
+    /**
+    * Deactivate RF after making an emergency call. May only be called
+    * after calling ActivateRfForEmergencyCall.
+    * @return KErrNone on success, one of Symbian error codes otherwise.
+    */
+    IMPORT_C TInt DeactivateRfAfterEmergencyCall();
+
+    /**
+    * If Splash Screen is active, send it a signal to exit.
+    * @return KErrNone on success, one of Symbian error codes otherwise.
+    * Returns an error code only if the client-server call fails.
+    */
+    IMPORT_C TInt EndSplashScreen();
+    };
+
+#endif // STARTERCLIENT_H