Changes

Jump to navigation Jump to search
981 bytes added ,  01:48, 22 May 2020
no edit summary
Line 1: Line 1:  
[[Category:Kernel synchronization objects]]
 
[[Category:Kernel synchronization objects]]
class [[KThread]] extends [[KSynchronizationObject]], [[KTimeableInterruptEvent]], some dummy subclass of [[KSynchronizationInterruptEvent]] and [[KSchedulableInterruptEvent]];
+
[[Category:Kernel interrupt events]]
 +
class [[KThread]] extends [[KSynchronizationObject]], [[KTimeableInterruptEvent]], [[KSendableInterruptEvent]] and [[KSchedulableInterruptEvent]];
    
Size : 0xB0 bytes
 
Size : 0xB0 bytes
Line 6: Line 7:  
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Offset
 
! Type
 
! Type
! Description
+
! Description
 
|-
 
|-
 
| 0x0
 
| 0x0
Line 32: Line 33:  
| 0x14
 
| 0x14
 
| [[KTimeableInterruptEvent]]
 
| [[KTimeableInterruptEvent]]
| Inherited, used to suspend threads  
+
| Used to suspend threads (*this)
 
|-
 
|-
 
| 0x24
 
| 0x24
| Subclass of [[KSynchronizationInterruptEvent]]
+
| [[KSendableInterruptEvent]]
| Inherited, scheduled by the function called by svcExitThread in a dedicated object
+
| Interrupt event (*this) sent to terminate a thread, except in the case just below
 
|-
 
|-
 
| 0x2C
 
| 0x2C
 
| [[KSchedulableInterruptEvent]]
 
| [[KSchedulableInterruptEvent]]
| Inherited, scheduled by the IRQ handler when the thread should terminate
+
| Interrupt event (*this) scheduled by the IRQ handler when the thread should terminate (*this)
 
|-
 
|-
 
| 0x34
 
| 0x34
 
| u8
 
| u8
| Whether the thread is in the scheduler's queue and is ready to run
+
| Scheduling mask
 
|-
 
|-
 
| 0x35
 
| 0x35
 
| u8
 
| u8
| Used in syncing
+
| Set to 1 when a thread is woken up from a svcSendSyncRequest call due to the ServerSession endpoint closing down
 
|-
 
|-
 
| 0x36
 
| 0x36
Line 56: Line 57:  
| 0x37
 
| 0x37
 
| u8
 
| u8
| Used in syncing
+
| Indicates there was an error translating the parameters in the command buffer during an IPC call
 
|-
 
|-
 
| 0x38
 
| 0x38
Line 112: Line 113:  
| 0x70
 
| 0x70
 
| s32
 
| s32
| Processor that created the thread
+
| Processor that created the thread (in the sense of "first ran") ; processor the thread is running in
 
|-
 
|-
 
| 0x74
 
| 0x74
| u32
+
| [[KResourceLimit|KPreemptionTimer]] *
| ?
+
| Points to [[KResourceLimit]]+0x60, which among other things holds the amount of CPU time available in ticks, or NULL
 
|-
 
|-
 
| 0x7C
 
| 0x7C
 
| u8
 
| u8
| ?
+
| Thread is alive
 
|-
 
|-
 
| 0x7D
 
| 0x7D
 
| u8
 
| u8
| ?
+
| Thread has been terminated
 
|-
 
|-
 
| 0x7E
 
| 0x7E
Line 168: Line 169:  
| 0xAC
 
| 0xAC
 
| s32
 
| s32
| Priority field used for priority inheritance when needed
+
| Priority to restore after sleep if suspended, otherwise -1
 
|}
 
|}
    
With the following declarations: <code>struct KThreadLinkedList { KThread *first, *last; };</code> and <code>struct KThreadLinkedListNode { KThread *prev, *next; };</code>.
 
With the following declarations: <code>struct KThreadLinkedList { KThread *first, *last; };</code> and <code>struct KThreadLinkedListNode { KThread *prev, *next; };</code>.
    +
=Thread Scheduling Mask=
 +
The thread scheduling mask is made of a low nibble (enum) and a high nibble (bitfield).
 +
 +
Low nibble:
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0
 +
| The thread is not scheduled
 +
|-
 +
| 1
 +
| The thread is scheduled
 +
|-
 +
| 2
 +
| The thread is being terminated
 +
|}
 +
 +
High nibble:
 +
{| class="wikitable" border="1"
 +
|-
 +
! Mask
 +
! Description
 +
|-
 +
| 0
 +
| Nothing special
 +
|-
 +
| 0x8 (bit 3)
 +
| The thread has been debug-locked
 +
|}
 +
 +
A thread is scheduled *if and only if* its (full) scheduling mask is exactly 1. This allows debug-(un)locking of threads to be done transparently.
 
=Thread Affinity Mask=
 
=Thread Affinity Mask=
  
516

edits

Navigation menu