source: trunk/kernel/syscalls/sys_thread_create.c @ 81

/*
 * sys_thread_create.c - creates a new user thread
 * 
 * Author     Alain Greiner (2016,2017)
 *
 * Copyright (c) UPMC Sorbonne Universites
 *
 * This file is part of ALMOS-MKH.
 *
 * ALMOS-MKH is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by
 * the Free Software Foundation; version 2.0 of the License.
 *
 * ALMOS-MKH is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with ALMOS-MKH; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 */

#include <kernel_config.h>
#include <hal_types.h>
#include <hal_uspace.h>
#include <printk.h>
#include <errno.h>
#include <core.h>
#include <cluster.h>
#include <list.h>
#include <xlist.h>
#include <thread.h>
#include <scheduler.h>
#include <kmem.h>
#include <process.h>
#include <spinlock.h>
#include <dqdt.h>
#include <rpc.h>


//////////////////////////////////////////////////////////////////////////////////////////
// This function implements the pthread_create system call
//////////////////////////////////////////////////////////////////////////////////////////
int sys_thread_create ( thread_t       * new_thread,    // [out] argument
                        pthread_attr_t * user_attr,     // [in] argument
                        void           * start_func,    // [in] argument
                        void           * start_arg )    // [in] argument
{
        pthread_attr_t   k_attr;           // copy of pthread attributes in kernel space
        thread_t       * parent;           // pointer on thread executing the pthread_create
    xptr_t           parent_xp;        // extended pointer on created thread
    thread_t       * child_ptr;        // pointer on created child thread
    xptr_t           child_xp;         // extended pointer on created thread
    trdid_t          trdid;            // created thread identifier
    process_t      * process;          // pointer on local process descriptor
    paddr_t          paddr;            // unused, required by vmm_v2p_translate()
    error_t          error;

        uint32_t         tm_start;
        uint32_t         tm_end;

        tm_start = hal_time_stamp();

    // get parent thead pointer, extended pointer, and process pointer
        parent     = CURRENT_THREAD;
    parent_xp  = XPTR( local_cxy , parent );    
        process    = parent->process;

    // check user_attr in user space 
    error = vmm_v2p_translate( false , user_attr , &paddr );

        if( error )
        {
                printk("\n[ERROR] in %s : user_attr unmapped\n", __FUNCTION__ );
                parent->errno = EINVAL;
        return -1;
        }

    // check start_func in user space 
    error = vmm_v2p_translate( false , start_func , &paddr );

        if( error )
        {
                printk("\n[ERROR] in %s : start_func unmapped\n", __FUNCTION__ );
                parent->errno = EINVAL;
        return -1;
        }

    // check start_arg in user space 
    if( start_arg != NULL ) error = vmm_v2p_translate( false , start_arg , &paddr );

        if( error )
        {
                printk("\n[ERROR] in %s : start_arg unmapped\n", __FUNCTION__ );
                parent->errno = EINVAL;
        return -1;
        }

    // copy user_attr structure from user space to kernel space
        hal_copy_from_uspace( &k_attr , user_attr , sizeof(pthread_attr_t) );

    // check/set "cxy" attribute
        if( k_attr.attributes & PT_ATTR_CLUSTER_DEFINED ) 
    {
        if( cluster_is_undefined( k_attr.cxy ) )
        {
                    printk("\n[ERROR] in %s : illegal target cluster attribute = %x\n",
                   __FUNCTION__ , k_attr.cxy );
                    parent->errno = EINVAL;
            return -1;
        } 
    }
    else
    {
        k_attr.cxy = dqdt_get_cluster_for_process();
    }

    // create the thread, using a RPC if required
    // this returns "error", "child", and "child_xp"
 
    if( k_attr.cxy == local_cxy )                         // target cluster is local 
    {

        // create thread in local cluster
        error = thread_user_create( process->pid,
                                    start_func,
                                    start_arg,
                                    &k_attr,
                                    &child_ptr );

        child_xp = XPTR( local_cxy , child_ptr );
    }
    else                                                 // target cluster is remote
    {
        rpc_thread_user_create_client( k_attr.cxy,
                                       process->pid,
                                       start_func,
                                       start_arg,
                                       &k_attr, 
                                       &child_xp, 
                                       &error );

        child_ptr = (thread_t *)GET_PTR( child_xp );
    }

    // check successful thread creation
    if( error ) 
    {
                printk("\n[ERROR] in %s : cannot create thread\n", __FUNCTION__ );
        return ENOMEM;
    }

    // returns trdid to user space 
    trdid = hal_remote_lw( XPTR( k_attr.cxy , &child_ptr->trdid ) );   
        hal_copy_to_uspace( new_thread , &trdid , sizeof(pthread_t) );
    
    // register new-thread in parent-thread children list if required
    if( (k_attr.attributes & PT_ATTR_DETACH) == 0 ) 
        thread_child_parent_link( parent_xp , child_xp );

        tm_end = hal_time_stamp();

        thread_dmsg("\n[INFO] %s created thread %x for process %x in cluster %x\n"
                "  start_cycle = %d / end_cycle = %d\n",
                   trdid , process->pid , k_attr.cxy , tm_start , tm_end );
        return 0;

}  // end sys_thread_create()