Allow creating a NaClAppThread without creating a new host OS thread

src/trusted/service_runtime/nacl_app_thread.h

 /*
  * Copyright (c) 2012 The Native Client Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 /*
  * NaCl Server Runtime user thread state.
  */
 
@@ skipping 53 matching lines @@
   struct NaClMutex          mu;
 
   /*
    * The NaCl app that contains this thread.  The app must exist as
    * long as a thread is still alive.
    */
   struct NaClApp            *nap;
 
   int                       thread_num;  /* index into nap->threads */
 
-  struct NaClThread         thread;  /* low level thread representation */
+  /*
+   * If host_thread_is_defined is true, host_thread is initialized and
+   * owned by the NaClAppThread such that it will be freed by
+   * NaClAppThreadDelete().
+   *
+   * host_thread_is_defined may be false when running untrusted code
+   * on a borrowed host thread that was not created by
+   * NaClAppThreadSpawn().
+   */
+  int                       host_thread_is_defined;
+  struct NaClThread         host_thread;  /* low level thread representation */
 
   struct NaClMutex          suspend_mu;
   Atomic32                  suspend_state; /* enum NaClSuspendState */
   /*
    * suspended_registers contains the register state of the thread if
    * it has been suspended with save_registers=1 and if suspend_state
    * contains NACL_APP_THREAD_UNTRUSTED.  This is for use by the debug
    * stub.
    *
    * To save space, suspended_registers is allocated on demand.  It
@@ skipping 49 matching lines @@
    */
   uint32_t                  exception_flag;
 
   /*
    * The last generation this thread reported into the service runtime
    * Protected by mu
    */
   int                       dynamic_delete_generation;
 };
 
+void WINAPI NaClAppThreadLauncher(void *state);
+
 void NaClAppThreadTeardown(struct NaClAppThread *natp);
 
 /*
- * Low level initialization of thread, with validated values.  The
- * usr_entry and usr_stack_ptr values are directly used to initialize the
- * user register values; the sys_tls_base is the system address for
- * allocating a %gs thread descriptor block base.  The caller is
- * responsible for error checking: usr_entry is a valid entry point (0
- * mod N) and sys_tls_base is in the NaClApp's address space.
+ * NaClAppThreadMake() creates a NaClAppThread object without invoking
+ * untrusted code or creating a host thread.
+ *
+ * The usr_entry and usr_stack_ptr values are directly used to
+ * initialize the user register values.  The caller is responsible for
+ * error checking: usr_entry must be a valid entry point (0 mod N).
  */
 struct NaClAppThread *NaClAppThreadMake(struct NaClApp *nap,
                                         uintptr_t      usr_entry,
                                         uintptr_t      usr_stack_ptr,
                                         uint32_t       user_tls1,
                                         uint32_t       user_tls2) NACL_WUR;
 
+/*
+ * NaClAppThreadSpawn() creates a NaClAppThread and launches a host
+ * thread that invokes the given entry point in untrusted code.  This
+ * returns true on success, false on failure.
+ */
+int NaClAppThreadSpawn(struct NaClApp *nap,
+                       uintptr_t      usr_entry,
+                       uintptr_t      usr_stack_ptr,
+                       uint32_t       user_tls1,
+                       uint32_t       user_tls2) NACL_WUR;
+
 void NaClAppThreadDelete(struct NaClAppThread *natp);
 
 /*
  * This function can be called from the thread hosting the
  * NaClAppThread.  It can be used to switch between the states
  * NACL_APP_THREAD_TRUSTED and NACL_APP_THREAD_UNTRUSTED.
  */
 void NaClAppThreadSetSuspendState(struct NaClAppThread *natp,
                                   enum NaClSuspendState old_state,
                                   enum NaClSuspendState new_state);
 
 EXTERN_C_END
 
 #endif  /* NATIVE_CLIENT_SERVICE_RUNTIME_NACL_APP_THREAD_H__ */