mcs/class/corlib/System.Threading/Thread.cs

   1 //
   2 // System.Threading.Thread.cs
   3 //
   4 // Author:
   5 //   Dick Porter (dick@ximian.com)
   6 //
   7 // (C) Ximian, Inc.  http://www.ximian.com
   8 // Copyright (C) 2004-2006 Novell, Inc (http://www.novell.com)
   9 //
  10 // Permission is hereby granted, free of charge, to any person obtaining
  11 // a copy of this software and associated documentation files (the
  12 // "Software"), to deal in the Software without restriction, including
  13 // without limitation the rights to use, copy, modify, merge, publish,
  14 // distribute, sublicense, and/or sell copies of the Software, and to
  15 // permit persons to whom the Software is furnished to do so, subject to
  16 // the following conditions:
  17 //
  18 // The above copyright notice and this permission notice shall be
  19 // included in all copies or substantial portions of the Software.
  20 //
  21 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  22 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  23 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  24 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  25 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  26 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  27 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  28 //
  29
  30 using System.Runtime.Remoting.Contexts;
  31 using System.Runtime.Serialization;
  32 using System.Runtime.Serialization.Formatters.Binary;
  33 using System.Security.Permissions;
  34 using System.Security.Principal;
  35 using System.Globalization;
  36 using System.Runtime.CompilerServices;
  37 using System.Runtime.InteropServices;
  38 using System.IO;
  39 using System.Collections.Generic;
  40 using System.Reflection;
  41 using System.Security;
  42 using System.Runtime.ConstrainedExecution;
  43
  44 namespace System.Threading {
  45         [StructLayout (LayoutKind.Sequential)]
  46         internal class InternalThread : CriticalFinalizerObject {
  47 #pragma warning disable 169, 414, 649
  48                 #region Sync with metadata/object-internals.h
  49                 int lock_thread_id;
  50                 // stores a thread handle
  51                 internal IntPtr system_thread_handle;
  52
  53                 /* Note this is an opaque object (an array), not a CultureInfo */
  54                 private object cached_culture_info;
  55                 /* accessed only from unmanaged code */
  56                 private IntPtr name;
  57                 private int name_len;
  58                 private ThreadState state;
  59                 private object abort_exc;
  60                 private int abort_state_handle;
  61                 /* thread_id is only accessed from unmanaged code */
  62                 internal Int64 thread_id;
  63
  64                 /* start_notify is used by the runtime to signal that Start()
  65                  * is ok to return
  66                  */
  67                 private IntPtr start_notify;
  68                 private IntPtr stack_ptr;
  69                 private UIntPtr static_data; /* GC-tracked */
  70                 private IntPtr jit_data;
  71                 private IntPtr runtime_thread_info;
  72                 /* current System.Runtime.Remoting.Contexts.Context instance
  73                    keep as an object to avoid triggering its class constructor when not needed */
  74                 private object current_appcontext;
  75                 private object pending_exception;
  76                 private object root_domain_thread;
  77                 internal byte[] _serialized_principal;
  78                 internal int _serialized_principal_version;
  79                 private IntPtr appdomain_refs;
  80                 private int interruption_requested;
  81                 private IntPtr suspend_event;
  82                 private IntPtr suspended_event;
  83                 private IntPtr resume_event;
  84                 private IntPtr synch_cs;
  85                 internal bool threadpool_thread;
  86                 private bool thread_dump_requested;
  87                 private bool thread_interrupt_requested;
  88                 private IntPtr end_stack;
  89                 /* These are used from managed code */
  90                 internal int stack_size;
  91                 internal byte apartment_state;
  92                 internal volatile int critical_region_level;
  93                 internal int managed_id;
  94                 private int small_id;
  95                 private IntPtr manage_callback;
  96                 private IntPtr interrupt_on_stop;
  97                 private IntPtr flags;
  98                 private IntPtr android_tid;
  99                 private IntPtr thread_pinning_ref;
 100                 private int ignore_next_signal;
 101                 /*
 102                  * These fields are used to avoid having to increment corlib versions
 103                  * when a new field is added to the unmanaged MonoThread structure.
 104                  */
 105                 private IntPtr unused0;
 106                 private IntPtr unused1;
 107                 private IntPtr unused2;
 108                 #endregion
 109 #pragma warning restore 169, 414, 649
 110
 111                 // Closes the system thread handle
 112                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 113                 private extern void Thread_free_internal(IntPtr handle);
 114
 115                 [ReliabilityContract (Consistency.WillNotCorruptState, Cer.Success)]
 116                 ~InternalThread() {
 117                         Thread_free_internal(system_thread_handle);
 118                 }
 119         }
 120
 121         [ClassInterface (ClassInterfaceType.None)]
 122         [ComVisible (true)]
 123         [ComDefaultInterface (typeof (_Thread))]
 124         [StructLayout (LayoutKind.Sequential)]
 125 #if MOBILE
 126         public sealed class Thread : CriticalFinalizerObject {
 127 #else
 128         public sealed class Thread : CriticalFinalizerObject, _Thread {
 129 #endif
 130 #pragma warning disable 414
 131                 #region Sync with metadata/object-internals.h
 132                 private InternalThread internal_thread;
 133                 object start_obj;
 134                 private ExecutionContext ec_to_set;
 135                 #endregion
 136 #pragma warning restore 414
 137
 138                 IPrincipal principal;
 139                 int principal_version;
 140                 CultureInfo current_culture;
 141                 CultureInfo current_ui_culture;
 142
 143                 // the name of local_slots, current_thread and _ec is
 144                 // important because they are used by the runtime.
 145                 [ThreadStatic]
 146                 static object[] local_slots;
 147
 148                 [ThreadStatic]
 149                 static Thread current_thread;
 150
 151                 /* The actual ExecutionContext of the thread.  It's
 152                    ThreadStatic so that it's not shared between
 153                    AppDomains. */
 154                 [ThreadStatic]
 155                 static ExecutionContext _ec;
 156
 157                 static NamedDataSlot namedDataSlot;
 158
 159                 // can be both a ThreadStart and a ParameterizedThreadStart
 160                 private MulticastDelegate threadstart;
 161                 //private string thread_name=null;
 162
 163                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 164                 private extern void ConstructInternalThread ();
 165
 166                 private InternalThread Internal {
 167                         get {
 168                                 if (internal_thread == null)
 169                                         ConstructInternalThread ();
 170                                 return internal_thread;
 171                         }
 172                 }
 173
 174                 public static Context CurrentContext {
 175                         [SecurityPermission (SecurityAction.LinkDemand, Infrastructure=true)]
 176                         get {
 177                                 return(AppDomain.InternalGetContext ());
 178                         }
 179                 }
 180
 181                 /*
 182                  * These two methods return an array in the target
 183                  * domain with the same content as the argument.  If
 184                  * the argument is already in the target domain, then
 185                  * the argument is returned, otherwise a copy.
 186                  */
 187                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 188                 private extern static byte[] ByteArrayToRootDomain (byte[] arr);
 189
 190                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 191                 private extern static byte[] ByteArrayToCurrentDomain (byte[] arr);
 192
 193                 static void DeserializePrincipal (Thread th)
 194                 {
 195                         MemoryStream ms = new MemoryStream (ByteArrayToCurrentDomain (th.Internal._serialized_principal));
 196                         int type = ms.ReadByte ();
 197                         if (type == 0) {
 198                                 BinaryFormatter bf = new BinaryFormatter ();
 199                                 th.principal = (IPrincipal) bf.Deserialize (ms);
 200                                 th.principal_version = th.Internal._serialized_principal_version;
 201                         } else if (type == 1) {
 202                                 BinaryReader reader = new BinaryReader (ms);
 203                                 string name = reader.ReadString ();
 204                                 string auth_type = reader.ReadString ();
 205                                 int n_roles = reader.ReadInt32 ();
 206                                 string [] roles = null;
 207                                 if (n_roles >= 0) {
 208                                         roles = new string [n_roles];
 209                                         for (int i = 0; i < n_roles; i++)
 210                                                 roles [i] = reader.ReadString ();
 211                                 }
 212                                 th.principal = new GenericPrincipal (new GenericIdentity (name, auth_type), roles);
 213                         } else if (type == 2 || type == 3) {
 214                                 string [] roles = type == 2 ? null : new string [0];
 215                                 th.principal = new GenericPrincipal (new GenericIdentity ("", ""), roles);
 216                         }
 217                 }
 218
 219                 static void SerializePrincipal (Thread th, IPrincipal value)
 220                 {
 221                         MemoryStream ms = new MemoryStream ();
 222                         bool done = false;
 223                         if (value.GetType () == typeof (GenericPrincipal)) {
 224                                 GenericPrincipal gp = (GenericPrincipal) value;
 225                                 if (gp.Identity != null && gp.Identity.GetType () == typeof (GenericIdentity)) {
 226                                         GenericIdentity id = (GenericIdentity) gp.Identity;
 227                                         if (id.Name == "" && id.AuthenticationType == "") {
 228                                                 if (gp.Roles == null) {
 229                                                         ms.WriteByte (2);
 230                                                         done = true;
 231                                                 } else if (gp.Roles.Length == 0) {
 232                                                         ms.WriteByte (3);
 233                                                         done = true;
 234                                                 }
 235                                         } else {
 236                                                 ms.WriteByte (1);
 237                                                 BinaryWriter br = new BinaryWriter (ms);
 238                                                 br.Write (gp.Identity.Name);
 239                                                 br.Write (gp.Identity.AuthenticationType);
 240                                                 string [] roles = gp.Roles;
 241                                                 if  (roles == null) {
 242                                                         br.Write ((int) (-1));
 243                                                 } else {
 244                                                         br.Write (roles.Length);
 245                                                         foreach (string s in roles) {
 246                                                                 br.Write (s);
 247                                                         }
 248                                                 }
 249                                                 br.Flush ();
 250                                                 done = true;
 251                                         }
 252                                 }
 253                         }
 254                         if (!done) {
 255                                 ms.WriteByte (0);
 256                                 BinaryFormatter bf = new BinaryFormatter ();
 257                                 try {
 258                                         bf.Serialize (ms, value);
 259                                 } catch {}
 260                         }
 261                         th.Internal._serialized_principal = ByteArrayToRootDomain (ms.ToArray ());
 262                 }
 263
 264                 public static IPrincipal CurrentPrincipal {
 265                         get {
 266                                 Thread th = CurrentThread;
 267
 268                                 if (th.principal_version != th.Internal._serialized_principal_version)
 269                                         th.principal = null;
 270
 271                                 if (th.principal != null)
 272                                         return th.principal;
 273
 274                                 if (th.Internal._serialized_principal != null) {
 275                                         try {
 276                                                 DeserializePrincipal (th);
 277                                                 return th.principal;
 278                                         } catch {}
 279                                 }
 280
 281                                 th.principal = GetDomain ().DefaultPrincipal;
 282                                 th.principal_version = th.Internal._serialized_principal_version;
 283                                 return th.principal;
 284                         }
 285                         [SecurityPermission (SecurityAction.Demand, ControlPrincipal = true)]
 286                         set {
 287                                 Thread th = CurrentThread;
 288
 289                                 if (value != GetDomain ().DefaultPrincipal) {
 290                                         ++th.Internal._serialized_principal_version;
 291                                         try {
 292                                                 SerializePrincipal (th, value);
 293                                         } catch (Exception) {
 294                                                 th.Internal._serialized_principal = null;
 295                                         }
 296                                         th.principal_version = th.Internal._serialized_principal_version;
 297                                 } else {
 298                                         th.Internal._serialized_principal = null;
 299                                 }
 300
 301                                 th.principal = value;
 302                         }
 303                 }
 304
 305                 // Looks up the object associated with the current thread
 306                 // this is called by the JIT directly, too
 307                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 308                 private extern static InternalThread CurrentInternalThread_internal();
 309
 310                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 311                 internal extern static uint AllocTlsData (Type type);
 312
 313                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 314                 internal extern static void DestroyTlsData (uint offset);
 315
 316                 public static Thread CurrentThread {
 317                         [ReliabilityContract (Consistency.WillNotCorruptState, Cer.MayFail)]
 318                         get {
 319                                 if (current_thread == null)
 320                                         current_thread = new Thread (CurrentInternalThread_internal ());
 321                                 return current_thread;
 322                         }
 323                 }
 324
 325                 internal static int CurrentThreadId {
 326                         get {
 327                                 return (int)(CurrentThread.internal_thread.thread_id);
 328                         }
 329                 }
 330
 331                 static NamedDataSlot NamedDataSlot {
 332                         get {
 333                                 if (namedDataSlot == null)
 334                                         Interlocked.CompareExchange (ref namedDataSlot, new NamedDataSlot (), null);
 335
 336                                 return namedDataSlot;
 337                         }
 338                 }
 339
 340                 public static LocalDataStoreSlot AllocateNamedDataSlot (string name)
 341                 {
 342                         return NamedDataSlot.Allocate (name);
 343                 }
 344
 345                 public static void FreeNamedDataSlot (string name)
 346                 {
 347                         NamedDataSlot.Free (name);
 348                 }
 349
 350                 public static LocalDataStoreSlot AllocateDataSlot ()
 351                 {
 352                         return new LocalDataStoreSlot (true);
 353                 }
 354
 355                 public static object GetData (LocalDataStoreSlot slot) {
 356                         object[] slots = local_slots;
 357                         if (slot == null)
 358                                 throw new ArgumentNullException ("slot");
 359                         if (slots != null && slot.slot < slots.Length)
 360                                 return slots [slot.slot];
 361                         return null;
 362                 }
 363
 364                 public static void SetData (LocalDataStoreSlot slot, object data) {
 365                         object[] slots = local_slots;
 366                         if (slot == null)
 367                                 throw new ArgumentNullException ("slot");
 368                         if (slots == null) {
 369                                 slots = new object [slot.slot + 2];
 370                                 local_slots = slots;
 371                         } else if (slot.slot >= slots.Length) {
 372                                 object[] nslots = new object [slot.slot + 2];
 373                                 slots.CopyTo (nslots, 0);
 374                                 slots = nslots;
 375                                 local_slots = slots;
 376                         }
 377                         slots [slot.slot] = data;
 378                 }
 379
 380                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 381                 internal extern static void FreeLocalSlotValues (int slot, bool thread_local);
 382
 383                 public static LocalDataStoreSlot GetNamedDataSlot(string name)
 384                 {
 385                         return NamedDataSlot.Get (name);
 386                 }
 387
 388                 public static AppDomain GetDomain() {
 389                         return AppDomain.CurrentDomain;
 390                 }
 391
 392                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 393                 public extern static int GetDomainID();
 394
 395                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 396                 private extern static void ResetAbort_internal();
 397
 398                 [SecurityPermission (SecurityAction.Demand, ControlThread=true)]
 399                 public static void ResetAbort ()
 400                 {
 401                         ResetAbort_internal ();
 402                 }
 403
 404 #if NET_4_0
 405                 [HostProtectionAttribute (SecurityAction.LinkDemand, Synchronization = true, ExternalThreading = true)]
 406                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 407                 [ReliabilityContract (Consistency.WillNotCorruptState, Cer.Success)]
 408                 public extern static bool Yield ();
 409 #endif
 410
 411
 412                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 413                 private extern static void Sleep_internal(int ms);
 414
 415                 public static void Sleep (int millisecondsTimeout)
 416                 {
 417                         if (millisecondsTimeout < Timeout.Infinite)
 418                                 throw new ArgumentOutOfRangeException ("millisecondsTimeout", "Negative timeout");
 419
 420                         Sleep_internal (millisecondsTimeout);
 421                 }
 422
 423                 public static void Sleep (TimeSpan timeout)
 424                 {
 425                         long ms = (long) timeout.TotalMilliseconds;
 426                         if (ms < Timeout.Infinite || ms > Int32.MaxValue)
 427                                 throw new ArgumentOutOfRangeException ("timeout", "timeout out of range");
 428
 429                         Sleep_internal ((int) ms);
 430                 }
 431
 432                 // Returns the system thread handle
 433                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 434                 private extern IntPtr Thread_internal (MulticastDelegate start);
 435
 436                 public Thread(ThreadStart start) {
 437                         if(start==null) {
 438                                 throw new ArgumentNullException("Null ThreadStart");
 439                         }
 440                         threadstart=start;
 441                 }
 442
 443                 private Thread (InternalThread it) {
 444                         internal_thread = it;
 445                 }
 446
 447                 // part of ".NETPortable,Version=v4.0,Profile=Profile3" i.e. FX4 and SL4
 448                 [ReliabilityContract (Consistency.WillNotCorruptState, Cer.Success)]
 449                 ~Thread ()
 450                 {
 451                 }
 452
 453                 [Obsolete ("Deprecated in favor of GetApartmentState, SetApartmentState and TrySetApartmentState.")]
 454                 public ApartmentState ApartmentState {
 455                         get {
 456                                 if ((ThreadState & ThreadState.Stopped) != 0)
 457                                         throw new ThreadStateException ("Thread is dead; state can not be accessed.");
 458
 459                                 return (ApartmentState)Internal.apartment_state;
 460                         }
 461
 462                         set {
 463                                 TrySetApartmentState (value);
 464                         }
 465                 }
 466
 467                 //[MethodImplAttribute (MethodImplOptions.InternalCall)]
 468                 //private static extern int current_lcid ();
 469
 470                 public CultureInfo CurrentCulture {
 471                         get {
 472                                 CultureInfo culture = current_culture;
 473                                 if (culture != null)
 474                                         return culture;
 475
 476                                 current_culture = culture = CultureInfo.ConstructCurrentCulture ();
 477                                 return culture;
 478                         }
 479
 480                         [SecurityPermission (SecurityAction.Demand, ControlThread=true)]
 481                         set {
 482                                 if (value == null)
 483                                         throw new ArgumentNullException ("value");
 484
 485                                 value.CheckNeutral ();
 486                                 current_culture = value;
 487                         }
 488                 }
 489
 490                 public CultureInfo CurrentUICulture {
 491                         get {
 492                                 CultureInfo culture = current_ui_culture;
 493                                 if (culture != null)
 494                                         return culture;
 495
 496                                 current_ui_culture = culture = CultureInfo.ConstructCurrentUICulture ();
 497                                 return culture;
 498                         }
 499
 500                         set {
 501                                 if (value == null)
 502                                         throw new ArgumentNullException ("value");
 503                                 current_ui_culture = value;
 504                         }
 505                 }
 506
 507                 public bool IsThreadPoolThread {
 508                         get {
 509                                 return IsThreadPoolThreadInternal;
 510                         }
 511                 }
 512
 513                 internal bool IsThreadPoolThreadInternal {
 514                         get {
 515                                 return Internal.threadpool_thread;
 516                         }
 517                         set {
 518                                 Internal.threadpool_thread = value;
 519                         }
 520                 }
 521
 522                 public bool IsAlive {
 523                         get {
 524                                 ThreadState curstate = GetState (Internal);
 525
 526                                 if((curstate & ThreadState.Aborted) != 0 ||
 527                                    (curstate & ThreadState.Stopped) != 0 ||
 528                                    (curstate & ThreadState.Unstarted) != 0) {
 529                                         return(false);
 530                                 } else {
 531                                         return(true);
 532                                 }
 533                         }
 534                 }
 535
 536                 public bool IsBackground {
 537                         get {
 538                                 ThreadState thread_state = GetState (Internal);
 539                                 if ((thread_state & ThreadState.Stopped) != 0)
 540                                         throw new ThreadStateException ("Thread is dead; state can not be accessed.");
 541
 542                                 return (thread_state & ThreadState.Background) != 0;
 543                         }
 544
 545                         set {
 546                                 if (value) {
 547                                         SetState (Internal, ThreadState.Background);
 548                                 } else {
 549                                         ClrState (Internal, ThreadState.Background);
 550                                 }
 551                         }
 552                 }
 553
 554                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 555                 private extern static string GetName_internal (InternalThread thread);
 556
 557                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 558                 private extern static void SetName_internal (InternalThread thread, String name);
 559
 560                 /*
 561                  * The thread name must be shared by appdomains, so it is stored in
 562                  * unmanaged code.
 563                  */
 564
 565                 public string Name {
 566                         get {
 567                                 return GetName_internal (Internal);
 568                         }
 569
 570                         set {
 571                                 SetName_internal (Internal, value);
 572                         }
 573                 }
 574
 575                 public ThreadPriority Priority {
 576                         get {
 577                                 return(ThreadPriority.Lowest);
 578                         }
 579
 580                         set {
 581                                 // FIXME: Implement setter.
 582                         }
 583                 }
 584
 585                 public ThreadState ThreadState {
 586                         get {
 587                                 return GetState (Internal);
 588                         }
 589                 }
 590
 591                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 592                 private extern static void Abort_internal (InternalThread thread, object stateInfo);
 593
 594                 [SecurityPermission (SecurityAction.Demand, ControlThread=true)]
 595                 public void Abort ()
 596                 {
 597                         Abort_internal (Internal, null);
 598                 }
 599
 600                 [SecurityPermission (SecurityAction.Demand, ControlThread=true)]
 601                 public void Abort (object stateInfo)
 602                 {
 603                         Abort_internal (Internal, stateInfo);
 604                 }
 605
 606                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 607                 internal extern object GetAbortExceptionState ();
 608
 609                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 610                 private extern static void Interrupt_internal (InternalThread thread);
 611
 612                 [SecurityPermission (SecurityAction.Demand, ControlThread=true)]
 613                 public void Interrupt ()
 614                 {
 615                         Interrupt_internal (Internal);
 616                 }
 617
 618                 // The current thread joins with 'this'. Set ms to 0 to block
 619                 // until this actually exits.
 620                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 621                 private extern static bool Join_internal(InternalThread thread, int ms, IntPtr handle);
 622
 623                 public void Join()
 624                 {
 625                         Join_internal(Internal, Timeout.Infinite, Internal.system_thread_handle);
 626                 }
 627
 628                 public bool Join(int millisecondsTimeout)
 629                 {
 630                         if (millisecondsTimeout < Timeout.Infinite)
 631                                 throw new ArgumentOutOfRangeException ("millisecondsTimeout", "Timeout less than zero");
 632
 633                         return Join_internal (Internal, millisecondsTimeout, Internal.system_thread_handle);
 634                 }
 635
 636                 public bool Join(TimeSpan timeout)
 637                 {
 638                         long ms = (long) timeout.TotalMilliseconds;
 639                         if (ms < Timeout.Infinite || ms > Int32.MaxValue)
 640                                 throw new ArgumentOutOfRangeException ("timeout", "timeout out of range");
 641
 642                         return Join_internal (Internal, (int) ms, Internal.system_thread_handle);
 643                 }
 644
 645                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 646                 public extern static void MemoryBarrier ();
 647
 648                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 649                 private extern void Resume_internal();
 650
 651                 [Obsolete ("")]
 652                 [SecurityPermission (SecurityAction.Demand, ControlThread=true)]
 653                 public void Resume ()
 654                 {
 655                         Resume_internal ();
 656                 }
 657
 658                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 659                 private extern static void SpinWait_nop ();
 660
 661
 662                 [ReliabilityContractAttribute (Consistency.WillNotCorruptState, Cer.Success)]
 663                 public static void SpinWait (int iterations)
 664                 {
 665                         if (iterations < 0)
 666                                 return;
 667                         while (iterations-- > 0)
 668                         {
 669                                 SpinWait_nop ();
 670                         }
 671                 }
 672
 673                 private void StartInternal ()
 674                 {
 675                         current_thread = this;
 676
 677                         if (threadstart is ThreadStart) {
 678                                 ((ThreadStart) threadstart) ();
 679                         } else {
 680                                 ((ParameterizedThreadStart) threadstart) (start_obj);
 681                         }
 682                 }
 683
 684                 public void Start() {
 685                         // propagate informations from the original thread to the new thread
 686                         if (!ExecutionContext.IsFlowSuppressed ())
 687                                 ec_to_set = ExecutionContext.Capture ();
 688                         Internal._serialized_principal = CurrentThread.Internal._serialized_principal;
 689
 690                         // Thread_internal creates and starts the new thread,
 691                         if (Thread_internal((ThreadStart) StartInternal) == (IntPtr) 0)
 692                                 throw new SystemException ("Thread creation failed.");
 693                 }
 694
 695                 [MethodImplAttribute(MethodImplOptions.InternalCall)]
 696                 private extern static void Suspend_internal(InternalThread thread);
 697
 698                 [Obsolete ("")]
 699                 [SecurityPermission (SecurityAction.Demand, ControlThread=true)]
 700                 public void Suspend ()
 701                 {
 702                         Suspend_internal (Internal);
 703                 }
 704
 705                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 706                 extern private static void SetState (InternalThread thread, ThreadState set);
 707
 708                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 709                 extern private static void ClrState (InternalThread thread, ThreadState clr);
 710
 711                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 712                 extern private static ThreadState GetState (InternalThread thread);
 713
 714                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 715                 extern public static byte VolatileRead (ref byte address);
 716
 717                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 718                 extern public static double VolatileRead (ref double address);
 719
 720                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 721                 extern public static short VolatileRead (ref short address);
 722
 723                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 724                 extern public static int VolatileRead (ref int address);
 725
 726                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 727                 extern public static long VolatileRead (ref long address);
 728
 729                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 730                 extern public static IntPtr VolatileRead (ref IntPtr address);
 731
 732                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 733                 extern public static object VolatileRead (ref object address);
 734
 735                 [CLSCompliant(false)]
 736                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 737                 extern public static sbyte VolatileRead (ref sbyte address);
 738
 739                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 740                 extern public static float VolatileRead (ref float address);
 741
 742                 [CLSCompliant (false)]
 743                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 744                 extern public static ushort VolatileRead (ref ushort address);
 745
 746                 [CLSCompliant (false)]
 747                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 748                 extern public static uint VolatileRead (ref uint address);
 749
 750                 [CLSCompliant (false)]
 751                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 752                 extern public static ulong VolatileRead (ref ulong address);
 753
 754                 [CLSCompliant (false)]
 755                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 756                 extern public static UIntPtr VolatileRead (ref UIntPtr address);
 757
 758                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 759                 extern public static void VolatileWrite (ref byte address, byte value);
 760
 761                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 762                 extern public static void VolatileWrite (ref double address, double value);
 763
 764                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 765                 extern public static void VolatileWrite (ref short address, short value);
 766
 767                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 768                 extern public static void VolatileWrite (ref int address, int value);
 769
 770                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 771                 extern public static void VolatileWrite (ref long address, long value);
 772
 773                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 774                 extern public static void VolatileWrite (ref IntPtr address, IntPtr value);
 775
 776                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 777                 extern public static void VolatileWrite (ref object address, object value);
 778
 779                 [CLSCompliant(false)]
 780                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 781                 extern public static void VolatileWrite (ref sbyte address, sbyte value);
 782
 783                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 784                 extern public static void VolatileWrite (ref float address, float value);
 785
 786                 [CLSCompliant (false)]
 787                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 788                 extern public static void VolatileWrite (ref ushort address, ushort value);
 789
 790                 [CLSCompliant (false)]
 791                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 792                 extern public static void VolatileWrite (ref uint address, uint value);
 793
 794                 [CLSCompliant (false)]
 795                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 796                 extern public static void VolatileWrite (ref ulong address, ulong value);
 797
 798                 [CLSCompliant (false)]
 799                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
 800                 extern public static void VolatileWrite (ref UIntPtr address, UIntPtr value);
 801
 802
 803                 static int CheckStackSize (int maxStackSize)
 804                 {
 805                         if (maxStackSize < 0)
 806                                 throw new ArgumentOutOfRangeException ("less than zero", "maxStackSize");
 807
 808                         if (maxStackSize < 131072) // make sure stack is at least 128k big
 809                                 return 131072;
 810
 811                         int page_size = Environment.GetPageSize ();
 812
 813                         if ((maxStackSize % page_size) != 0) // round up to a divisible of page size
 814                                 maxStackSize = (maxStackSize / (page_size - 1)) * page_size;
 815
 816                         int default_stack_size = (IntPtr.Size / 4) * 1024 * 1024; // from wthreads.c
 817
 818                         if (maxStackSize > default_stack_size)
 819                                 return default_stack_size;
 820
 821                         return maxStackSize;
 822                 }
 823
 824                 public Thread (ThreadStart start, int maxStackSize)
 825                 {
 826                         if (start == null)
 827                                 throw new ArgumentNullException ("start");
 828
 829                         threadstart = start;
 830                         Internal.stack_size = CheckStackSize (maxStackSize);;
 831                 }
 832
 833                 public Thread (ParameterizedThreadStart start)
 834                 {
 835                         if (start == null)
 836                                 throw new ArgumentNullException ("start");
 837
 838                         threadstart = start;
 839                 }
 840
 841                 public Thread (ParameterizedThreadStart start, int maxStackSize)
 842                 {
 843                         if (start == null)
 844                                 throw new ArgumentNullException ("start");
 845
 846                         threadstart = start;
 847                         Internal.stack_size = CheckStackSize (maxStackSize);
 848                 }
 849
 850                 [MonoTODO ("limited to CompressedStack support")]
 851                 public ExecutionContext ExecutionContext {
 852                         [ReliabilityContract (Consistency.WillNotCorruptState, Cer.MayFail)]
 853                         get {
 854                                 if (_ec == null)
 855                                         _ec = new ExecutionContext ();
 856                                 return _ec;
 857                         }
 858                 }
 859
 860                 public int ManagedThreadId {
 861                         [ReliabilityContractAttribute (Consistency.WillNotCorruptState, Cer.Success)]
 862                         get {
 863                                 return Internal.managed_id;
 864                         }
 865                 }
 866
 867                 [ReliabilityContract (Consistency.WillNotCorruptState, Cer.MayFail)]
 868                 public static void BeginCriticalRegion ()
 869                 {
 870                         CurrentThread.Internal.critical_region_level++;
 871                 }
 872
 873                 [ReliabilityContract (Consistency.WillNotCorruptState, Cer.Success)]
 874                 public static void EndCriticalRegion ()
 875                 {
 876                         CurrentThread.Internal.critical_region_level--;
 877                 }
 878
 879                 [ReliabilityContractAttribute (Consistency.WillNotCorruptState, Cer.MayFail)]
 880                 public static void BeginThreadAffinity ()
 881                 {
 882                         // Managed and native threads are currently bound together.
 883                 }
 884
 885                 [ReliabilityContractAttribute (Consistency.WillNotCorruptState, Cer.MayFail)]
 886                 public static void EndThreadAffinity ()
 887                 {
 888                         // Managed and native threads are currently bound together.
 889                 }
 890
 891                 public ApartmentState GetApartmentState ()
 892                 {
 893                         return (ApartmentState)Internal.apartment_state;
 894                 }
 895
 896                 public void SetApartmentState (ApartmentState state)
 897                 {
 898                         if (!TrySetApartmentState (state))
 899                                 throw new InvalidOperationException ("Failed to set the specified COM apartment state.");
 900                 }
 901
 902                 public bool TrySetApartmentState (ApartmentState state)
 903                 {
 904                         if ((ThreadState & ThreadState.Unstarted) == 0)
 905                                 throw new ThreadStateException ("Thread was in an invalid state for the operation being executed.");
 906
 907                         if ((ApartmentState)Internal.apartment_state != ApartmentState.Unknown &&
 908                             (ApartmentState)Internal.apartment_state != state)
 909                                 return false;
 910
 911                         Internal.apartment_state = (byte)state;
 912
 913                         return true;
 914                 }
 915
 916                 [ComVisible (false)]
 917                 public override int GetHashCode ()
 918                 {
 919                         return ManagedThreadId;
 920                 }
 921
 922                 public void Start (object parameter)
 923                 {
 924                         start_obj = parameter;
 925                         Start ();
 926                 }
 927
 928                 // NOTE: This method doesn't show in the class library status page because
 929                 // it cannot be "found" with the StrongNameIdentityPermission for ECMA key.
 930                 // But it's there!
 931                 [SecurityPermission (SecurityAction.LinkDemand, UnmanagedCode = true)]
 932                 [StrongNameIdentityPermission (SecurityAction.LinkDemand, PublicKey="00000000000000000400000000000000")]
 933                 [Obsolete ("see CompressedStack class")]
 934                 public CompressedStack GetCompressedStack ()
 935                 {
 936 #if MOBILE
 937                         throw new NotSupportedException ();
 938 #else
 939                         // Note: returns null if no CompressedStack has been set.
 940                         // However CompressedStack.GetCompressedStack returns an
 941                         // (empty?) CompressedStack instance.
 942                         CompressedStack cs = ExecutionContext.SecurityContext.CompressedStack;
 943                         return ((cs == null) || cs.IsEmpty ()) ? null : cs.CreateCopy ();
 944 #endif
 945                 }
 946
 947                 // NOTE: This method doesn't show in the class library status page because
 948                 // it cannot be "found" with the StrongNameIdentityPermission for ECMA key.
 949                 // But it's there!
 950                 [SecurityPermission (SecurityAction.LinkDemand, UnmanagedCode = true)]
 951                 [StrongNameIdentityPermission (SecurityAction.LinkDemand, PublicKey="00000000000000000400000000000000")]
 952                 [Obsolete ("see CompressedStack class")]
 953                 public void SetCompressedStack (CompressedStack stack)
 954                 {
 955 #if MOBILE
 956                         throw new NotSupportedException ();
 957 #else
 958                         ExecutionContext.SecurityContext.CompressedStack = stack;
 959 #endif
 960                 }
 961
 962 #if !MOBILE
 963                 void _Thread.GetIDsOfNames ([In] ref Guid riid, IntPtr rgszNames, uint cNames, uint lcid, IntPtr rgDispId)
 964                 {
 965                         throw new NotImplementedException ();
 966                 }
 967
 968                 void _Thread.GetTypeInfo (uint iTInfo, uint lcid, IntPtr ppTInfo)
 969                 {
 970                         throw new NotImplementedException ();
 971                 }
 972
 973                 void _Thread.GetTypeInfoCount (out uint pcTInfo)
 974                 {
 975                         throw new NotImplementedException ();
 976                 }
 977
 978                 void _Thread.Invoke (uint dispIdMember, [In] ref Guid riid, uint lcid, short wFlags, IntPtr pDispParams,
 979                         IntPtr pVarResult, IntPtr pExcepInfo, IntPtr puArgErr)
 980                 {
 981                         throw new NotImplementedException ();
 982                 }
 983 #endif
 984         }
 985 }