1 // Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
2 // All rights reserved.
3 // This component and the accompanying materials are made available
4 // under the terms of "Eclipse Public License v1.0"
5 // which accompanies this distribution, and is available
6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
8 // Initial Contributors:
9 // Nokia Corporation - initial contribution.
14 // This file has been deprecated and use ssmcmd.hrh instead
18 #ifndef __STARTUP_HRH__
19 #define __STARTUP_HRH__
21 /** Identifiers for different command types.
23 Note: To add a new command type, extend this enum and add a
24 new struct to startup.rh. The struct should start with a WORD
25 member initialised to the newly-added value.
28 @deprecated Instead of this use TSsmCommandType
30 enum TStartupCommandType
33 This command is used for starting processes.
37 This command is used for starting apps.
41 This command is used for starting or killing the splash screen.
45 This command is used to force the apparc server to initialise.
49 This command is used to call a function within a DLL using
54 This command is used to check that all previous processes and
55 apps with start_method EDeferredWaitForStart have rendezvoused.
59 This command is used for starting processes with extended sysstart V2 functionality.
63 This command is used for starting applications with extended sysstart V2 functionality.
67 This command is used for starting AMAStarter with a particular DSC
72 /** Identifiers for starting up an application. Presently there are
73 two methods of startup.
76 @deprecated Instead of this use TSsmCommandType
90 /** Identifiers for each startup state. Used to inform state-aware
91 applications of a change of state.
94 @deprecated Instead of this use TSsmStartupSubStates
96 enum TStartupStateIdentifier
101 EStartupStateUndefined = 0x00,
104 Reserved for future use.
106 EReservedStartUpState1 = 0x08,
108 Within this state all ROM based(static) components or resources
109 that are critical to the operation of the phone function are started.
111 EStartupStateCriticalStatic = 0x10,
114 Reserved for future use.
116 EReservedStartUpState2 = 0x18,
118 Within this state all non-ROM based(dynamic) components or resources
119 that are critical to the operation of the phone function are started.
121 EStartupStateCriticalDynamic = 0x20,
125 EStartupStateNetworkingCritical = 0x28,
127 Within this state all ROM based(static) or non-ROM based(dynamic) components
128 or resources that are non-critical to the operation of the phone function
131 EStartupStateNonCritical = 0x30,
134 Reserved for future use.
136 EReservedStartUpState4 = 0x38,
139 Reserved for future use.
141 EReservedStartUpState5 = 0x40
144 /** Identifiers for each start-up method.
147 @deprecated Instead of this use TSsmExecutionBehaviour
152 By using this type the starter can continue immediately
153 with executing its next command.
157 By using this type the starter cannot continue with the
158 next command until a rendezvous has been made with the started process.
162 By using this type the starter will continue with the next command
163 before a rendezvous has been made with the current command.
164 However the rendezvous will be checked later when a MULTIPLE_WAIT command
167 EDeferredWaitForStart
172 /** Identifier for the no of retries on state transition failure.
180 On state transition failure do not re-attempt the transition.
184 On state transition failure re-attempt the transition once.
190 /** Identifier for the action to be taken on state transition
191 failure (after a re-attempt has already been made if required).
194 @deprecated Instead of this use TSsmRecoveryMethod
196 enum TActionOnStateTransitionFailure
199 Ignore the state transition failure. Carry on with actions
200 corresponding to the next state.
205 Panic the system starter if state transition failed. This
206 will cause the device to re-boot.
211 /** Identifier for the action to be taken on command failure.
212 This is used with the fail_on_error fields within START_PROCESS_INFO, START_APP_INFO, START_DLL_INFO, and MULTIPLE_WAIT structures.
213 These structures rely on this enum being a boolean value so it must not hold more than 2 values: EIgnoreCommandFailure=0 and EPanicOnCommandFailure=1.
216 @deprecated Instead of this use TSsmRecoveryMethod
218 enum TActionOnCommandFailure
221 Ignore the command failure.
223 EIgnoreCommandFailure,
226 Panic the system starter if command fails. This
227 will cause the device to re-boot.
229 EPanicOnCommandFailure
232 /** Identifier for the action to be taken on command failure.
233 This should be used to set the retry_failure_recovery_method when using START_PROCESS_INFO2 or START_APP_INFO2 structures
236 @deprecated Instead of this use TSsmRecoveryMethod
241 Ignore the command failure
249 Reboot the OS in a particular mode
253 Reboot the OS (with no attempts to restart the component being attempted)
258 #endif // __STARTUP_HRH__