Hassan Hashemi`s blog

Afghan software developers

Say hello to threading in .NET (Part 1)

Say hello to threading in .NET (Part 1)

in these series of posts i would like to walk you through any thing you need to know about Threads in windows and .Net.
there are a few essential concepts and vocabularies that should be understood in order to get a better understanding about threading:

1- Processes and threads introduction.

2- Multi threading in .net.

3- Thread Pool.

4- OS Multitasking.

5- OS Scheduling.

in part one of these series i`ll try to cover Processes:

1- Process:

back when i started programming i was always thinking about how operating system manage application, i remember at first days of programming i was trying write an app in C++ that locates the life variable of players`s health (Counter strike 1.6) in memory and increases it :ِD (i`m actually a pro in counter strike).

as you know i`v never succeeded but that mistake forced me to investigate very much more about memory management.
the question was still living in my mind: why this thing dose not work? i`ll explain why it did not.

a process is an object created by operating system and its job is to provide all resources an app needs in order to run properly.
a new process is created for every app that is going to run using CreateProcess (there are other functions although) function documented by Microsoft, this function returns a bool value which shows weather it succeeded or no.
- when a process is terminated?
a process is terminated when:
a) all threads inside the process terminate.
b) any of its threads make a call to ExitProcess function.
c) a call be made to TerminateProcess function from the outside of the process.

now, what a process contain or provide? here is a small list:
1- private virtual address space.
2- threads.
3- private process handles table.
4- access token. (determines the security context in which that code is being executed in that process)

after exploring these topic about Processes, we`ll jump right into the code and examine them.

   1- Virtual address space:
each process will see a flat linear memory which then gets mapped physical memory. this is in fact an abstraction layer on top of physical memory, (that`s why my app was not working :D) because the process accesses the data in memory by its pointers regardless of where it actually lives. it might be RAM or some thing called a page file. you can fine more information about page files on msdn in here.

 the memory management is done by windows memory manager. 
(for more about information about windows memory management function click here)
you can see the processes and virtual memory being used by each process in task manager:

processes currently running are shown in windows task manager along with its details

the memory mapping

the size of this virtual memory is 2 GB on 32 bit and 8 TB on 64 bit windows.

2- Threads:

as you might know, a Thread is inside the Process and is the one who is executing code.
in a very simple word a thread is some sort of code stream where one side is the code and other side is the processor of the machine.

a process may contain a hundred of threads, it can have several reasons which we will discuss in up coming parts.
each thread will run on a different processor or at least different cores of a processor. 
lets go back to windows task manager and see what threads are currently running.

a very brief calculation show 152 threads running currently on my machine.
i m sure that my computer dose not have 152 cores, so whats going on?!!
well, when there is enough processor each thread will run on its own core but when there is not enough cores whats happen is that windows thread scheduler lets every thread to run for a little bit of time and after saving its state then another thread will take its place on the processor.

for windows this time is approximately 20 ms but it varies between different Operating systems, this process is called context switching.
Context switches are usually computationally intensive, and much of the design of operating systems is to optimize the use of context switches. Switching from one process to another requires a certain amount of time for doing the administration - saving and loading registers and memory maps, updating various tables and lists etc.
A context switch can mean a register context switch, a task context switch, a stack frame switch, a thread context switch, or a process context switch.

now, what a thread contain or actually has? 
1- thread context
2- security token
3- scheduling state

1- Thread Context: 
 The thread context includes the thread's set of machine registers, the kernel stack, a thread environment block, and a user stack in the address space of the thread's process. Threads can also have their own security context, which can be used for impersonating clients temporarily.

as we have seen a thread context consists of a set of machine registers, user stack and a kernel stack.
- machine register set: determines the processor register that the thread is currently using.
- Kernel mode stack and user mode stack:
when a context switching Occurs the information the information about the thread will be saving in its stack.
in order to isolate the kernel code from faults, when executing in user mode, kernel memory is not accessible even though if it is mapped. 

eventually whats the difference between the two stacks in simple words?
basically user mode stack is used to contain local variable and argument passing to methods plus next execution target after the current method returns. on the other hand the kernel mode stack is used when application code (user mode) calls kernel code, at this point windows copies arguments from user mode stack to kernel mode stack so it can verify them and make sure they are not changed any more since application does not have access code to kernel mode stack.

Thread environment block:
or for short TEB, this is a block of memory (4 KB) initialized in user mode which holds some information about the thread.
there is a really cool debugger command in here !teb that shows information that a particular TEB holds.
some of the most important of them are:
a) Thread local storage
b) Exception List
c) Exception code
d) ... .

2- thread Security token:
this item is explained in downer parts of this post because its same as Process access token.

3- scheduling state:
every thread can have one of these following states:

The thread state includes AbortRequested and the thread is now dead,
 but its state has not yet changed to Stopped.

AbortRequestedThe Thread.Abort method has been invoked on the thread, but the thread has not yet received the pending System.Threading.ThreadAbortException that will attempt to terminate it.
BackgroundThe thread is being executed as a background thread, as opposed to a foreground thread.
 This state is controlled by setting the Thread.IsBackground property.

RunningThe thread has been started, it is not blocked, and there is no pending ThreadAbortException.
StoppedThe thread has stopped.
StopRequestedThe thread is being requested to stop. This is for internal use only.
SuspendedThe thread has been suspended.
SuspendRequestedThe thread is being requested to suspend.
The Thread.Start method has not been invoked on the thread.

WaitSleepJoinThe thread is blocked. This could be the result of calling Thread.Sleep or Thread.Join, of requesting a lock —
for example, by calling Monitor.Enter or Monitor.Wait —
or of waiting on a thread synchronization object such as ManualResetEvent.

- so in what order threads are running in our machines?
Thread Priority: threads are scheduled according to their priority property, this property can have a value starting from 0 and ending to 31.

thread's base priority level and Process Priority class:
process priority class includes a range of thread priority levels. this value together with each thread`s priority will form the each thread`s base priority witch eventually determines execution priority of the thread.

here i want to show a sample combination of these two:
Process priority classThread priority levelBase priority

there is on more thing that i would like to discuss about threads in here and that is Thread Message queue:

In computer sciencemessage queues are software-engineering components used for inter-process communication (IPC), or for inter-thread communication within the same process.

so first, lets see what is a message queue:
by default when a thread is created it is assumed to be a worker thread but, if a thread make a call to any GDI32.dll function windows will create a message queue for that particular thread.
since windows-based apps are event driven they way they obtain input from the user is different than MS-DOS apps where the apps where making calls to C run-time library functions in order to get inputs. instead they for the system to pass input to them.
every window in windows operating system is associated with a window procedure which is a function that processes all messages sent or posted to all windows and pass control to system.

once a window stops responding to posted message form system, it  will be considered as not responding which is bad for us as developers because here comes that bad part, after window has been considered as not responding, system will replace it with a ghost windows with same x and y positions and lets the user to actually close that.

what we got from this paragraph is that if a thread is blocked and the UI is on that thread it means that our app is now not responding and is in under the risk of being killed by the user, in most worse case get "End Task" from task manager.
this situation is one of the most important use cases of multiple threads in an application.

3- Process Handle table: 

it holds all the kernel objects that have been opened by the process (actually running code in the process).
for those dose not know about handles:

An object is a data structure that represents a system resource, such as a file, thread, or graphic image. An application cannot directly access object data or the system resource that an object represents. Instead, an application must obtain an object handle, which can be used to examine or modify the system resource.
 Each handle has an entry in an internally maintained table. These entries contain the addresses of the resources and the means to identify the resource type.

object - handle mechanism has two huge benefit:

first, it makes sure that the original object interface is maintained while Microsoft update system functionality as newer versions are coming.

second, it provides a protection layer since it has its own ACL(access-control list). the ACL specifies actions that a particular process can perform on the object. every time a handle is created to a specific object the system will check the ACL.

After the event object has been created, the application can use the event handle to set or wait on the event. this handle remains valid until the application closes the handle is terminated.

the process handle table is used only for kernel object not for user objects or GDI objects.

kernel objects are meant to perform system operation such as memory management, Process execution and IPC (inter-process communications).

handles can be created to existing kernel objects by any process (even ones created by another process), only in case that particular process knows the name of the object and has security access to the object.

oh, i said security access. every object has its own set of access rights. for example file handles might have read or write access or even both.

Kernel objectCreator functionDestroyer function
Access tokenCreateRestrictedTokenDuplicateToken,
Change notificationFindFirstChangeNotificationFindCloseChangeNotification
Communications deviceCreateFileCloseHandle
Console inputCreateFileCloseHandle
Console screen bufferCreateFileCloseHandle
DesktopGetThreadDesktopApplications cannot delete this object.
Event logOpenEventLogRegisterEventSource,

3- Access tokens

an access token is supposed to describe the security context of a particular process or a thread because often the security token of the process is used by its threads.

once the user logs into system, this token is produced and then every process executed after has a copy of this access token.

so when does it act?
the system use this token for identification when a thread tries to interact with a  securable object.

the information an access token contains is listed blow as Microsoft documented:
  • The security identifier (SID) for the user's account
  • SIDs for the groups of which the user is a member
  • logon SID that identifies the current logon session
  • A list of the privileges held by either the user or the user's groups
  • An owner SID
  • The SID for the primary group
  • The default DACL that the system uses when the user creates a securable object without specifying a security descriptor
  • The source of the access token
  • Whether the token is a primary or impersonation token
  • An optional list of restricting SIDs
  • Current impersonation levels
  • Other statistics

types of Access tokens: 

there are two types of access tokens, one is Primary Token and the other one is called Impersonation token.
Primary token is set to each process by default and contains information of the currently logged on user. the impersonation token is used when a thread needs the identity of a user other than the one currently logged on to the system. this is useful on server application when they need client identity to perform a specific task.

the impersonation token can be set by a call to  SetThreadToken windows function.
can a thread have both access tokens? Yes of course.

following functions can be used in order to manipulate access tokens:
AdjustTokenGroupsChanges the group information in an access token.
AdjustTokenPrivilegesEnables or disables the privileges in an access token. It does not grant new privileges or revoke existing ones.
CheckTokenMembershipDetermines whether a specified SID is enabled in a specified access token.
CreateRestrictedTokenCreates a new token that is a restricted version of an existing token. The restricted token can have disabled SIDs, deleted privileges, and a list of restricted SIDs.
DuplicateTokenCreates a new impersonation token that duplicates an existing token.
DuplicateTokenExCreates a new primary token or impersonation token that duplicates an existing token.
GetTokenInformationRetrieves information about a token.
IsTokenRestrictedDetermines whether a token has a list of restricting SIDs.
OpenProcessTokenRetrieves a handle to the primary access token for a process.
OpenThreadTokenRetrieves a handle to the impersonation access token for a thread.
SetThreadTokenAssigns or removes an impersonation token for a thread.
SetTokenInformationChanges a token's owner, primary group, or default DACL.

Ok, we are done with part 1 in next post we`ll start to talk about threading in .net framework.

Comments (5) -

  • Jack

    8/5/2014 11:12:43 AM | Reply

    nice post, very informative. thanks man Smile

  • Jignesh Patel

    8/5/2014 4:47:00 PM | Reply

    First post !!

    Very useful and detailed information.  I like details about "3- Access tokens"


    • Hassan

      8/7/2014 9:21:39 AM | Reply

      your welcome dude.

  • nabi

    8/11/2014 2:34:11 PM | Reply

    سلام آقای هاشمی
    تشکر بابت پست این مطلب

    • حسن

      8/13/2014 7:41:32 PM | Reply

      خواهش می کنم

Pingbacks and trackbacks (1)+