text: /****************************************************************************
   * arch/or1k/src/common/up_pthread_start.c
   *
   * Licensed to the Apache Software Foundation (ASF) under one or more
   * contributor license agreements.  See the NOTICE file distributed with
   * this work for additional information regarding copyright ownership.  The
   * ASF licenses this file to you under the Apache License, Version 2.0 (the
   * "License"); you may not use this file except in compliance with the
   * License.  You may obtain a copy of the License at
   *
   *   http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
   * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
   * License for the specific language governing permissions and limitations
   * under the License.
   *
   ****************************************************************************/
  
  /****************************************************************************
   * Included Files
   ****************************************************************************/
  
  #include <nuttx/config.h>
  #include <pthread.h>
  #include <nuttx/arch.h>
  #include <assert.h>
  
  #include <arch/syscall.h>
  
  #include "up_internal.h"
  
  #if !defined(CONFIG_BUILD_FLAT) && defined(__KERNEL__) && \
      !defined(CONFIG_DISABLE_PTHREAD)
  
  /****************************************************************************
   * Public Functions
   ****************************************************************************/
  
  /****************************************************************************
   * Name: up_pthread_start
   *
   * Description:
   *   In this kernel mode build, this function will be called to execute a
   *   pthread in user-space.  When the pthread is first started, a kernel-mode
   *   stub will first run to perform some housekeeping functions.  This
   *   kernel-mode stub will then be called transfer control to the user-mode
   *   pthread.
   *
   *   Normally the a user-mode start-up stub will also execute before the
   *   pthread actually starts.  See libc/pthread/pthread_create.c
   *
   * Input Parameters:
   *   startup - The user-space pthread startup function
   *   entrypt - The user-space address of the pthread entry point
   *   arg     - Standard argument for the pthread entry point
   *
   * Returned Value:
   *   This function should not return.  It should call the user-mode start-up
   *   stub and that stub should call pthread_exit if/when the user pthread
   *   terminates.
   *
   ****************************************************************************/
  
  void up_pthread_start(pthread_startroutine_t entrypt, pthread_addr_t arg)
  {
    /* Let sys_call2() do all of the work */
  
    sinfo("entry %p arg %p\n", entrypt, arg);
  
    sys_call3(SYS_pthread_start, (uintptr_t)startup, (uintptr_t)entrypt,
              (uintptr_t)arg);
  
    PANIC();
  }
  
  #endif /* !CONFIG_BUILD_FLAT && __KERNEL__ && !CONFIG_DISABLE_PTHREAD */
  