// Copyright (c) 1994-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "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:

 // e32\include\e32kpan.h

 // Kernel-generated panic codes

 // 

 //

 #ifndef __E32KPAN_H__

 #define __E32KPAN_H__

 #include <e32def.h>

 /**

 @publishedAll

 @released

 These panics represent program errors detected by the Kernel.

 Typically, they are caused by passing bad or contradictory parameters

 to functions. Threads that cause exceptions also raise a KERN-EXEC type panic.

 */

 enum TKernelPanic

     {

     /**

     This panic is raised when the Kernel cannot find an object in

     the object index for the current process, or current thread, using

     a specified object index number (the raw handle number).

     */

 	EBadHandle=0,

 	/**

 	This is a general panic raised as a result of attempting 

 	some unauthorised activity such as trying to suspend a thread,

 	or trying to set the priority of a thread, when not authorised to do so.

 	*/

 	EAccessDenied=1,

 	/**

 	This panic is raised by the kernel when opening a kernel side object,

 	a DObject type, and the fullname is invalid.

 	*/

 	EBadName=2,

 	/**

 	This panic is raised when an unhandled exception occurs.

 	Exceptions have many causes, but the most common are access violations

 	caused, for example, by dreferencing NULL.

 	Among other possible causes are:

 	general protection faults, executing an invalid instruction,

 	alignment checks, etc.

 	*/

 	ECausedException=3,

 	/**

 	Not used.

 	*/

 	ECompletion=4,

 	/**

 	Not used.

 	*/

 	ELeaveWithoutTrap=5,

 	/**

 	This panic is raised by the kernel when a handle to a code segment

 	is invalid.

 	*/

 	EBadCodeSegHandle=6,

 	/**

 	Not used.

 	*/

 	ESegmentWriteOutOfRange=7,

 	/**

 	Not used.

 	*/

 	EChunkSizeTooBig=8,

 	/**

 	This is a general panic raised by the kernel when an attempt

 	is made to issue a request when one is already outstanding, and only one

     outstanding request is permitted at any one time.

 	*/

 	ERequestAlreadyPending=9,

 	/**

 	This panic is raised by the Request() member function of

 	the DLogicalChannel() kernel object when the request number passed

 	to the function is smaller than the permitted minimum.

 	@see DLogicalChannel::EMinRequestId

 	*/

 	ERequestNoInvalid=10,

 	/**

 	This panic is raised when creating a logical channel, and the unit number

 	is outside the permitted range.

 	If unit numbers are not permmitted, the unit number value

 	must be KNullUnit.

 	If unit numbers are permitted, the unit number value must

 	be less than KMaxUnits.

 	*/

 	EBadUnitNumber=11,

 	/**

 	This panic is raised by the kernel if an event capture

 	hook has already been designated.

 	*/

 	EEventAlreadyCaptured=12,

 	/**

 	This panic is raised by the kernel if the current thread is not

 	the designated event capture hook.

 	*/

 	EEventNotCaptured=13,

 	/**

 	This panic is raised when an attempt is made to set the priority of

 	a thread or process to an illegal value.

 	*/

 	EBadPriority=14,

 	/**

 	This panic is raised when a timer event is requested from an asynchronous

 	timer service, an RTimer, and a timer event is already outstanding.

 	It is caused by calling either the At(), After() or Lock() member functions

 	after a previous call to any of these functions but before the timer event

 	requested by those functions has completed.

 	*/

 	ETimerAlreadyPending=15,

 	/**

 	Not used.

 	*/

 	EAlreadyLoggedOn=16,

 	/**

 	The panic is raised if kernel heap checking has failed.

 	*/

 	EFailedKernelHeapCheck=17,

 	/**

 	Not used.

 	*/

 	ERequestFromWrongThread=18,

     /**

     This panic is raised by the Kernel when a server program issues a request

     to receive a message, i.e. when it calls the Receive() member function

     of RServer, the handle to the Kernel side server object.

     The panic occurs when a receive message request has previously been made

     and is still outstanding.

     */

 	EMesAlreadyPending=19,

 	/**

 	This panic is raised by the Kernel when a request for an event

 	(as originated by a call to UserSvr::RequestEvent()) is made while

 	a previously made request is still outstanding.

 	*/

 	EEventRequestPending=20,

 	/**

 	Not used.

 	*/

 	EIllegalWsProcess=21,

 	/**

 	Not used.

 	*/

 	EHardwareNotAvailable=22,

 	/**

 	This panic is raised when attempting to create a session with a server,

 	and access is been denied.

 	*/

 	EUnsharableSession=23,

 	/**

 	This panic is raised when writing global DLL data, and the length of

 	data to be written is greater than the space available.

 	*/

 	EDesOverflow=24,

 	/**

 	This panic is raised when searching for objects, using the internal

 	function TFindHandleBase::NextObject(), and an invalid object type

 	is specified.

 	*/

 	EBadObjectType=25,

 	/**

 	This panic is raised by kernel side code that implements heap debugging

 	behaviour, when a specific debug request is not recognised.

 	*/

 	EBadKernelHeapDebugFunction=26,

 	/**

 	This panic is raised when an executive call is made with an invalid call

 	number.

 	*/

 	EInvalidSystemCall=27,

 	/**

 	Not used.

 	*/

 	ESetSessionPtrInvalidMessage=28,

 	/**

 	Not used.

 	*/

 	ECompleteDisconnectInvalidMessage=29,

 	/**

 	This panic is raised when an attempt is being made to send 

 	a synchronous message to a server more than once, using

 	the current thread's dedicated synchronous message.

 	*/

 	ESyncMsgSentTwice=30,

 	/**

 	Not used.

 	*/

 	EAutoAttachFailed=31,

 	/**

 	This panic is called by DProcess::Resume() when trying to resume

 	a process that is still being loaded.

 	*/

 	EProcessNotLoaded=32,

 	/**

     This panic is raised in a call to Kern::KUDesInfo(), Kern::KUDesPut() etc

     when an invalid descriptor is passed.

 	*/

 	EKUDesInfoInvalidType=33,

 	/**

 	This panic is raised in a call to Kern::KUDesSetLength() & Kern::KUDesPut()

 	when the descriptor passed to it is not a modifiable type.

 	*/

 	EKUDesSetLengthInvalidType=34,

 	/**

 	This panic is raised in a call to Kern::KUDesSetLength() & Kern::KUDesPut()

 	when the length of the source descriptor is longer than the length of

 	the target descriptor.

 	*/

 	EKUDesSetLengthOverflow=35,

 	/**

 	This panic is raised by the kernel side code that implements the setting

 	of the currency symbol when the length of the currency symbol is 

     greater than KMaxCurrencySymbol. 

 	*/

 	EBadParameter=36,

 	/**

 	This panic is raised by kernel code when it tries to acquire the process

 	DLL lock just before a load, and the wait DLL lock is invalid.

 	*/

 	EWaitDllLockInvalid=37,

 	/**

 	This panic is raised by internal kernel code when an illegal attempt

 	is made to attatch to a library.

 	*/

 	ELibraryAttachInvalid=38,

 	/**

 	This panic is raised when extracting a list of DLL entry points

 	and the number exceeds the maximum permitted.

 	*/

 	ETooManyEntryPoints=39,

 	/**

 	This panic is raised by internal kernel code when an illegal attempt

 	is made to detach a library.

 	*/

 	ELibraryDetachInvalid=40,

 	/**

 	This panic is raised by internal kernel code when an illegal attempt

 	is made to attach to a library.

 	*/

 	ELibraryAttachedInvalid=41,

 	/**

 	This panic is raised by internal kernel code when an illegal attempt

 	is made to detach a library.

 	*/

 	ELibraryDetachedInvalid=42,

 	/**

 	This panic is raised by kernel code when it tries to release the process DLL lock

 	when a load fails, and the release DLL lock is invalid.

 	*/

 	EReleaseDllLockInvalid=43,

 	/**

 	This panic is raised when a bad message handle is passed to the kernel.

 	This usually occurs when using methods on the RMessagePtr2 or RMessage2 classes

 	after the message has been completed; or when the iHandle data member has become

 	corrupted.

 	*/

 	EBadMessageHandle=44,

 	/**

 	Not used.

 	*/

 	EInvalidMessageParameter=45,

 	/**

 	This panic can be raised as a result of a call to one of a large

 	number of functions. In general, the panic indicates an attempt to perform an

 	operation on a thread or process by code running in another process - violating

 	the security principle of process isolation. 

 	There are exceptions to this general rule, for example, where the

 	panic is raised because the calling process has insufficient capability. The

 	precise reason is stated with the function(s). 

 	-# The panic is raised on a call to the following function if the

 	   process owning the thread performing the call is not the creator of the target

 	   process or, if a handle is specified, the handle is not local.

 	   - RProcess::SetParameter()

 	   .

 	-# The panic is raised on a call to the following functions if the

 	   process owning the thread performing the call is not the same as the target

 	   process.\n

 	   - RProcess::Kill()

 	   - RProcess::Terminate()

 	   - RProcess::Panic()

 	   - RProcess::SetJustInTime()

 	   - RProcess::Resume()

 	   - RThread::Kill()

 	   - RThread::Terminate()

 	   - RThread::Panic()

 	   - RThread::Suspend()

 	   - RThread::Resume()

 	   - RThread::SetPriority()		 

 	   - RThread::RequestComplete()

 	   - RThread::RequestSignal()		 

 	   .  

 	   NOTE: the creator of a new process can kill or panic the new

 	   process, change the new process priority and set the new process startup

 	   parameters until the process is resumed (which the creator can also do). After

 	   the new process has been resumed, then it becomes totally independent of its

 	   creator, and any attempt to panic it, kill it etc will raise the KERN-EXEC 46

 	   panic.

 	-# The panic is raised on call to the following (Symbian partner

 	   only) functions if the calling process does not have the PowerMgmt

 	   capability (TCapability::ECapabilityPowerMgmt): 

 	   - Power::PowerDown()

 	   - Power::EnableWakeupEvents()

 	   - Power::DisableWakeupEvents()

 	   - Power::RequestWakeupEventNotification()

 	   - Power::CancelWakeupEventNotification()

 	   .

 	-# The panic is raised on call to the following functions if the

 	   calling process does not have the WriteDeviceData capability

        (TCapability::ECapabilityWriteDeviceData): 

 	   - User::SetMachineConfiguration()

 	   - User::SetHomeTime()

 	   - User::SetUTCTime()

 	   - User::SetUTCOffset()

 	   - User::SetUTCTimeAndOffset()

 	   .

 	-# The panic is raised on call to the following function if the

 	   calling process does not have the ReadDeviceData capability

 	   (TCapability::ECapabilityReadDeviceData): 		  

 	   - User::MachineConfiguration()

 	   .

 	*/

 	EPlatformSecurityTrap=46,

 	/**

 	This panic is raised when the user issues a request to be notified of

 	messages or the availability of space, when a request has already been

 	issued and is still outstanding.

 	@see RMsgQueue

 	*/

 	EMsgQueueRequestPending=47,

 	/**

 	This panic is raised when creating a message queue and the size of

 	the template parameter is invalid.

 	@see RMsgQueue

 	*/

 	EMsgQueueInvalidLength=48,

 	/**

 	This panic is raised when creating a message queue and the specified number

 	of slots is not positive.

 	@see RMsgQueue

 	*/

 	EMsgQueueInvalidSlots=49,

 	/**

 	This panic is raised if an attempt is made to cancel an outstanding request 

 	to be notified of messages or the availability of space, and the cancel is

 	being made by a thread in a different process.

 	*/

 	EMsgQueueIllegalCancel=50,

 	/**

 	This panic is raised by RProcess::Setparameter()

 	if a slot value is invalid.

 	*/

 	EParameterSlotRange=51,

 	/**

 	This panic is raised by RProcess::Setparameter()

 	if a slot is in use.

 	*/

 	EParameterSlotInUse=52,

 	/**

 	This panic is raised by RProcess::Setparameter()

 	if the length of the data passed is negative.

 	*/

 	EParameterSlotDataLength=53,

 	/**

 	This panic is raised by RCondVar::Wait() when the current thread does

 	not hold the specified mutex.

 	*/

 	ECondVarWaitMutexNotLocked=54,

 	/**

 	This panic is raised when a call is made to RThread::GetDesMaxLength(),

 	which is obsolete.

 	*/

 	EObsoleteFunctionality=55,

 	/**

 	This panic is raised on a process which has not yet been resumed and whoes

 	creator has died.

 	*/

 	EZombieProcessKilled=56,

 	/**

 	A connect message was sent to a session that has already been successfully

 	connected to the server (cookie is non-NULL).

 	*/

 	ESessionAlreadyConnected=57,

 	/**

 	A session tried to set the kernel session cookie to a null value

 	*/

 	ESessionNullCookie=58,

 	/**

 	A session tried to set the kernel session cookie twice

 	*/

 	ESessionCookieAlreadySet=59,

 	/**

 	A session tried to set the kernel session cookie with a message

 	that wasn't the connect message

 	*/

 	ESessionInvalidCookieMsg=60,

 	/**

 	A realtime thread executed a non-realtime function.

 	*/

 	EIllegalFunctionForRealtimeThread=61,

 	/**

 	This panic is raised by Kern::SetThreadRealtimeState when the state argument is invalid.

 	*/

 	EInvalidRealtimeState=62,

 	/**

 	A bad descriptor was passed to a server over IPC, causing an exception when the kernel tried to

 	update its length field.

 	*/

 	EBadIpcDescriptor=63,

 	/**

 	An invalid notification type was passed to a shared buffers exec call handler.

 	*/

 	EShBufExecBadNotification=64,

 	/**

 	An invalid parameter was passed to a shared buffers exec call handler.

 	*/

 	EShBufExecBadParameter=65,

 	};

 #endif