Context Navigation

source: trunk/kernel/kern/process.c @ 653

Last change on this file since 653 was 651, checked in by alain, 5 years ago
1) Improve the VMM MMAP allocator: implement the "buddy" algorithm to allocate only aligned blocks. 2) fix a bug in the pthread_join() / pthread_exit() mmechanism.
File size: 84.5 KB

Line
1	/*
2	* process.c - process related functions definition.
3	*
4	* Authors Ghassan Almaless (2008,2009,2010,2011,2012)
5	* Mohamed Lamine Karaoui (2015)
6	* Alain Greiner (2016,2017,2018,2019)
7	*
8	* Copyright (c) UPMC Sorbonne Universites
9	*
10	* This file is part of ALMOS-MKH.
11	*
12	* ALMOS-MKH is free software; you can redistribute it and/or modify it
13	* under the terms of the GNU General Public License as published by
14	* the Free Software Foundation; version 2.0 of the License.
15	*
16	* ALMOS-MKH is distributed in the hope that it will be useful, but
17	* WITHOUT ANY WARRANTY; without even the implied warranty of
18	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19	* General Public License for more details.
20	*
21	* You should have received a copy of the GNU General Public License
22	* along with ALMOS-MKH; if not, write to the Free Software Foundation,
23	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24	*/
25
26	#include <kernel_config.h>
27	#include <hal_kernel_types.h>
28	#include <hal_remote.h>
29	#include <hal_uspace.h>
30	#include <hal_irqmask.h>
31	#include <hal_vmm.h>
32	#include <errno.h>
33	#include <printk.h>
34	#include <memcpy.h>
35	#include <bits.h>
36	#include <kmem.h>
37	#include <page.h>
38	#include <vmm.h>
39	#include <vfs.h>
40	#include <core.h>
41	#include <thread.h>
42	#include <chdev.h>
43	#include <list.h>
44	#include <string.h>
45	#include <scheduler.h>
46	#include <busylock.h>
47	#include <queuelock.h>
48	#include <remote_queuelock.h>
49	#include <rwlock.h>
50	#include <remote_rwlock.h>
51	#include <dqdt.h>
52	#include <cluster.h>
53	#include <ppm.h>
54	#include <boot_info.h>
55	#include <process.h>
56	#include <elf.h>
57	#include <syscalls.h>
58	#include <shared_syscalls.h>
59
60	//////////////////////////////////////////////////////////////////////////////////////////
61	// Extern global variables
62	//////////////////////////////////////////////////////////////////////////////////////////
63
64	extern process_t process_zero; // allocated in kernel_init.c
65	extern chdev_directory_t chdev_dir; // allocated in kernel_init.c
66
67	//////////////////////////////////////////////////////////////////////////////////////////
68	// Process initialisation related functions
69	//////////////////////////////////////////////////////////////////////////////////////////
70
71	/////////////////////////////////
72	process_t * process_alloc( void )
73	{
74	kmem_req_t req;
75
76	req.type = KMEM_KCM;
77	req.order = bits_log2( sizeof(process_t) );
78	req.flags = AF_KERNEL;
79
80	return kmem_alloc( &req );
81	}
82
83	////////////////////////////////////////
84	void process_free( process_t * process )
85	{
86	kmem_req_t req;
87
88	req.type = KMEM_KCM;
89	req.ptr = process;
90	kmem_free( &req );
91	}
92
93	////////////////////////////////////////////////////
94	error_t process_reference_init( process_t * process,
95	pid_t pid,
96	xptr_t parent_xp )
97	{
98	error_t error;
99	xptr_t process_xp;
100	cxy_t parent_cxy;
101	process_t * parent_ptr;
102	xptr_t stdin_xp;
103	xptr_t stdout_xp;
104	xptr_t stderr_xp;
105	uint32_t stdin_id;
106	uint32_t stdout_id;
107	uint32_t stderr_id;
108	uint32_t txt_id;
109	char rx_path[40];
110	char tx_path[40];
111	xptr_t file_xp;
112	xptr_t chdev_xp;
113	chdev_t * chdev_ptr;
114	cxy_t chdev_cxy;
115	pid_t parent_pid;
116	vmm_t * vmm;
117
118	// build extended pointer on this reference process
119	process_xp = XPTR( local_cxy , process );
120
121	// get pointer on process vmm
122	vmm = &process->vmm;
123
124	// get parent process cluster and local pointer
125	parent_cxy = GET_CXY( parent_xp );
126	parent_ptr = GET_PTR( parent_xp );
127
128	// get parent_pid
129	parent_pid = hal_remote_l32( XPTR( parent_cxy , &parent_ptr->pid ) );
130
131	#if DEBUG_PROCESS_REFERENCE_INIT
132	thread_t * this = CURRENT_THREAD;
133	uint32_t cycle = (uint32_t)hal_get_cycles();
134	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
135	printk("\n[%s] thread[%x,%x] enter to initialize process %x / cycle %d\n",
136	__FUNCTION__, this->process->pid, this->trdid, pid, cycle );
137	#endif
138
139	// initialize pid, ref_xp, parent_xp, owner_xp, term_state fields
140	process->pid = pid;
141	process->ref_xp = XPTR( local_cxy , process );
142	process->owner_xp = XPTR( local_cxy , process );
143	process->parent_xp = parent_xp;
144	process->term_state = 0;
145
146	// initialize VFS root inode and CWD inode
147	process->vfs_root_xp = hal_remote_l64( XPTR( parent_cxy, &parent_ptr->vfs_root_xp ) );
148	process->cwd_xp = hal_remote_l64( XPTR( parent_cxy, &parent_ptr->cwd_xp ) );
149
150	// initialize VSL as empty
151	vmm->vsegs_nr = 0;
152	xlist_root_init( XPTR( local_cxy , &vmm->vsegs_root ) );
153
154	// create an empty GPT as required by the architecture
155	error = hal_gpt_create( &vmm->gpt );
156	if( error )
157	{
158	printk("\n[ERROR] in %s : cannot create empty GPT\n", __FUNCTION__ );
159	return -1;
160	}
161
162	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
163	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
164	printk("\n[%s] thread[%x,%x] created empty GPT for process %x\n",
165	__FUNCTION__, parent_pid, this->trdid, pid );
166	#endif
167
168	// initialize VSL lock
169	remote_rwlock_init( XPTR( local_cxy , &vmm->vsl_lock ) , LOCK_VMM_VSL );
170
171	// register kernel vsegs in user process VMM as required by the architecture
172	error = hal_vmm_kernel_update( process );
173	if( error )
174	{
175	printk("\n[ERROR] in %s : cannot register kernel vsegs in VMM\n", __FUNCTION__ );
176	return -1;
177	}
178
179	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
180	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
181	printk("\n[%s] thread[%x,%x] registered kernel vsegs in VSL for process %x\n",
182	__FUNCTION__, parent_pid, this->trdid, pid );
183	#endif
184
185	// create "args" and "envs" vsegs
186	// create "stacks" and "mmap" vsegs allocators
187	// initialize locks protecting GPT and VSL
188	error = vmm_user_init( process );
189	if( error )
190	{
191	printk("\n[ERROR] in %s : cannot register user vsegs in VMM\n", __FUNCTION__ );
192	return -1;
193	}
194
195	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
196	cycle = (uint32_t)hal_get_cycles();
197	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
198	printk("\n[%s] thread[%x,%x] initialized vmm for process %x\n",
199	__FUNCTION__, parent_pid, this->trdid, pid );
200	#endif
201
202	// initialize fd_array as empty
203	process_fd_init( process );
204
205	// define the stdin/stdout/stderr pseudo files <=> select a TXT terminal.
206	if( (pid == 1) \|\| (parent_pid == 1) ) // INIT or KSH process
207	{
208	// select a TXT channel
209	if( pid == 1 ) txt_id = 0; // INIT
210	else txt_id = process_txt_alloc(); // KSH
211
212	// attach process to TXT
213	process_txt_attach( process , txt_id );
214
215	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
216	cycle = (uint32_t)hal_get_cycles();
217	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
218	printk("\n[%s] thread[%x,%x] / process %x attached to TXT%d / cycle %d\n",
219	__FUNCTION__, parent_pid, this->trdid, pid, txt_id, cycle );
220	#endif
221	// build path to TXT_RX[i] and TXT_TX[i] chdevs
222	snprintf( rx_path , 40 , "/dev/external/txt%d_rx", txt_id );
223	snprintf( tx_path , 40 , "/dev/external/txt%d_tx", txt_id );
224
225	// create stdin pseudo file
226	error = vfs_open( process->vfs_root_xp,
227	rx_path,
228	process_xp,
229	O_RDONLY,
230	0, // FIXME chmod
231	&stdin_xp,
232	&stdin_id );
233	if( error )
234	{
235	printk("\n[ERROR] in %s : cannot open stdout pseudo-file\n", __FUNCTION__ );
236	return -1;
237	}
238
239	assert( (stdin_id == 0) , "stdin index must be 0" );
240
241	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
242	cycle = (uint32_t)hal_get_cycles();
243	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
244	printk("\n[%s] thread[%x,%x] / stdin open for process %x / cycle %d\n",
245	__FUNCTION__, parent_pid, this->trdid, pid, cycle );
246	#endif
247
248	// create stdout pseudo file
249	error = vfs_open( process->vfs_root_xp,
250	tx_path,
251	process_xp,
252	O_WRONLY,
253	0, // FIXME chmod
254	&stdout_xp,
255	&stdout_id );
256	if( error )
257	{
258	printk("\n[ERROR] in %s : cannot open stdout pseudo-file\n", __FUNCTION__ );
259	return -1;
260	}
261
262	assert( (stdout_id == 1) , "stdout index must be 1" );
263
264	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
265	cycle = (uint32_t)hal_get_cycles();
266	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
267	printk("\n[%s] thread[%x,%x] / stdout open for process %x / cycle %d\n",
268	__FUNCTION__, parent_pid, this->trdid, pid, cycle );
269	#endif
270
271	// create stderr pseudo file
272	error = vfs_open( process->vfs_root_xp,
273	tx_path,
274	process_xp,
275	O_WRONLY,
276	0, // FIXME chmod
277	&stderr_xp,
278	&stderr_id );
279	if( error )
280	{
281	printk("\n[ERROR] in %s : cannot open stderr pseudo-file\n", __FUNCTION__ );
282	return -1;
283	}
284
285	assert( (stderr_id == 2) , "stderr index must be 2" );
286
287	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
288	cycle = (uint32_t)hal_get_cycles();
289	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
290	printk("\n[%s] thread[%x,%x] / stderr open for process %x / cycle %d\n",
291	__FUNCTION__, parent_pid, this->trdid, pid, cycle );
292	#endif
293
294	}
295	else // normal user process
296	{
297	// get extended pointer on stdin pseudo file in parent process
298	file_xp = (xptr_t)hal_remote_l64( XPTR( parent_cxy,
299	&parent_ptr->fd_array.array[0] ) );
300
301	// get extended pointer on parent process TXT chdev
302	chdev_xp = chdev_from_file( file_xp );
303
304	// get cluster and local pointer on chdev
305	chdev_cxy = GET_CXY( chdev_xp );
306	chdev_ptr = GET_PTR( chdev_xp );
307
308	// get parent process TXT terminal index
309	txt_id = hal_remote_l32( XPTR( chdev_cxy , &chdev_ptr->channel ) );
310
311	// attach child process to parent process TXT terminal
312	process_txt_attach( process , txt_id );
313
314	// copy all open files from parent process fd_array to this process
315	process_fd_remote_copy( XPTR( local_cxy , &process->fd_array ),
316	XPTR( parent_cxy , &parent_ptr->fd_array ) );
317	}
318
319	// initialize lock protecting CWD changes
320	remote_busylock_init( XPTR( local_cxy ,
321	&process->cwd_lock ), LOCK_PROCESS_CWD );
322
323	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
324	cycle = (uint32_t)hal_get_cycles();
325	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
326	printk("\n[%s] thread[%x,%x] / set fd_array for process %x / cycle %d\n",
327	__FUNCTION__, parent_pid, this->trdid, pid , cycle );
328	#endif
329
330	// reset children list root
331	xlist_root_init( XPTR( local_cxy , &process->children_root ) );
332	process->children_nr = 0;
333	remote_queuelock_init( XPTR( local_cxy,
334	&process->children_lock ), LOCK_PROCESS_CHILDREN );
335
336	// reset semaphore / mutex / barrier / condvar list roots and lock
337	xlist_root_init( XPTR( local_cxy , &process->sem_root ) );
338	xlist_root_init( XPTR( local_cxy , &process->mutex_root ) );
339	xlist_root_init( XPTR( local_cxy , &process->barrier_root ) );
340	xlist_root_init( XPTR( local_cxy , &process->condvar_root ) );
341	remote_queuelock_init( XPTR( local_cxy ,
342	&process->sync_lock ), LOCK_PROCESS_USERSYNC );
343
344	// reset open directories root and lock
345	xlist_root_init( XPTR( local_cxy , &process->dir_root ) );
346	remote_queuelock_init( XPTR( local_cxy ,
347	&process->dir_lock ), LOCK_PROCESS_DIR );
348
349	// register new process in the local cluster manager pref_tbl[]
350	lpid_t lpid = LPID_FROM_PID( pid );
351	LOCAL_CLUSTER->pmgr.pref_tbl[lpid] = XPTR( local_cxy , process );
352
353	// register new process descriptor in local cluster manager local_list
354	cluster_process_local_link( process );
355
356	// register new process descriptor in local cluster manager copies_list
357	cluster_process_copies_link( process );
358
359	// initialize th_tbl[] array and associated threads
360	uint32_t i;
361
362	for( i = 0 ; i < CONFIG_THREADS_MAX_PER_CLUSTER ; i++ )
363	{
364	process->th_tbl[i] = NULL;
365	}
366	process->th_nr = 0;
367	rwlock_init( &process->th_lock , LOCK_PROCESS_THTBL );
368
369	hal_fence();
370
371	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
372	cycle = (uint32_t)hal_get_cycles();
373	if( DEBUG_PROCESS_REFERENCE_INIT < cycle )
374	printk("\n[%s] thread[%x,%x] exit for process %x / cycle %d\n",
375	__FUNCTION__, parent_pid, this->trdid, pid, cycle );
376	#endif
377
378	#if (DEBUG_PROCESS_REFERENCE_INIT & 1)
379	hal_vmm_display( parent_xp , false );
380	hal_vmm_display( XPTR( local_cxy , process ) , false );
381	#endif
382
383	return 0;
384
385	} // process_reference_init()
386
387	/////////////////////////////////////////////////////
388	error_t process_copy_init( process_t * local_process,
389	xptr_t reference_process_xp )
390	{
391	error_t error;
392	vmm_t * vmm;
393
394	// get reference process cluster and local pointer
395	cxy_t ref_cxy = GET_CXY( reference_process_xp );
396	process_t * ref_ptr = GET_PTR( reference_process_xp );
397
398	// get pointer on process vmm
399	vmm = &local_process->vmm;
400
401	// initialize PID, REF_XP, PARENT_XP, and STATE
402	local_process->pid = hal_remote_l32( XPTR( ref_cxy , &ref_ptr->pid ) );
403	local_process->parent_xp = hal_remote_l64( XPTR( ref_cxy , &ref_ptr->parent_xp ) );
404	local_process->ref_xp = reference_process_xp;
405	local_process->owner_xp = reference_process_xp;
406	local_process->term_state = 0;
407
408	#if DEBUG_PROCESS_COPY_INIT
409	thread_t * this = CURRENT_THREAD;
410	uint32_t cycle = (uint32_t)hal_get_cycles();
411	if( DEBUG_PROCESS_COPY_INIT < cycle )
412	printk("\n[%s] thread[%x,%x] enter for process %x / cycle %d\n",
413	__FUNCTION__, this->process->pid, this->trdid, local_process->pid, cycle );
414	#endif
415
416	// check user process
417	assert( (local_process->pid != 0), "LPID cannot be 0" );
418
419	// initialize VSL as empty
420	vmm->vsegs_nr = 0;
421	xlist_root_init( XPTR( local_cxy , &vmm->vsegs_root ) );
422
423	// create an empty GPT as required by the architecture
424	error = hal_gpt_create( &vmm->gpt );
425	if( error )
426	{
427	printk("\n[ERROR] in %s : cannot create empty GPT\n", __FUNCTION__ );
428	return -1;
429	}
430
431	// initialize GPT and VSL locks
432	remote_rwlock_init( XPTR( local_cxy , &vmm->vsl_lock ) , LOCK_VMM_VSL );
433
434	// register kernel vsegs in VMM as required by the architecture
435	error = hal_vmm_kernel_update( local_process );
436	if( error )
437	{
438	printk("\n[ERROR] in %s : cannot register kernel vsegs in VMM\n", __FUNCTION__ );
439	return -1;
440	}
441
442	// create "args" and "envs" vsegs
443	// create "stacks" and "mmap" vsegs allocators
444	// initialize locks protecting GPT and VSL
445	error = vmm_user_init( local_process );
446	if( error )
447	{
448	printk("\n[ERROR] in %s : cannot register user vsegs in VMM\n", __FUNCTION__ );
449	return -1;
450	}
451
452	#if (DEBUG_PROCESS_COPY_INIT & 1)
453	cycle = (uint32_t)hal_get_cycles();
454	if( DEBUG_PROCESS_COPY_INIT < cycle )
455	printk("\n[%s] thread[%x,%x] initialized vmm for process %x / cycle %d\n",
456	__FUNCTION__, parent_pid, this->trdid, pid, cycle );
457	#endif
458
459	// set process file descriptors array
460	process_fd_init( local_process );
461
462	// set vfs_root_xp / vfs_bin_xp / cwd_xp fields
463	local_process->vfs_root_xp = hal_remote_l64( XPTR( ref_cxy , &ref_ptr->vfs_root_xp ) );
464	local_process->vfs_bin_xp = hal_remote_l64( XPTR( ref_cxy , &ref_ptr->vfs_bin_xp ) );
465	local_process->cwd_xp = XPTR_NULL;
466
467	// reset children list root (not used in a process descriptor copy)
468	xlist_root_init( XPTR( local_cxy , &local_process->children_root ) );
469	local_process->children_nr = 0;
470	remote_queuelock_init( XPTR( local_cxy , &local_process->children_lock ),
471	LOCK_PROCESS_CHILDREN );
472
473	// reset children_list (not used in a process descriptor copy)
474	xlist_entry_init( XPTR( local_cxy , &local_process->children_list ) );
475
476	// reset semaphores list root (not used in a process descriptor copy)
477	xlist_root_init( XPTR( local_cxy , &local_process->sem_root ) );
478	xlist_root_init( XPTR( local_cxy , &local_process->mutex_root ) );
479	xlist_root_init( XPTR( local_cxy , &local_process->barrier_root ) );
480	xlist_root_init( XPTR( local_cxy , &local_process->condvar_root ) );
481
482	// initialize th_tbl[] array and associated fields
483	uint32_t i;
484	for( i = 0 ; i < CONFIG_THREADS_MAX_PER_CLUSTER ; i++ )
485	{
486	local_process->th_tbl[i] = NULL;
487	}
488	local_process->th_nr = 0;
489	rwlock_init( &local_process->th_lock , LOCK_PROCESS_THTBL );
490
491	// register new process descriptor in local cluster manager local_list
492	cluster_process_local_link( local_process );
493
494	// register new process descriptor in owner cluster manager copies_list
495	cluster_process_copies_link( local_process );
496
497	hal_fence();
498
499	#if DEBUG_PROCESS_COPY_INIT
500	cycle = (uint32_t)hal_get_cycles();
501	if( DEBUG_PROCESS_COPY_INIT < cycle )
502	printk("\n[%s] thread[%x,%x] exit for process %x / cycle %d\n",
503	__FUNCTION__, this->process->pid, this->trdid, local_process->pid, cycle );
504	#endif
505
506	return 0;
507
508	} // end process_copy_init()
509
510	///////////////////////////////////////////
511	void process_destroy( process_t * process )
512	{
513	xptr_t parent_xp;
514	process_t * parent_ptr;
515	cxy_t parent_cxy;
516	xptr_t children_lock_xp;
517	xptr_t children_nr_xp;
518
519	pid_t pid = process->pid;
520
521	// check no more threads
522	assert( (process->th_nr == 0),
523	"process %x in cluster %x contains threads", pid , local_cxy );
524
525	#if DEBUG_PROCESS_DESTROY
526	thread_t * this = CURRENT_THREAD;
527	uint32_t cycle = (uint32_t)hal_get_cycles();
528	if( DEBUG_PROCESS_DESTROY < cycle )
529	printk("\n[%s] thread[%x,%x] enter for process %x in cluster %x / cycle %d\n",
530	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy, cycle );
531	#endif
532
533	// Destroy VMM
534	vmm_destroy( process );
535
536	#if (DEBUG_PROCESS_DESTROY & 1)
537	if( DEBUG_PROCESS_DESTROY < cycle )
538	printk("\n[%s] thread[%x,%x] destroyed VMM for process %x in cluster %x\n",
539	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy );
540	#endif
541
542	// remove process from local_list in local cluster manager
543	cluster_process_local_unlink( process );
544
545	#if (DEBUG_PROCESS_DESTROY & 1)
546	if( DEBUG_PROCESS_DESTROY < cycle )
547	printk("\n[%s] thread[%x,%x] removed process %x in cluster %x from local list\n",
548	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy );
549	#endif
550
551	// remove process from copies_list in owner cluster manager
552	cluster_process_copies_unlink( process );
553
554	#if (DEBUG_PROCESS_DESTROY & 1)
555	if( DEBUG_PROCESS_DESTROY < cycle )
556	printk("\n[%s] thread[%x,%x] removed process %x in cluster %x from copies list\n",
557	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy );
558	#endif
559
560	// when target process cluster is the owner cluster
561	// - remove process from TXT list and transfer ownership
562	// - remove process from children_list
563	// - release PID
564	if( CXY_FROM_PID( pid ) == local_cxy )
565	{
566	process_txt_detach( XPTR( local_cxy , process ) );
567
568	#if (DEBUG_PROCESS_DESTROY & 1)
569	if( DEBUG_PROCESS_DESTROY < cycle )
570	printk("\n[%s] thread[%x,%x] removed process %x from TXT list\n",
571	__FUNCTION__, this->process->pid, this->trdid, pid );
572	#endif
573
574	// get pointers on parent process
575	parent_xp = process->parent_xp;
576	parent_cxy = GET_CXY( parent_xp );
577	parent_ptr = GET_PTR( parent_xp );
578
579	// get extended pointer on children_lock in parent process
580	children_lock_xp = XPTR( parent_cxy , &parent_ptr->children_lock );
581	children_nr_xp = XPTR( parent_cxy , &parent_ptr->children_nr );
582
583	// remove process from children_list
584	remote_queuelock_acquire( children_lock_xp );
585	xlist_unlink( XPTR( local_cxy , &process->children_list ) );
586	hal_remote_atomic_add( children_nr_xp , -1 );
587	remote_queuelock_release( children_lock_xp );
588
589	#if (DEBUG_PROCESS_DESTROY & 1)
590	if( DEBUG_PROCESS_DESTROY < cycle )
591	printk("\n[%s] thread[%x,%x] removed process %x from parent process children list\n",
592	__FUNCTION__, this->process->pid, this->trdid, pid );
593	#endif
594
595	// release the process PID to cluster manager
596	cluster_pid_release( pid );
597
598	#if (DEBUG_PROCESS_DESTROY & 1)
599	if( DEBUG_PROCESS_DESTROY < cycle )
600	printk("\n[%s] thread[%x,%x] released process PID %x to pmgr in cluster %x\n",
601	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy );
602	#endif
603
604	}
605
606	// FIXME decrement the refcount on file pointer for vfs_bin_xp [AG]
607
608	// FIXME close all open files [AG]
609
610	// FIXME synchronize dirty files [AG]
611
612	// release memory allocated to process descriptor
613	process_free( process );
614
615	#if DEBUG_PROCESS_DESTROY
616	cycle = (uint32_t)hal_get_cycles();
617	if( DEBUG_PROCESS_DESTROY < cycle )
618	printk("\n[%s] thread[%x,%x] exit / process %x in cluster %x / cycle %d\n",
619	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy, cycle );
620	#endif
621
622	} // end process_destroy()
623
624	///////////////////////////////////////////////////////////////////
625	const char * process_action_str( process_sigactions_t action_type )
626	{
627	switch ( action_type )
628	{
629	case BLOCK_ALL_THREADS: return "BLOCK";
630	case UNBLOCK_ALL_THREADS: return "UNBLOCK";
631	case DELETE_ALL_THREADS: return "DELETE";
632	default: return "undefined";
633	}
634	}
635
636	////////////////////////////////////////
637	void process_sigaction( pid_t pid,
638	uint32_t type )
639	{
640	cxy_t owner_cxy; // owner cluster identifier
641	lpid_t lpid; // process index in owner cluster
642	cluster_t * cluster; // pointer on cluster manager
643	xptr_t root_xp; // extended pointer on root of copies
644	xptr_t lock_xp; // extended pointer on lock protecting copies
645	xptr_t iter_xp; // iterator on copies list
646	xptr_t process_xp; // extended pointer on process copy
647	cxy_t process_cxy; // process copy cluster identifier
648	process_t * process_ptr; // local pointer on process copy
649	reg_t save_sr; // for critical section
650	thread_t * client; // pointer on client thread
651	xptr_t client_xp; // extended pointer on client thread
652	process_t * local; // pointer on process copy in local cluster
653	uint32_t remote_nr; // number of remote process copies
654	rpc_desc_t rpc; // shared RPC descriptor
655	uint32_t responses; // shared RPC responses counter
656
657	client = CURRENT_THREAD;
658	client_xp = XPTR( local_cxy , client );
659	local = NULL;
660	remote_nr = 0;
661
662	// check calling thread can yield
663	thread_assert_can_yield( client , __FUNCTION__ );
664
665	#if DEBUG_PROCESS_SIGACTION
666	uint32_t cycle = (uint32_t)hal_get_cycles();
667	if( DEBUG_PROCESS_SIGACTION < cycle )
668	printk("\n[%s] thread[%x,%x] enter to %s process %x / cycle %d\n",
669	__FUNCTION__ , client->process->pid, client->trdid,
670	process_action_str( type ) , pid , cycle );
671	#endif
672
673	// get pointer on local cluster manager
674	cluster = LOCAL_CLUSTER;
675
676	// get owner cluster identifier and process lpid
677	owner_cxy = CXY_FROM_PID( pid );
678	lpid = LPID_FROM_PID( pid );
679
680	// get root of list of copies and lock from owner cluster
681	root_xp = XPTR( owner_cxy , &cluster->pmgr.copies_root[lpid] );
682	lock_xp = XPTR( owner_cxy , &cluster->pmgr.copies_lock[lpid] );
683
684	// check action type
685	assert( ((type == DELETE_ALL_THREADS ) \|\|
686	(type == BLOCK_ALL_THREADS ) \|\|
687	(type == UNBLOCK_ALL_THREADS )), "illegal action type" );
688
689	// This client thread send parallel RPCs to all remote clusters containing
690	// target process copies, wait all responses, and then handles directly
691	// the threads in local cluster, when required.
692	// The client thread allocates a - shared - RPC descriptor in the stack,
693	// because all parallel, non-blocking, server threads use the same input
694	// arguments, and use the shared RPC response field
695
696	// mask IRQs
697	hal_disable_irq( &save_sr);
698
699	// client thread blocks itself
700	thread_block( client_xp , THREAD_BLOCKED_RPC );
701
702	// initialize RPC responses counter
703	responses = 0;
704
705	// initialize shared RPC descriptor
706	// can be shared, because no out arguments
707	rpc.rsp = &responses;
708	rpc.blocking = false;
709	rpc.index = RPC_PROCESS_SIGACTION;
710	rpc.thread = client;
711	rpc.lid = client->core->lid;
712	rpc.args[0] = pid;
713	rpc.args[1] = type;
714
715	// take the lock protecting process copies
716	remote_queuelock_acquire( lock_xp );
717
718	// scan list of process copies
719	XLIST_FOREACH( root_xp , iter_xp )
720	{
721	// get extended pointers and cluster on process
722	process_xp = XLIST_ELEMENT( iter_xp , process_t , copies_list );
723	process_cxy = GET_CXY( process_xp );
724	process_ptr = GET_PTR( process_xp );
725
726	if( process_cxy == local_cxy ) // process copy is local
727	{
728	local = process_ptr;
729	}
730	else // process copy is remote
731	{
732	// update number of remote process copies
733	remote_nr++;
734
735	// atomically increment RPC responses counter
736	hal_atomic_add( &responses , 1 );
737
738	#if DEBUG_PROCESS_SIGACTION
739	if( DEBUG_PROCESS_SIGACTION < cycle )
740	printk("\n[%s] thread[%x,%x] send RPC to cluster %x for process %x\n",
741	__FUNCTION__, client->process->pid, client->trdid, process_cxy, pid );
742	#endif
743	// call RPC in target cluster
744	rpc_send( process_cxy , &rpc );
745	}
746	} // end list of copies
747
748	// release the lock protecting process copies
749	remote_queuelock_release( lock_xp );
750
751	// restore IRQs
752	hal_restore_irq( save_sr);
753
754	// - if there is remote process copies, the client thread deschedules,
755	// (it will be unblocked by the last RPC server thread).
756	// - if there is no remote copies, the client thread unblock itself.
757	if( remote_nr )
758	{
759	sched_yield("blocked on rpc_process_sigaction");
760	}
761	else
762	{
763	thread_unblock( client_xp , THREAD_BLOCKED_RPC );
764	}
765
766	// handle the local process copy if required
767	if( local != NULL )
768	{
769
770	#if DEBUG_PROCESS_SIGACTION
771	if( DEBUG_PROCESS_SIGACTION < cycle )
772	printk("\n[%s] thread[%x,%x] handles local process %x in cluster %x\n",
773	__FUNCTION__, client->process->pid, client->trdid, pid , local_cxy );
774	#endif
775	if (type == DELETE_ALL_THREADS ) process_delete_threads ( local , client_xp );
776	else if(type == BLOCK_ALL_THREADS ) process_block_threads ( local );
777	else if(type == UNBLOCK_ALL_THREADS ) process_unblock_threads( local );
778	}
779
780	#if DEBUG_PROCESS_SIGACTION
781	cycle = (uint32_t)hal_get_cycles();
782	if( DEBUG_PROCESS_SIGACTION < cycle )
783	printk("\n[%s] thread[%x,%x] exit after %s process %x / cycle %d\n",
784	__FUNCTION__, client->process->pid, client->trdid,
785	process_action_str( type ), pid, cycle );
786	#endif
787
788	} // end process_sigaction()
789
790	/////////////////////////////////////////////////
791	void process_block_threads( process_t * process )
792	{
793	thread_t * target; // pointer on target thread
794	thread_t * this; // pointer on calling thread
795	uint32_t ltid; // index in process th_tbl[]
796	uint32_t count; // requests counter
797	volatile uint32_t ack_count; // acknowledges counter
798
799	// get calling thread pointer
800	this = CURRENT_THREAD;
801
802	#if DEBUG_PROCESS_SIGACTION
803	pid_t pid = process->pid;
804	uint32_t cycle = (uint32_t)hal_get_cycles();
805	if( DEBUG_PROCESS_SIGACTION < cycle )
806	printk("\n[%s] thread[%x,%x] enter for process %x in cluster %x / cycle %d\n",
807	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy , cycle );
808	#endif
809
810	// check target process is an user process
811	assert( (LPID_FROM_PID( process->pid ) != 0 ),
812	"process %x is not an user process\n", process->pid );
813
814	// get lock protecting process th_tbl[]
815	rwlock_rd_acquire( &process->th_lock );
816
817	// loop on target process local threads
818	// we use both "ltid" and "count" because it can exist "holes" in th_tbl
819	// - if the calling thread and the target thread are not running on the same
820	// core, we ask the target scheduler to acknowlege the blocking
821	// to be sure that the target thread is not running.
822	// - if the calling thread and the target thread are running on the same core,
823	// we don't need confirmation from scheduler.
824
825	for( ltid = 0 , count = 0 , ack_count = 0 ; count < process->th_nr ; ltid++ )
826	{
827	target = process->th_tbl[ltid];
828
829	if( target != NULL ) // thread exist
830	{
831	count++;
832
833	// set the global blocked bit in target thread descriptor.
834	thread_block( XPTR( local_cxy , target ) , THREAD_BLOCKED_GLOBAL );
835
836	if( this->core->lid != target->core->lid )
837	{
838	// increment responses counter
839	hal_atomic_add( (void*)&ack_count , 1 );
840
841	// set FLAG_REQ_ACK and &ack_rsp_count in target descriptor
842	thread_set_req_ack( target , (uint32_t *)&ack_count );
843
844	// force scheduling on target thread
845	dev_pic_send_ipi( local_cxy , target->core->lid );
846	}
847	}
848	}
849
850	// release lock protecting process th_tbl[]
851	rwlock_rd_release( &process->th_lock );
852
853	// wait other threads acknowledges TODO this could be improved...
854	while( 1 )
855	{
856	// exit when all scheduler acknowledges received
857	if ( ack_count == 0 ) break;
858
859	// wait 1000 cycles before retry
860	hal_fixed_delay( 1000 );
861	}
862
863	#if DEBUG_PROCESS_SIGACTION
864	cycle = (uint32_t)hal_get_cycles();
865	if( DEBUG_PROCESS_SIGACTION < cycle )
866	printk("\n[%s] thread[%x,%x] exit for process %x in cluster %x / cycle %d\n",
867	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy , cycle );
868	#endif
869
870	} // end process_block_threads()
871
872	/////////////////////////////////////////////////
873	void process_delete_threads( process_t * process,
874	xptr_t client_xp )
875	{
876	thread_t * target; // local pointer on target thread
877	xptr_t target_xp; // extended pointer on target thread
878	cxy_t owner_cxy; // owner process cluster
879	uint32_t ltid; // index in process th_tbl
880	uint32_t count; // threads counter
881
882	// get calling thread pointer
883
884	// get target process owner cluster
885	owner_cxy = CXY_FROM_PID( process->pid );
886
887	#if DEBUG_PROCESS_SIGACTION
888	thread_t * this = CURRENT_THREAD;
889	uint32_t cycle = (uint32_t)hal_get_cycles();
890	if( DEBUG_PROCESS_SIGACTION < cycle )
891	printk("\n[%s] thread[%x,%x] enter for process %x n cluster %x / cycle %d\n",
892	__FUNCTION__, this->process->pid, this->trdid, process->pid, local_cxy, cycle );
893	#endif
894
895	// check target process is an user process
896	assert( (LPID_FROM_PID( process->pid ) != 0),
897	"process %x is not an user process\n", process->pid );
898
899	// get lock protecting process th_tbl[]
900	rwlock_wr_acquire( &process->th_lock );
901
902	// loop on target process local threads
903	// we use both "ltid" and "count" because it can exist "holes" in th_tbl
904	for( ltid = 0 , count = 0 ; count < process->th_nr ; ltid++ )
905	{
906	target = process->th_tbl[ltid];
907
908	if( target != NULL ) // valid thread
909	{
910	count++;
911	target_xp = XPTR( local_cxy , target );
912
913	// main thread and client thread should not be deleted
914	if( ((ltid != 0) \|\| (owner_cxy != local_cxy)) && // not main thread
915	(client_xp) != target_xp ) // not client thread
916	{
917	// mark target thread for delete and block it
918	thread_delete( target_xp , true ); // forced
919	}
920	}
921	}
922
923	// release lock protecting process th_tbl[]
924	rwlock_wr_release( &process->th_lock );
925
926	#if DEBUG_PROCESS_SIGACTION
927	cycle = (uint32_t)hal_get_cycles();
928	if( DEBUG_PROCESS_SIGACTION < cycle )
929	printk("\n[%s] thread[%x,%x] exit for process %x in cluster %x / cycle %d\n",
930	__FUNCTION__, this->process->pid, this->trdid, process->pid, local_cxy , cycle );
931	#endif
932
933	} // end process_delete_threads()
934
935	///////////////////////////////////////////////////
936	void process_unblock_threads( process_t * process )
937	{
938	thread_t * target; // pointer on target thead
939	uint32_t ltid; // index in process th_tbl
940	uint32_t count; // requests counter
941
942	#if DEBUG_PROCESS_SIGACTION
943	thread_t * this = CURRENT_THREAD;
944	pid_t pid = process->pid;
945	uint32_t cycle = (uint32_t)hal_get_cycles();
946	if( DEBUG_PROCESS_SIGACTION < cycle )
947	printk("\n[%s] thread[%x,%x] enter for process %x in cluster %x / cycle %d\n",
948	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy , cycle );
949	#endif
950
951	// check target process is an user process
952	assert( ( LPID_FROM_PID( process->pid ) != 0 ),
953	"process %x is not an user process\n", process->pid );
954
955	// get lock protecting process th_tbl[]
956	rwlock_rd_acquire( &process->th_lock );
957
958	// loop on process threads to unblock all threads
959	// we use both "ltid" and "count" because it can exist "holes" in th_tbl
960	for( ltid = 0 , count = 0 ; count < process->th_nr ; ltid++ )
961	{
962	target = process->th_tbl[ltid];
963
964	if( target != NULL ) // thread found
965	{
966	count++;
967
968	// reset the global blocked bit in target thread descriptor.
969	thread_unblock( XPTR( local_cxy , target ) , THREAD_BLOCKED_GLOBAL );
970	}
971	}
972
973	// release lock protecting process th_tbl[]
974	rwlock_rd_release( &process->th_lock );
975
976	#if DEBUG_PROCESS_SIGACTION
977	cycle = (uint32_t)hal_get_cycles();
978	if( DEBUG_PROCESS_SIGACTION < cycle )
979	printk("\n[%s] thread[%x,%x] exit for process %x in cluster %x / cycle %d\n",
980	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy, cycle );
981	#endif
982
983	} // end process_unblock_threads()
984
985	///////////////////////////////////////////////
986	process_t * process_get_local_copy( pid_t pid )
987	{
988	error_t error;
989	process_t * process_ptr; // local pointer on process
990	xptr_t process_xp; // extended pointer on process
991
992	cluster_t * cluster = LOCAL_CLUSTER;
993
994	#if DEBUG_PROCESS_GET_LOCAL_COPY
995	thread_t * this = CURRENT_THREAD;
996	uint32_t cycle = (uint32_t)hal_get_cycles();
997	if( DEBUG_PROCESS_GET_LOCAL_COPY < cycle )
998	printk("\n[%s] thread[%x,%x] enter for process %x in cluster %x / cycle %d\n",
999	__FUNCTION__, this->process->pid, this->trdid, pid, local_cxy, cycle );
1000	#endif
1001
1002	// get lock protecting local list of processes
1003	remote_queuelock_acquire( XPTR( local_cxy , &cluster->pmgr.local_lock ) );
1004
1005	// scan the local list of process descriptors to find the process
1006	xptr_t iter;
1007	bool_t found = false;
1008	XLIST_FOREACH( XPTR( local_cxy , &cluster->pmgr.local_root ) , iter )
1009	{
1010	process_xp = XLIST_ELEMENT( iter , process_t , local_list );
1011	process_ptr = GET_PTR( process_xp );
1012	if( process_ptr->pid == pid )
1013	{
1014	found = true;
1015	break;
1016	}
1017	}
1018
1019	// release lock protecting local list of processes
1020	remote_queuelock_release( XPTR( local_cxy , &cluster->pmgr.local_lock ) );
1021
1022	// allocate memory for a new local process descriptor
1023	// and initialise it from reference cluster if not found
1024	if( !found )
1025	{
1026	// get extended pointer on reference process descriptor
1027	xptr_t ref_xp = cluster_get_reference_process_from_pid( pid );
1028
1029	assert( (ref_xp != XPTR_NULL) , "illegal pid\n" );
1030
1031	// allocate memory for local process descriptor
1032	process_ptr = process_alloc();
1033
1034	if( process_ptr == NULL ) return NULL;
1035
1036	// initialize local process descriptor copy
1037	error = process_copy_init( process_ptr , ref_xp );
1038
1039	if( error ) return NULL;
1040	}
1041
1042	#if DEBUG_PROCESS_GET_LOCAL_COPY
1043	cycle = (uint32_t)hal_get_cycles();
1044	if( DEBUG_PROCESS_GET_LOCAL_COPY < cycle )
1045	printk("\n[%s] thread[%x,%x] exit in cluster %x / process %x / cycle %d\n",
1046	__FUNCTION__, this->process->pid, this->trdid, local_cxy, process_ptr, cycle );
1047	#endif
1048
1049	return process_ptr;
1050
1051	} // end process_get_local_copy()
1052
1053	////////////////////////////////////////////
1054	pid_t process_get_ppid( xptr_t process_xp )
1055	{
1056	cxy_t process_cxy;
1057	process_t * process_ptr;
1058	xptr_t parent_xp;
1059	cxy_t parent_cxy;
1060	process_t * parent_ptr;
1061
1062	// get process cluster and local pointer
1063	process_cxy = GET_CXY( process_xp );
1064	process_ptr = GET_PTR( process_xp );
1065
1066	// get pointers on parent process
1067	parent_xp = (xptr_t)hal_remote_l64( XPTR( process_cxy , &process_ptr->parent_xp ) );
1068	parent_cxy = GET_CXY( parent_xp );
1069	parent_ptr = GET_PTR( parent_xp );
1070
1071	return hal_remote_l32( XPTR( parent_cxy , &parent_ptr->pid ) );
1072	}
1073
1074	//////////////////////////////////////////////////////////////////////////////////////////
1075	// File descriptor array related functions
1076	//////////////////////////////////////////////////////////////////////////////////////////
1077
1078	///////////////////////////////////////////
1079	void process_fd_init( process_t * process )
1080	{
1081	uint32_t fd;
1082
1083	// initialize lock
1084	remote_queuelock_init( XPTR( local_cxy , &process->fd_array.lock ), LOCK_PROCESS_FDARRAY );
1085
1086	// initialize number of open files
1087	process->fd_array.current = 0;
1088
1089	// initialize array
1090	for ( fd = 0 ; fd < CONFIG_PROCESS_FILE_MAX_NR ; fd++ )
1091	{
1092	process->fd_array.array[fd] = XPTR_NULL;
1093	}
1094	}
1095
1096	////////////////////////////////////////////////////
1097	error_t process_fd_register( xptr_t process_xp,
1098	xptr_t file_xp,
1099	uint32_t * fdid )
1100	{
1101	bool_t found;
1102	uint32_t id;
1103	xptr_t xp;
1104
1105	// get reference process cluster and local pointer
1106	process_t * process_ptr = GET_PTR( process_xp );
1107	cxy_t process_cxy = GET_CXY( process_xp );
1108
1109	// check client process is reference process
1110	assert( (process_xp == hal_remote_l64( XPTR( process_cxy , &process_ptr->ref_xp ) ) ),
1111	"client process must be reference process\n" );
1112
1113	#if DEBUG_PROCESS_FD_REGISTER
1114	thread_t * this = CURRENT_THREAD;
1115	uint32_t cycle = (uint32_t)hal_get_cycles();
1116	pid_t pid = hal_remote_l32( XPTR( process_cxy , &process_ptr->pid) );
1117	if( DEBUG_PROCESS_FD_REGISTER < cycle )
1118	printk("\n[%s] thread[%x,%x] enter for process %x / cycle %d\n",
1119	__FUNCTION__, this->process->pid, this->trdid, pid, cycle );
1120	#endif
1121
1122	// build extended pointer on lock protecting reference fd_array
1123	xptr_t lock_xp = XPTR( process_cxy , &process_ptr->fd_array.lock );
1124
1125	// take lock protecting reference fd_array
1126	remote_queuelock_acquire( lock_xp );
1127
1128	found = false;
1129
1130	for ( id = 0; id < CONFIG_PROCESS_FILE_MAX_NR ; id++ )
1131	{
1132	xp = hal_remote_l64( XPTR( process_cxy , &process_ptr->fd_array.array[id] ) );
1133	if ( xp == XPTR_NULL )
1134	{
1135	// update reference fd_array
1136	hal_remote_s64( XPTR( process_cxy , &process_ptr->fd_array.array[id] ) , file_xp );
1137	hal_remote_atomic_add( XPTR( process_cxy , &process_ptr->fd_array.current ) , 1 );
1138
1139	// exit
1140	*fdid = id;
1141	found = true;
1142	break;
1143	}
1144	}
1145
1146	// release lock protecting fd_array
1147	remote_queuelock_release( lock_xp );
1148
1149	#if DEBUG_PROCESS_FD_REGISTER
1150	cycle = (uint32_t)hal_get_cycles();
1151	if( DEBUG_PROCESS_FD_REGISTER < cycle )
1152	printk("\n[%s] thread[%x,%x] exit for process %x / fdid %d / cycle %d\n",
1153	__FUNCTION__, this->process->pid, this->trdid, pid, id, cycle );
1154	#endif
1155
1156	if ( !found ) return -1;
1157	else return 0;
1158
1159	} // end process_fd_register()
1160
1161	////////////////////////////////////////////////
1162	xptr_t process_fd_get_xptr( process_t * process,
1163	uint32_t fdid )
1164	{
1165	xptr_t file_xp;
1166	xptr_t lock_xp;
1167
1168	// access local copy of process descriptor
1169	file_xp = process->fd_array.array[fdid];
1170
1171	if( file_xp == XPTR_NULL )
1172	{
1173	// get reference process cluster and local pointer
1174	xptr_t ref_xp = process->ref_xp;
1175	cxy_t ref_cxy = GET_CXY( ref_xp );
1176	process_t * ref_ptr = GET_PTR( ref_xp );
1177
1178	// build extended pointer on lock protecting reference fd_array
1179	lock_xp = XPTR( ref_cxy , &ref_ptr->fd_array.lock );
1180
1181	// take lock protecting reference fd_array
1182	remote_queuelock_acquire( lock_xp );
1183
1184	// access reference process descriptor
1185	file_xp = hal_remote_l64( XPTR( ref_cxy , &ref_ptr->fd_array.array[fdid] ) );
1186
1187	// update local fd_array if found
1188	if( file_xp != XPTR_NULL ) process->fd_array.array[fdid] = file_xp;
1189
1190	// release lock protecting reference fd_array
1191	remote_queuelock_release( lock_xp );
1192	}
1193
1194	return file_xp;
1195
1196	} // end process_fd_get_xptr()
1197
1198	///////////////////////////////////////////
1199	void process_fd_remote_copy( xptr_t dst_xp,
1200	xptr_t src_xp )
1201	{
1202	uint32_t fd;
1203	xptr_t entry;
1204
1205	// get cluster and local pointer for src fd_array
1206	cxy_t src_cxy = GET_CXY( src_xp );
1207	fd_array_t * src_ptr = GET_PTR( src_xp );
1208
1209	// get cluster and local pointer for dst fd_array
1210	cxy_t dst_cxy = GET_CXY( dst_xp );
1211	fd_array_t * dst_ptr = GET_PTR( dst_xp );
1212
1213	// get the remote lock protecting the src fd_array
1214	remote_queuelock_acquire( XPTR( src_cxy , &src_ptr->lock ) );
1215
1216	// loop on all fd_array entries
1217	for( fd = 0 ; fd < CONFIG_PROCESS_FILE_MAX_NR ; fd++ )
1218	{
1219	entry = (xptr_t)hal_remote_l64( XPTR( src_cxy , &src_ptr->array[fd] ) );
1220
1221	if( entry != XPTR_NULL )
1222	{
1223	// increment file descriptor refcount
1224	vfs_file_count_up( entry );
1225
1226	// copy entry in destination process fd_array
1227	hal_remote_s64( XPTR( dst_cxy , &dst_ptr->array[fd] ) , entry );
1228	}
1229	}
1230
1231	// release lock on source process fd_array
1232	remote_queuelock_release( XPTR( src_cxy , &src_ptr->lock ) );
1233
1234	} // end process_fd_remote_copy()
1235
1236
1237	////////////////////////////////////
1238	bool_t process_fd_array_full( void )
1239	{
1240	// get extended pointer on reference process
1241	xptr_t ref_xp = CURRENT_THREAD->process->ref_xp;
1242
1243	// get reference process cluster and local pointer
1244	process_t * ref_ptr = GET_PTR( ref_xp );
1245	cxy_t ref_cxy = GET_CXY( ref_xp );
1246
1247	// get number of open file descriptors from reference fd_array
1248	uint32_t current = hal_remote_l32( XPTR( ref_cxy , &ref_ptr->fd_array.current ) );
1249
1250	return ( current >= CONFIG_PROCESS_FILE_MAX_NR );
1251	}
1252
1253
1254	////////////////////////////////////////////////////////////////////////////////////
1255	// Thread related functions
1256	////////////////////////////////////////////////////////////////////////////////////
1257
1258	/////////////////////////////////////////////////////
1259	error_t process_register_thread( process_t * process,
1260	thread_t * thread,
1261	trdid_t * trdid )
1262	{
1263	ltid_t ltid;
1264	bool_t found = false;
1265
1266	// check arguments
1267	assert( (process != NULL) , "process argument is NULL" );
1268	assert( (thread != NULL) , "thread argument is NULL" );
1269
1270	// get the lock protecting th_tbl for all threads
1271	// but the idle thread executing kernel_init (cannot yield)
1272	if( thread->type != THREAD_IDLE ) rwlock_wr_acquire( &process->th_lock );
1273
1274	// scan th_tbl
1275	for( ltid = 0 ; ltid < CONFIG_THREADS_MAX_PER_CLUSTER ; ltid++ )
1276	{
1277	if( process->th_tbl[ltid] == NULL )
1278	{
1279	found = true;
1280	break;
1281	}
1282	}
1283
1284	if( found )
1285	{
1286	// register thread in th_tbl[]
1287	process->th_tbl[ltid] = thread;
1288	process->th_nr++;
1289
1290	// returns trdid
1291	*trdid = TRDID( local_cxy , ltid );
1292	}
1293
1294	// release the lock protecting th_tbl
1295	if( thread->type != THREAD_IDLE ) rwlock_wr_release( &process->th_lock );
1296
1297	return (found) ? 0 : 0xFFFFFFFF;
1298
1299	} // end process_register_thread()
1300
1301	///////////////////////////////////////////////////
1302	uint32_t process_remove_thread( thread_t * thread )
1303	{
1304	uint32_t count; // number of threads in local process descriptor
1305
1306	// check thread
1307	assert( (thread != NULL) , "thread argument is NULL" );
1308
1309	process_t * process = thread->process;
1310
1311	// get thread local index
1312	ltid_t ltid = LTID_FROM_TRDID( thread->trdid );
1313
1314	// get the lock protecting th_tbl[]
1315	rwlock_wr_acquire( &process->th_lock );
1316
1317	// get number of threads
1318	count = process->th_nr;
1319
1320	// check th_nr value
1321	assert( (count > 0) , "process th_nr cannot be 0" );
1322
1323	// remove thread from th_tbl[]
1324	process->th_tbl[ltid] = NULL;
1325	process->th_nr = count-1;
1326
1327	// release lock protecting th_tbl
1328	rwlock_wr_release( &process->th_lock );
1329
1330	return count;
1331
1332	} // end process_remove_thread()
1333
1334	/////////////////////////////////////////////////////////
1335	error_t process_make_fork( xptr_t parent_process_xp,
1336	xptr_t parent_thread_xp,
1337	pid_t * child_pid,
1338	thread_t ** child_thread )
1339	{
1340	process_t * process; // local pointer on child process descriptor
1341	thread_t * thread; // local pointer on child thread descriptor
1342	pid_t new_pid; // process identifier for child process
1343	pid_t parent_pid; // process identifier for parent process
1344	xptr_t ref_xp; // extended pointer on reference process
1345	xptr_t vfs_bin_xp; // extended pointer on .elf file
1346	error_t error;
1347
1348	// get cluster and local pointer for parent process
1349	cxy_t parent_process_cxy = GET_CXY( parent_process_xp );
1350	process_t * parent_process_ptr = GET_PTR( parent_process_xp );
1351
1352	// get parent process PID and extended pointer on .elf file
1353	parent_pid = hal_remote_l32 (XPTR( parent_process_cxy , &parent_process_ptr->pid));
1354	vfs_bin_xp = hal_remote_l64(XPTR( parent_process_cxy , &parent_process_ptr->vfs_bin_xp));
1355
1356	// get extended pointer on reference process
1357	ref_xp = hal_remote_l64( XPTR( parent_process_cxy , &parent_process_ptr->ref_xp ) );
1358
1359	// check parent process is the reference process
1360	assert( (parent_process_xp == ref_xp ) ,
1361	"parent process must be the reference process" );
1362
1363	#if DEBUG_PROCESS_MAKE_FORK
1364	uint32_t cycle;
1365	thread_t * this = CURRENT_THREAD;
1366	trdid_t trdid = this->trdid;
1367	pid_t pid = this->process->pid;
1368	#endif
1369
1370	#if( DEBUG_PROCESS_MAKE_FORK & 1 )
1371	cycle = (uint32_t)hal_get_cycles();
1372	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1373	printk("\n[%s] thread[%x,%x] enter / cluster %x / cycle %d\n",
1374	__FUNCTION__, pid, trdid, local_cxy, cycle );
1375	#endif
1376
1377	// allocate a process descriptor
1378	process = process_alloc();
1379
1380	if( process == NULL )
1381	{
1382	printk("\n[ERROR] in %s : cannot get process in cluster %x\n",
1383	__FUNCTION__, local_cxy );
1384	return -1;
1385	}
1386
1387	// allocate a child PID from local cluster
1388	error = cluster_pid_alloc( process , &new_pid );
1389	if( error )
1390	{
1391	printk("\n[ERROR] in %s : cannot get PID in cluster %x\n",
1392	__FUNCTION__, local_cxy );
1393	process_free( process );
1394	return -1;
1395	}
1396
1397	#if( DEBUG_PROCESS_MAKE_FORK & 1 )
1398	cycle = (uint32_t)hal_get_cycles();
1399	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1400	printk("\n[%s] thread[%x,%x] allocated child_process %x / cycle %d\n",
1401	__FUNCTION__, pid, trdid, new_pid, cycle );
1402	#endif
1403
1404	// initializes child process descriptor from parent process descriptor
1405	error = process_reference_init( process,
1406	new_pid,
1407	parent_process_xp );
1408	if( error )
1409	{
1410	printk("\n[ERROR] in %s : cannot initialize child process in cluster %x\n",
1411	__FUNCTION__, local_cxy );
1412	process_free( process );
1413	return -1;
1414	}
1415
1416	#if( DEBUG_PROCESS_MAKE_FORK & 1 )
1417	cycle = (uint32_t)hal_get_cycles();
1418	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1419	printk("\n[%s] thread[%x,%x] initialized child_process %x / cycle %d\n",
1420	__FUNCTION__, pid, trdid, new_pid, cycle );
1421	#endif
1422
1423	// copy VMM from parent descriptor to child descriptor
1424	error = vmm_fork_copy( process,
1425	parent_process_xp );
1426	if( error )
1427	{
1428	printk("\n[ERROR] in %s : cannot copy VMM in cluster %x\n",
1429	__FUNCTION__, local_cxy );
1430	process_free( process );
1431	cluster_pid_release( new_pid );
1432	return -1;
1433	}
1434
1435	#if( DEBUG_PROCESS_MAKE_FORK & 1 )
1436	cycle = (uint32_t)hal_get_cycles();
1437	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1438	printk("\n[%s] thread[%x,%x] copied VMM from parent to child / cycle %d\n",
1439	__FUNCTION__, pid, trdid, cycle );
1440	hal_vmm_display( XPTR( local_cxy , process ) , true );
1441	#endif
1442
1443	// if parent_process is INIT, or if parent_process is the TXT owner,
1444	// the child_process becomes the owner of its TXT terminal
1445	if( (parent_pid == 1) \|\| process_txt_is_owner( parent_process_xp ) )
1446	{
1447	process_txt_set_ownership( XPTR( local_cxy , process ) );
1448
1449	#if( DEBUG_PROCESS_MAKE_FORK & 1 )
1450	cycle = (uint32_t)hal_get_cycles();
1451	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1452	printk("\n[%s] thread[%x,%x] / child_process %x takes TXT ownership / cycle %d\n",
1453	__FUNCTION__ , pid, trdid, new_pid, cycle );
1454	#endif
1455
1456	}
1457
1458	// update extended pointer on .elf file
1459	process->vfs_bin_xp = vfs_bin_xp;
1460
1461	// create child thread descriptor from parent thread descriptor
1462	error = thread_user_fork( parent_thread_xp,
1463	process,
1464	&thread );
1465	if( error )
1466	{
1467	printk("\n[ERROR] in %s : cannot create thread in cluster %x\n",
1468	__FUNCTION__, local_cxy );
1469	process_free( process );
1470	cluster_pid_release( new_pid );
1471	return -1;
1472	}
1473
1474	// check main thread LTID
1475	assert( (LTID_FROM_TRDID(thread->trdid) == 0) ,
1476	"main thread must have LTID == 0" );
1477
1478	#if( DEBUG_PROCESS_MAKE_FORK & 1 )
1479	cycle = (uint32_t)hal_get_cycles();
1480	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1481	printk("\n[%s] thread[%x,%x] created main thread %x / cycle %d\n",
1482	__FUNCTION__, pid, trdid, thread, cycle );
1483	#endif
1484
1485	// set COW flag in DATA, ANON, REMOTE vsegs in parent process VMM
1486	// this includes all parent process copies in all clusters
1487	if( parent_process_cxy == local_cxy ) // reference is local
1488	{
1489	vmm_set_cow( parent_process_ptr );
1490	}
1491	else // reference is remote
1492	{
1493	rpc_vmm_set_cow_client( parent_process_cxy,
1494	parent_process_ptr );
1495	}
1496
1497	// set COW flag in DATA, ANON, REMOTE vsegs for child process VMM
1498	vmm_set_cow( process );
1499
1500	#if( DEBUG_PROCESS_MAKE_FORK & 1 )
1501	cycle = (uint32_t)hal_get_cycles();
1502	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1503	printk("\n[%s] thread[%x,%x] set COW in DATA / ANON / REMOTE for parent and child / cycle %d\n",
1504	__FUNCTION__, pid, trdid, cycle );
1505	#endif
1506
1507	// get extended pointers on parent children_root, children_lock and children_nr
1508	xptr_t children_root_xp = XPTR( parent_process_cxy , &parent_process_ptr->children_root );
1509	xptr_t children_lock_xp = XPTR( parent_process_cxy , &parent_process_ptr->children_lock );
1510	xptr_t children_nr_xp = XPTR( parent_process_cxy , &parent_process_ptr->children_nr );
1511
1512	// register process in parent children list
1513	remote_queuelock_acquire( children_lock_xp );
1514	xlist_add_last( children_root_xp , XPTR( local_cxy , &process->children_list ) );
1515	hal_remote_atomic_add( children_nr_xp , 1 );
1516	remote_queuelock_release( children_lock_xp );
1517
1518	// return success
1519	*child_thread = thread;
1520	*child_pid = new_pid;
1521
1522	#if DEBUG_PROCESS_MAKE_FORK
1523	cycle = (uint32_t)hal_get_cycles();
1524	if( DEBUG_PROCESS_MAKE_FORK < cycle )
1525	printk("\n[%s] thread[%x,%x] exit / created process %x / cycle %d\n",
1526	__FUNCTION__, pid, trdid, new_pid, cycle );
1527	#endif
1528
1529	return 0;
1530
1531	} // end process_make_fork()
1532
1533	/////////////////////////////////////////////////////
1534	error_t process_make_exec( exec_info_t * exec_info )
1535	{
1536	thread_t * thread; // local pointer on this thread
1537	process_t * process; // local pointer on this process
1538	pid_t pid; // this process identifier
1539	xptr_t ref_xp; // reference process for this process
1540	error_t error; // value returned by called functions
1541	char * path; // path to .elf file
1542	xptr_t file_xp; // extended pointer on .elf file descriptor
1543	uint32_t file_id; // file index in fd_array
1544	uint32_t args_nr; // number of main thread arguments
1545	char ** args_pointers; // array of pointers on main thread arguments
1546
1547	// get calling thread, process, pid and ref_xp
1548	thread = CURRENT_THREAD;
1549	process = thread->process;
1550	pid = process->pid;
1551	ref_xp = process->ref_xp;
1552
1553	// get relevant infos from exec_info
1554	path = exec_info->path;
1555	args_nr = exec_info->args_nr;
1556	args_pointers = exec_info->args_pointers;
1557
1558	#if DEBUG_PROCESS_MAKE_EXEC
1559	uint32_t cycle = (uint32_t)hal_get_cycles();
1560	if( DEBUG_PROCESS_MAKE_EXEC < cycle )
1561	printk("\n[%s] thread[%x,%x] enters for %s / cycle %d\n",
1562	__FUNCTION__, pid, thread->trdid, path, cycle );
1563	#endif
1564
1565	// open the file identified by <path>
1566	file_xp = XPTR_NULL;
1567	file_id = 0xFFFFFFFF;
1568	error = vfs_open( process->vfs_root_xp,
1569	path,
1570	ref_xp,
1571	O_RDONLY,
1572	0,
1573	&file_xp,
1574	&file_id );
1575	if( error )
1576	{
1577	printk("\n[ERROR] in %s : failed to open file <%s>\n", __FUNCTION__ , path );
1578	return -1;
1579	}
1580
1581	#if (DEBUG_PROCESS_MAKE_EXEC & 1)
1582	cycle = (uint32_t)hal_get_cycles();
1583	if( DEBUG_PROCESS_MAKE_EXEC < cycle )
1584	printk("\n[%s] thread[%x,%x] opened file <%s> / cycle %d\n",
1585	__FUNCTION__, pid, thread->trdid, path, cycle );
1586	#endif
1587
1588	// delete all threads other than this main thread in all clusters
1589	process_sigaction( pid , DELETE_ALL_THREADS );
1590
1591	#if (DEBUG_PROCESS_MAKE_EXEC & 1)
1592	cycle = (uint32_t)hal_get_cycles();
1593	if( DEBUG_PROCESS_MAKE_EXEC < cycle )
1594	printk("\n[%s] thread[%x,%x] deleted existing threads / cycle %d\n",
1595	__FUNCTION__, pid, thread->trdid, cycle );
1596	#endif
1597
1598	// reset calling process VMM
1599	vmm_user_reset( process );
1600
1601	#if( DEBUG_PROCESS_MAKE_EXEC & 1 )
1602	cycle = (uint32_t)hal_get_cycles();
1603	if( DEBUG_PROCESS_MAKE_EXEC < cycle )
1604	printk("\n[%s] thread[%x,%x] completed VMM reset / cycle %d\n",
1605	__FUNCTION__, pid, thread->trdid, cycle );
1606	#endif
1607
1608	// re-initialize the VMM (args/envs vsegs registration)
1609	error = vmm_user_init( process );
1610	if( error )
1611	{
1612	printk("\n[ERROR] in %s : cannot initialise VMM for %s\n", __FUNCTION__ , path );
1613	vfs_close( file_xp , file_id );
1614	// FIXME restore old process VMM [AG]
1615	return -1;
1616	}
1617
1618	#if( DEBUG_PROCESS_MAKE_EXEC & 1 )
1619	cycle = (uint32_t)hal_get_cycles();
1620	if( DEBUG_PROCESS_MAKE_EXEC < cycle )
1621	printk("\n[%s] thread[%x,%x] registered args/envs vsegs / cycle %d\n",
1622	__FUNCTION__, pid, thread->trdid, cycle );
1623	#endif
1624
1625	// register code & data vsegs as well as entry-point in process VMM,
1626	// and register extended pointer on .elf file in process descriptor
1627	error = elf_load_process( file_xp , process );
1628	if( error )
1629	{
1630	printk("\n[ERROR] in %s : failed to access <%s>\n", __FUNCTION__ , path );
1631	vfs_close( file_xp , file_id );
1632	// FIXME restore old process VMM [AG]
1633	return -1;
1634	}
1635
1636	#if( DEBUG_PROCESS_MAKE_EXEC & 1 )
1637	cycle = (uint32_t)hal_get_cycles();
1638	if( DEBUG_PROCESS_MAKE_EXEC < cycle )
1639	printk("\n[%s] thread[%x,%x] registered code/data vsegs / cycle %d\n",
1640	__FUNCTION__, pid, thread->trdid, cycle );
1641	#endif
1642
1643	// update the existing main thread descriptor... and jump to user code
1644	error = thread_user_exec( (void *)process->vmm.entry_point,
1645	args_nr,
1646	args_pointers );
1647	if( error )
1648	{
1649	printk("\n[ERROR] in %s : cannot update main thread for %s\n", __FUNCTION__ , path );
1650	vfs_close( file_xp , file_id );
1651	// FIXME restore old process VMM
1652	return -1;
1653	}
1654
1655	assert( false, "we should not execute this code");
1656
1657	return 0;
1658
1659	} // end process_make_exec()
1660
1661
1662	////////////////////////////////////////////////
1663	void process_zero_create( process_t * process,
1664	boot_info_t * info )
1665	{
1666	error_t error;
1667	pid_t pid;
1668
1669	#if DEBUG_PROCESS_ZERO_CREATE
1670	uint32_t cycle = (uint32_t)hal_get_cycles();
1671	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1672	printk("\n[%s] enter / cluster %x / cycle %d\n",
1673	__FUNCTION__, local_cxy, cycle );
1674	#endif
1675
1676	// get pointer on VMM
1677	vmm_t * vmm = &process->vmm;
1678
1679	// get PID from local cluster manager for this kernel process
1680	error = cluster_pid_alloc( process , &pid );
1681
1682	if( error \|\| (LPID_FROM_PID( pid ) != 0) )
1683	{
1684	printk("\n[PANIC] in %s : cannot get valid PID in cluster %x / PID = %x\n",
1685	__FUNCTION__ , local_cxy, pid );
1686	hal_core_sleep();
1687	}
1688
1689	#if (DEBUG_PROCESS_ZERO_CREATE & 1)
1690	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1691	printk("\n[%s] allocated pid %x in cluster %x\n", __FUNCTION__, pid, local_cxy );
1692	#endif
1693
1694	// initialize PID, REF_XP, PARENT_XP, and STATE
1695	// the kernel process_zero is its own parent_process,
1696	// reference_process, and owner_process, and cannot be killed...
1697	process->pid = pid;
1698	process->ref_xp = XPTR( local_cxy , process );
1699	process->owner_xp = XPTR( local_cxy , process );
1700	process->parent_xp = XPTR( local_cxy , process );
1701	process->term_state = 0;
1702
1703	// initialize VSL as empty
1704	vmm->vsegs_nr = 0;
1705	xlist_root_init( XPTR( local_cxy , &vmm->vsegs_root ) );
1706
1707	#if (DEBUG_PROCESS_ZERO_CREATE & 1)
1708	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1709	printk("\n[%s] initialized VSL empty in cluster %x\n", __FUNCTION__, local_cxy );
1710	#endif
1711
1712	// initialize GPT as empty
1713	error = hal_gpt_create( &vmm->gpt );
1714
1715	if( error )
1716	{
1717	printk("\n[PANIC] in %s : cannot create empty GPT\n", __FUNCTION__ );
1718	hal_core_sleep();
1719	}
1720
1721	#if (DEBUG_PROCESS_ZERO_CREATE & 1)
1722	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1723	printk("\n[%s] initialized GPT empty in cluster %x\n", __FUNCTION__, local_cxy );
1724	#endif
1725
1726	// initialize VSL and GPT locks
1727	remote_rwlock_init( XPTR( local_cxy , &vmm->vsl_lock ) , LOCK_VMM_VSL );
1728
1729	// create kernel vsegs in GPT and VSL, as required by the hardware architecture
1730	error = hal_vmm_kernel_init( info );
1731
1732	if( error )
1733	{
1734	printk("\n[PANIC] in %s : cannot create kernel vsegs in VMM\n", __FUNCTION__ );
1735	hal_core_sleep();
1736	}
1737
1738	#if (DEBUG_PROCESS_ZERO_CREATE & 1)
1739	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1740	printk("\n[%s] initialized hal specific VMM in cluster%x\n", __FUNCTION__, local_cxy );
1741	#endif
1742
1743	// reset th_tbl[] array and associated fields
1744	uint32_t i;
1745	for( i = 0 ; i < CONFIG_THREADS_MAX_PER_CLUSTER ; i++ )
1746	{
1747	process->th_tbl[i] = NULL;
1748	}
1749	process->th_nr = 0;
1750	rwlock_init( &process->th_lock , LOCK_PROCESS_THTBL );
1751
1752	#if (DEBUG_PROCESS_ZERO_CREATE & 1)
1753	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1754	printk("\n[%s] initialized th_tbl[] in cluster%x\n", __FUNCTION__, local_cxy );
1755	#endif
1756
1757	// reset children list as empty
1758	xlist_root_init( XPTR( local_cxy , &process->children_root ) );
1759	process->children_nr = 0;
1760	remote_queuelock_init( XPTR( local_cxy , &process->children_lock ),
1761	LOCK_PROCESS_CHILDREN );
1762
1763	#if (DEBUG_PROCESS_ZERO_CREATE & 1)
1764	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1765	printk("\n[%s] initialized children list in cluster%x\n", __FUNCTION__, local_cxy );
1766	#endif
1767
1768	// register kernel process in cluster manager local_list
1769	cluster_process_local_link( process );
1770
1771	hal_fence();
1772
1773	#if DEBUG_PROCESS_ZERO_CREATE
1774	cycle = (uint32_t)hal_get_cycles();
1775	if( DEBUG_PROCESS_ZERO_CREATE < cycle )
1776	printk("\n[%s] exit / cluster %x / cycle %d\n",
1777	__FUNCTION__, local_cxy, cycle );
1778	#endif
1779
1780	} // end process_zero_create()
1781
1782	////////////////////////////////
1783	void process_init_create( void )
1784	{
1785	process_t * process; // local pointer on process descriptor
1786	pid_t pid; // process_init identifier
1787	thread_t * thread; // local pointer on main thread
1788	pthread_attr_t attr; // main thread attributes
1789	lid_t lid; // selected core local index for main thread
1790	xptr_t file_xp; // extended pointer on .elf file descriptor
1791	uint32_t file_id; // file index in fd_array
1792	error_t error;
1793
1794	#if DEBUG_PROCESS_INIT_CREATE
1795	thread_t * this = CURRENT_THREAD;
1796	uint32_t cycle = (uint32_t)hal_get_cycles();
1797	if( DEBUG_PROCESS_INIT_CREATE < cycle )
1798	printk("\n[%s] thread[%x,%x] enter / cycle %d\n",
1799	__FUNCTION__, this->process->pid, this->trdid, cycle );
1800	#endif
1801
1802	// allocates memory for process descriptor from local cluster
1803	process = process_alloc();
1804	if( process == NULL )
1805	{
1806	printk("\n[PANIC] in %s : cannot allocate process\n", __FUNCTION__ );
1807	hal_core_sleep();
1808	}
1809
1810	// set the CWD and VFS_ROOT fields in process descriptor
1811	process->cwd_xp = process_zero.vfs_root_xp;
1812	process->vfs_root_xp = process_zero.vfs_root_xp;
1813
1814	// get PID from local cluster
1815	error = cluster_pid_alloc( process , &pid );
1816	if( error )
1817	{
1818	printk("\n[PANIC] in %s : cannot allocate PID\n", __FUNCTION__ );
1819	hal_core_sleep();
1820	}
1821	if( pid != 1 )
1822	{
1823	printk("\n[PANIC] in %s : process PID must be 0x1\n", __FUNCTION__ );
1824	hal_core_sleep();
1825	}
1826
1827	// initialize process descriptor / parent is local process_zero
1828	error = process_reference_init( process,
1829	pid,
1830	XPTR( local_cxy , &process_zero ) );
1831	if( error )
1832	{
1833	printk("\n[PANIC] in %s : cannot initialize process\n", __FUNCTION__ );
1834	hal_core_sleep();
1835	}
1836
1837	#if(DEBUG_PROCESS_INIT_CREATE & 1)
1838	if( DEBUG_PROCESS_INIT_CREATE < cycle )
1839	printk("\n[%s] thread[%x,%x] initialized process descriptor\n",
1840	__FUNCTION__, this->process->pid, this->trdid );
1841	#endif
1842
1843	// open the file identified by CONFIG_PROCESS_INIT_PATH
1844	file_xp = XPTR_NULL;
1845	file_id = -1;
1846	error = vfs_open( process->vfs_root_xp,
1847	CONFIG_PROCESS_INIT_PATH,
1848	XPTR( local_cxy , process ),
1849	O_RDONLY,
1850	0,
1851	&file_xp,
1852	&file_id );
1853	if( error )
1854	{
1855	printk("\n[PANIC] in %s : cannot open file <%s>\n",
1856	__FUNCTION__, CONFIG_PROCESS_INIT_PATH );
1857	hal_core_sleep();
1858	}
1859
1860	#if(DEBUG_PROCESS_INIT_CREATE & 1)
1861	if( DEBUG_PROCESS_INIT_CREATE < cycle )
1862	printk("\n[%s] thread[%x,%x] open .elf file decriptor\n",
1863	__FUNCTION__, this->process->pid, this->trdid );
1864	#endif
1865
1866	// register "code" and "data" vsegs as well as entry-point
1867	// in process VMM, using information contained in the elf file.
1868	error = elf_load_process( file_xp , process );
1869
1870	if( error )
1871	{
1872	printk("\n[PANIC] in %s : cannot access file <%s>\n",
1873	__FUNCTION__, CONFIG_PROCESS_INIT_PATH );
1874	hal_core_sleep();
1875	}
1876
1877
1878	#if(DEBUG_PROCESS_INIT_CREATE & 1)
1879	if( DEBUG_PROCESS_INIT_CREATE < cycle )
1880	printk("\n[%s] thread[%x,%x] registered code/data vsegs in VMM\n",
1881	__FUNCTION__, this->process->pid, this->trdid );
1882	#endif
1883
1884	#if (DEBUG_PROCESS_INIT_CREATE & 1)
1885	hal_vmm_display( XPTR( local_cxy , process ) , true );
1886	#endif
1887
1888	// get extended pointers on process_zero children_root, children_lock
1889	xptr_t children_root_xp = XPTR( local_cxy , &process_zero.children_root );
1890	xptr_t children_lock_xp = XPTR( local_cxy , &process_zero.children_lock );
1891
1892	// take lock protecting kernel process children list
1893	remote_queuelock_acquire( children_lock_xp );
1894
1895	// register process INIT in parent local process_zero
1896	xlist_add_last( children_root_xp , XPTR( local_cxy , &process->children_list ) );
1897	hal_atomic_add( &process_zero.children_nr , 1 );
1898
1899	// release lock protecting kernel process children list
1900	remote_queuelock_release( children_lock_xp );
1901
1902	#if(DEBUG_PROCESS_INIT_CREATE & 1)
1903	if( DEBUG_PROCESS_INIT_CREATE < cycle )
1904	printk("\n[%s] thread[%x,%x] registered init process in parent\n",
1905	__FUNCTION__, this->process->pid, this->trdid );
1906	#endif
1907
1908	// select a core in local cluster to execute the main thread
1909	lid = cluster_select_local_core( local_cxy );
1910
1911	// initialize pthread attributes for main thread
1912	attr.attributes = PT_ATTR_DETACH \| PT_ATTR_CLUSTER_DEFINED \| PT_ATTR_CORE_DEFINED;
1913	attr.cxy = local_cxy;
1914	attr.lid = lid;
1915
1916	// create and initialize thread descriptor
1917	error = thread_user_create( pid,
1918	(void *)process->vmm.entry_point,
1919	NULL,
1920	&attr,
1921	&thread );
1922
1923	if( error )
1924	{
1925	printk("\n[PANIC] in %s : cannot create main thread\n", __FUNCTION__ );
1926	hal_core_sleep();
1927	}
1928	if( thread->trdid != 0 )
1929	{
1930	printk("\n[PANIC] in %s : bad main thread trdid\n", __FUNCTION__ );
1931	hal_core_sleep();
1932	}
1933
1934	#if(DEBUG_PROCESS_INIT_CREATE & 1)
1935	if( DEBUG_PROCESS_INIT_CREATE < cycle )
1936	printk("\n[%s] thread[%x,%x] created main thread\n",
1937	__FUNCTION__, this->process->pid, this->trdid );
1938	#endif
1939
1940	// activate thread
1941	thread_unblock( XPTR( local_cxy , thread ) , THREAD_BLOCKED_GLOBAL );
1942
1943	hal_fence();
1944
1945	#if DEBUG_PROCESS_INIT_CREATE
1946	cycle = (uint32_t)hal_get_cycles();
1947	if( DEBUG_PROCESS_INIT_CREATE < cycle )
1948	printk("\n[%s] thread[%x,%x] exit / cycle %d\n",
1949	__FUNCTION__, this->process->pid, this->trdid, cycle );
1950	#endif
1951
1952	} // end process_init_create()
1953
1954	/////////////////////////////////////////
1955	void process_display( xptr_t process_xp )
1956	{
1957	process_t * process_ptr;
1958	cxy_t process_cxy;
1959
1960	xptr_t parent_xp; // extended pointer on parent process
1961	process_t * parent_ptr;
1962	cxy_t parent_cxy;
1963
1964	xptr_t owner_xp; // extended pointer on owner process
1965	process_t * owner_ptr;
1966	cxy_t owner_cxy;
1967
1968	pid_t pid;
1969	pid_t ppid;
1970	lpid_t lpid;
1971	uint32_t state;
1972	uint32_t th_nr;
1973
1974	xptr_t txt_file_xp; // extended pointer on TXT_RX file descriptor
1975	xptr_t txt_chdev_xp; // extended pointer on TXT_RX chdev
1976	chdev_t * txt_chdev_ptr;
1977	cxy_t txt_chdev_cxy;
1978	xptr_t txt_owner_xp; // extended pointer on TXT owner process
1979
1980	xptr_t elf_file_xp; // extended pointer on .elf file
1981	cxy_t elf_file_cxy;
1982	vfs_file_t * elf_file_ptr;
1983	vfs_inode_t * elf_inode_ptr; // local pointer on .elf inode
1984
1985	char txt_name[CONFIG_VFS_MAX_NAME_LENGTH];
1986	char elf_name[CONFIG_VFS_MAX_NAME_LENGTH];
1987
1988	// get cluster and local pointer on process
1989	process_ptr = GET_PTR( process_xp );
1990	process_cxy = GET_CXY( process_xp );
1991
1992	// get process PID, LPID, and state
1993	pid = hal_remote_l32( XPTR( process_cxy , &process_ptr->pid ) );
1994	lpid = LPID_FROM_PID( pid );
1995	state = hal_remote_l32( XPTR( process_cxy , &process_ptr->term_state ) );
1996
1997	// get process PPID
1998	parent_xp = hal_remote_l64( XPTR( process_cxy , &process_ptr->parent_xp ) );
1999	parent_cxy = GET_CXY( parent_xp );
2000	parent_ptr = GET_PTR( parent_xp );
2001	ppid = hal_remote_l32( XPTR( parent_cxy , &parent_ptr->pid ) );
2002
2003	// get number of threads
2004	th_nr = hal_remote_l32( XPTR( process_cxy , &process_ptr->th_nr ) );
2005
2006	// get pointers on owner process descriptor
2007	owner_xp = hal_remote_l64( XPTR( process_cxy , &process_ptr->owner_xp ) );
2008	owner_cxy = GET_CXY( owner_xp );
2009	owner_ptr = GET_PTR( owner_xp );
2010
2011	// get process TXT name and .elf name
2012	if( lpid ) // user process
2013	{
2014
2015	// get extended pointer on file descriptor associated to TXT_RX
2016	txt_file_xp = hal_remote_l64( XPTR( owner_cxy , &owner_ptr->fd_array.array[0] ) );
2017
2018	assert( (txt_file_xp != XPTR_NULL) ,
2019	"process must be attached to one TXT terminal" );
2020
2021	// get TXT_RX chdev pointers
2022	txt_chdev_xp = chdev_from_file( txt_file_xp );
2023	txt_chdev_cxy = GET_CXY( txt_chdev_xp );
2024	txt_chdev_ptr = GET_PTR( txt_chdev_xp );
2025
2026	// get TXT_RX name and ownership
2027	hal_remote_strcpy( XPTR( local_cxy , txt_name ) ,
2028	XPTR( txt_chdev_cxy , txt_chdev_ptr->name ) );
2029
2030	txt_owner_xp = (xptr_t)hal_remote_l64( XPTR( txt_chdev_cxy,
2031	&txt_chdev_ptr->ext.txt.owner_xp ) );
2032
2033	// get process .elf name
2034	elf_file_xp = hal_remote_l64( XPTR( process_cxy , &process_ptr->vfs_bin_xp ) );
2035	elf_file_cxy = GET_CXY( elf_file_xp );
2036	elf_file_ptr = GET_PTR( elf_file_xp );
2037	elf_inode_ptr = hal_remote_lpt( XPTR( elf_file_cxy , &elf_file_ptr->inode ) );
2038	vfs_inode_get_name( XPTR( elf_file_cxy , elf_inode_ptr ) , elf_name );
2039	}
2040	else // kernel process_zero
2041	{
2042	// TXT name and .elf name are not registered in kernel process_zero
2043	strcpy( txt_name , "txt0_rx" );
2044	txt_owner_xp = process_xp;
2045	strcpy( elf_name , "kernel.elf" );
2046	}
2047
2048	// display process info
2049	if( txt_owner_xp == process_xp )
2050	{
2051	nolock_printk("PID %X \| %s (FG) \| %X \| PPID %X \| TS %X \| %d \| %s\n",
2052	pid, txt_name, process_ptr, ppid, state, th_nr, elf_name );
2053	}
2054	else
2055	{
2056	nolock_printk("PID %X \| %s (BG) \| %X \| PPID %X \| TS %X \| %d \| %s\n",
2057	pid, txt_name, process_ptr, ppid, state, th_nr, elf_name );
2058	}
2059	} // end process_display()
2060
2061
2062	////////////////////////////////////////////////////////////////////////////////////////
2063	// Terminals related functions
2064	////////////////////////////////////////////////////////////////////////////////////////
2065
2066	//////////////////////////////////
2067	uint32_t process_txt_alloc( void )
2068	{
2069	uint32_t index; // TXT terminal index
2070	xptr_t chdev_xp; // extended pointer on TXT_RX chdev
2071	chdev_t * chdev_ptr; // local pointer on TXT_RX chdev
2072	cxy_t chdev_cxy; // TXT_RX chdev cluster
2073	xptr_t root_xp; // extended pointer on owner field in chdev
2074
2075	// scan the user TXT_RX chdevs (TXT0 is reserved for kernel)
2076	for( index = 1 ; index < LOCAL_CLUSTER->nb_txt_channels ; index ++ )
2077	{
2078	// get pointers on TXT_RX[index]
2079	chdev_xp = chdev_dir.txt_rx[index];
2080	chdev_cxy = GET_CXY( chdev_xp );
2081	chdev_ptr = GET_PTR( chdev_xp );
2082
2083	// get extended pointer on root of attached process
2084	root_xp = XPTR( chdev_cxy , &chdev_ptr->ext.txt.root );
2085
2086	// return free TXT index if found
2087	if( xlist_is_empty( root_xp ) ) return index;
2088	}
2089
2090	assert( false , "no free TXT terminal found" );
2091
2092	return -1;
2093
2094	} // end process_txt_alloc()
2095
2096	/////////////////////////////////////////////
2097	void process_txt_attach( process_t * process,
2098	uint32_t txt_id )
2099	{
2100	xptr_t chdev_xp; // extended pointer on TXT_RX chdev
2101	cxy_t chdev_cxy; // TXT_RX chdev cluster
2102	chdev_t * chdev_ptr; // local pointer on TXT_RX chdev
2103	xptr_t root_xp; // extended pointer on list root in chdev
2104	xptr_t lock_xp; // extended pointer on list lock in chdev
2105
2106	// check process is in owner cluster
2107	assert( (CXY_FROM_PID( process->pid ) == local_cxy) ,
2108	"process descriptor not in owner cluster" );
2109
2110	// check terminal index
2111	assert( (txt_id < LOCAL_CLUSTER->nb_txt_channels) ,
2112	"illegal TXT terminal index" );
2113
2114	// get pointers on TXT_RX[txt_id] chdev
2115	chdev_xp = chdev_dir.txt_rx[txt_id];
2116	chdev_cxy = GET_CXY( chdev_xp );
2117	chdev_ptr = GET_PTR( chdev_xp );
2118
2119	// get extended pointer on root & lock of attached process list
2120	root_xp = XPTR( chdev_cxy , &chdev_ptr->ext.txt.root );
2121	lock_xp = XPTR( chdev_cxy , &chdev_ptr->ext.txt.lock );
2122
2123	// get lock protecting list of processes attached to TXT
2124	remote_busylock_acquire( lock_xp );
2125
2126	// insert process in attached process list
2127	xlist_add_last( root_xp , XPTR( local_cxy , &process->txt_list ) );
2128
2129	// release lock protecting list of processes attached to TXT
2130	remote_busylock_release( lock_xp );
2131
2132	#if DEBUG_PROCESS_TXT
2133	thread_t * this = CURRENT_THREAD;
2134	uint32_t cycle = (uint32_t)hal_get_cycles();
2135	if( DEBUG_PROCESS_TXT < cycle )
2136	printk("\n[%s] thread[%x,%x] attached process %x to TXT %d / cycle %d\n",
2137	__FUNCTION__, this->process->pid, this->trdid, process->pid, txt_id , cycle );
2138	#endif
2139
2140	} // end process_txt_attach()
2141
2142	/////////////////////////////////////////////
2143	void process_txt_detach( xptr_t process_xp )
2144	{
2145	process_t * process_ptr; // local pointer on process in owner cluster
2146	cxy_t process_cxy; // process owner cluster
2147	pid_t process_pid; // process identifier
2148	xptr_t file_xp; // extended pointer on stdin file
2149	xptr_t chdev_xp; // extended pointer on TXT_RX chdev
2150	cxy_t chdev_cxy; // TXT_RX chdev cluster
2151	chdev_t * chdev_ptr; // local pointer on TXT_RX chdev
2152	xptr_t lock_xp; // extended pointer on list lock in chdev
2153
2154	// get process cluster, local pointer, and PID
2155	process_cxy = GET_CXY( process_xp );
2156	process_ptr = GET_PTR( process_xp );
2157	process_pid = hal_remote_l32( XPTR( process_cxy , &process_ptr->pid ) );
2158
2159	// check process descriptor in owner cluster
2160	assert( (CXY_FROM_PID( process_pid ) == process_cxy ) ,
2161	"process descriptor not in owner cluster" );
2162
2163	// release TXT ownership (does nothing if not TXT owner)
2164	process_txt_transfer_ownership( process_xp );
2165
2166	// get extended pointer on process stdin pseudo file
2167	file_xp = (xptr_t)hal_remote_l64( XPTR( process_cxy , &process_ptr->fd_array.array[0] ) );
2168
2169	// get pointers on TXT_RX chdev
2170	chdev_xp = chdev_from_file( file_xp );
2171	chdev_cxy = GET_CXY( chdev_xp );
2172	chdev_ptr = (chdev_t *)GET_PTR( chdev_xp );
2173
2174	// get extended pointer on lock protecting attached process list
2175	lock_xp = XPTR( chdev_cxy , &chdev_ptr->ext.txt.lock );
2176
2177	// get lock protecting list of processes attached to TXT
2178	remote_busylock_acquire( lock_xp );
2179
2180	// unlink process from attached process list
2181	xlist_unlink( XPTR( process_cxy , &process_ptr->txt_list ) );
2182
2183	// release lock protecting list of processes attached to TXT
2184	remote_busylock_release( lock_xp );
2185
2186	#if DEBUG_PROCESS_TXT
2187	thread_t * this = CURRENT_THREAD;
2188	uint32_t cycle = (uint32_t)hal_get_cycles();
2189	uint32_t txt_id = hal_remote_l32( XPTR( chdev_cxy , &chdev_ptr->channel ) );
2190	if( DEBUG_PROCESS_TXT < cycle )
2191	printk("\n[%s] thread[%x,%x] detached process %x from TXT%d / cycle %d\n",
2192	__FUNCTION__, this->process->pid, this->trdid, process_pid, txt_id, cycle );
2193	#endif
2194
2195	} // end process_txt_detach()
2196
2197	///////////////////////////////////////////////////
2198	void process_txt_set_ownership( xptr_t process_xp )
2199	{
2200	process_t * process_ptr;
2201	cxy_t process_cxy;
2202	pid_t process_pid;
2203	xptr_t file_xp;
2204	xptr_t txt_xp;
2205	chdev_t * txt_ptr;
2206	cxy_t txt_cxy;
2207
2208	// get pointers on process in owner cluster
2209	process_cxy = GET_CXY( process_xp );
2210	process_ptr = GET_PTR( process_xp );
2211	process_pid = hal_remote_l32( XPTR( process_cxy , &process_ptr->pid ) );
2212
2213	// check owner cluster
2214	assert( (process_cxy == CXY_FROM_PID( process_pid )) ,
2215	"process descriptor not in owner cluster" );
2216
2217	// get extended pointer on stdin pseudo file
2218	file_xp = hal_remote_l64( XPTR( process_cxy , &process_ptr->fd_array.array[0] ) );
2219
2220	// get pointers on TXT chdev
2221	txt_xp = chdev_from_file( file_xp );
2222	txt_cxy = GET_CXY( txt_xp );
2223	txt_ptr = GET_PTR( txt_xp );
2224
2225	// set owner field in TXT chdev
2226	hal_remote_s64( XPTR( txt_cxy , &txt_ptr->ext.txt.owner_xp ) , process_xp );
2227
2228	#if DEBUG_PROCESS_TXT
2229	thread_t * this = CURRENT_THREAD;
2230	uint32_t cycle = (uint32_t)hal_get_cycles();
2231	uint32_t txt_id = hal_remote_l32( XPTR( txt_cxy , &txt_ptr->channel ) );
2232	if( DEBUG_PROCESS_TXT < cycle )
2233	printk("\n[%s] thread[%x,%x] give TXT%d ownership to process %x / cycle %d\n",
2234	__FUNCTION__, this->process->pid, this->trdid, txt_id, process_pid, cycle );
2235	#endif
2236
2237	} // end process_txt_set ownership()
2238
2239	////////////////////////////////////////////////////////
2240	void process_txt_transfer_ownership( xptr_t process_xp )
2241	{
2242	process_t * process_ptr; // local pointer on process releasing ownership
2243	cxy_t process_cxy; // process cluster
2244	pid_t process_pid; // process identifier
2245	xptr_t file_xp; // extended pointer on TXT_RX pseudo file
2246	xptr_t txt_xp; // extended pointer on TXT_RX chdev
2247	chdev_t * txt_ptr; // local pointer on TXT_RX chdev
2248	cxy_t txt_cxy; // cluster of TXT_RX chdev
2249	uint32_t txt_id; // TXT_RX channel
2250	xptr_t owner_xp; // extended pointer on current TXT_RX owner
2251	xptr_t root_xp; // extended pointer on root of attached process list
2252	xptr_t lock_xp; // extended pointer on lock protecting attached process list
2253	xptr_t iter_xp; // iterator for xlist
2254	xptr_t current_xp; // extended pointer on current process
2255	bool_t found;
2256
2257	#if DEBUG_PROCESS_TXT
2258	thread_t * this = CURRENT_THREAD;
2259	uint32_t cycle;
2260	#endif
2261
2262	// get pointers on target process
2263	process_cxy = GET_CXY( process_xp );
2264	process_ptr = GET_PTR( process_xp );
2265	process_pid = hal_remote_l32( XPTR( process_cxy , &process_ptr->pid ) );
2266
2267	// check owner cluster
2268	assert( (process_cxy == CXY_FROM_PID( process_pid )) ,
2269	"process descriptor not in owner cluster" );
2270
2271	// get extended pointer on stdin pseudo file
2272	file_xp = hal_remote_l64( XPTR( process_cxy , &process_ptr->fd_array.array[0] ) );
2273
2274	// get pointers on TXT chdev
2275	txt_xp = chdev_from_file( file_xp );
2276	txt_cxy = GET_CXY( txt_xp );
2277	txt_ptr = GET_PTR( txt_xp );
2278
2279	// get relevant infos from chdev descriptor
2280	owner_xp = hal_remote_l64( XPTR( txt_cxy , &txt_ptr->ext.txt.owner_xp ) );
2281	txt_id = hal_remote_l32( XPTR( txt_cxy , &txt_ptr->channel ) );
2282
2283	// transfer ownership only if target process is the TXT owner
2284	if( (owner_xp == process_xp) && (txt_id > 0) )
2285	{
2286	// get extended pointers on root and lock of attached processes list
2287	root_xp = XPTR( txt_cxy , &txt_ptr->ext.txt.root );
2288	lock_xp = XPTR( txt_cxy , &txt_ptr->ext.txt.lock );
2289
2290	if( process_get_ppid( process_xp ) != 1 ) // target process is not KSH
2291	{
2292	// get lock
2293	remote_busylock_acquire( lock_xp );
2294
2295	// scan attached process list to find KSH process
2296	found = false;
2297	for( iter_xp = hal_remote_l64( root_xp ) ;
2298	(iter_xp != root_xp) && (found == false) ;
2299	iter_xp = hal_remote_l64( iter_xp ) )
2300	{
2301	current_xp = XLIST_ELEMENT( iter_xp , process_t , txt_list );
2302
2303	if( process_get_ppid( current_xp ) == 1 ) // current is KSH
2304	{
2305	// set owner field in TXT chdev
2306	hal_remote_s64( XPTR( txt_cxy , &txt_ptr->ext.txt.owner_xp ) , current_xp );
2307
2308	#if DEBUG_PROCESS_TXT
2309	cycle = (uint32_t)hal_get_cycles();
2310	if( DEBUG_PROCESS_TXT < cycle )
2311	printk("\n[%s] thread[%x,%x] transfered TXT%d ownership to KSH / cycle %d\n",
2312	__FUNCTION__, this->process->pid, this->trdid, txt_id, cycle );
2313	#endif
2314	found = true;
2315	}
2316	}
2317
2318	// release lock
2319	remote_busylock_release( lock_xp );
2320
2321	// It must exist a KSH process for each user TXT channel
2322	assert( (found == true), "KSH process not found for TXT%d", txt_id );
2323
2324	}
2325	else // target process is KSH
2326	{
2327	// get lock
2328	remote_busylock_acquire( lock_xp );
2329
2330	// scan attached process list to find another process
2331	found = false;
2332	for( iter_xp = hal_remote_l64( root_xp ) ;
2333	(iter_xp != root_xp) && (found == false) ;
2334	iter_xp = hal_remote_l64( iter_xp ) )
2335	{
2336	current_xp = XLIST_ELEMENT( iter_xp , process_t , txt_list );
2337
2338	if( current_xp != process_xp ) // current is not KSH
2339	{
2340	// set owner field in TXT chdev
2341	hal_remote_s64( XPTR( txt_cxy , &txt_ptr->ext.txt.owner_xp ) , current_xp );
2342
2343	#if DEBUG_PROCESS_TXT
2344	cycle = (uint32_t)hal_get_cycles();
2345	cxy_t current_cxy = GET_CXY( current_xp );
2346	process_t * current_ptr = GET_PTR( current_xp );
2347	uint32_t new_pid = hal_remote_l32( XPTR( current_cxy , &current_ptr->pid ) );
2348	if( DEBUG_PROCESS_TXT < cycle )
2349	printk("\n[%s] thread[%x,%x] transfered TXT%d ownership to process %x / cycle %d\n",
2350	__FUNCTION__,this->process->pid, this->trdid, txt_id, new_pid, cycle );
2351	#endif
2352	found = true;
2353	}
2354	}
2355
2356	// release lock
2357	remote_busylock_release( lock_xp );
2358
2359	// no more owner for TXT if no other process found
2360	if( found == false )
2361	{
2362	// set owner field in TXT chdev
2363	hal_remote_s64( XPTR( txt_cxy , &txt_ptr->ext.txt.owner_xp ) , XPTR_NULL );
2364
2365	#if DEBUG_PROCESS_TXT
2366	cycle = (uint32_t)hal_get_cycles();
2367	if( DEBUG_PROCESS_TXT < cycle )
2368	printk("\n[%s] thread[%x,%x] released TXT%d (no attached process) / cycle %d\n",
2369	__FUNCTION__, this->process->pid, this->trdid, txt_id, cycle );
2370	#endif
2371	}
2372	}
2373	}
2374	else
2375	{
2376
2377	#if DEBUG_PROCESS_TXT
2378	cycle = (uint32_t)hal_get_cycles();
2379	if( DEBUG_PROCESS_TXT < cycle )
2380	printk("\n[%s] thread[%x,%x] does nothing for process %x (not TXT owner) / cycle %d\n",
2381	__FUNCTION__, this->process->pid, this->trdid, process_pid, cycle );
2382	#endif
2383
2384	}
2385
2386	} // end process_txt_transfer_ownership()
2387
2388
2389	////////////////////////////////////////////////
2390	bool_t process_txt_is_owner( xptr_t process_xp )
2391	{
2392	// get local pointer and cluster of process in owner cluster
2393	cxy_t process_cxy = GET_CXY( process_xp );
2394	process_t * process_ptr = GET_PTR( process_xp );
2395
2396	// check calling thread execute in target process owner cluster
2397	pid_t process_pid = hal_remote_l32( XPTR( process_cxy , &process_ptr->pid ) );
2398	assert( (process_cxy == CXY_FROM_PID( process_pid )) ,
2399	"process descriptor not in owner cluster" );
2400
2401	// get extended pointer on stdin pseudo file
2402	xptr_t file_xp = hal_remote_l64( XPTR( process_cxy , &process_ptr->fd_array.array[0] ) );
2403
2404	// get pointers on TXT chdev
2405	xptr_t txt_xp = chdev_from_file( file_xp );
2406	cxy_t txt_cxy = GET_CXY( txt_xp );
2407	chdev_t * txt_ptr = GET_PTR( txt_xp );
2408
2409	// get extended pointer on TXT_RX owner process
2410	xptr_t owner_xp = hal_remote_l64( XPTR( txt_cxy , &txt_ptr->ext.txt.owner_xp ) );
2411
2412	return (process_xp == owner_xp);
2413
2414	} // end process_txt_is_owner()
2415
2416	////////////////////////////////////////////////
2417	xptr_t process_txt_get_owner( uint32_t channel )
2418	{
2419	xptr_t txt_rx_xp = chdev_dir.txt_rx[channel];
2420	cxy_t txt_rx_cxy = GET_CXY( txt_rx_xp );
2421	chdev_t * txt_rx_ptr = GET_PTR( txt_rx_xp );
2422
2423	return (xptr_t)hal_remote_l64( XPTR( txt_rx_cxy , &txt_rx_ptr->ext.txt.owner_xp ) );
2424
2425	} // end process_txt_get_owner()
2426
2427	///////////////////////////////////////////
2428	void process_txt_display( uint32_t txt_id )
2429	{
2430	xptr_t chdev_xp;
2431	cxy_t chdev_cxy;
2432	chdev_t * chdev_ptr;
2433	xptr_t root_xp;
2434	xptr_t lock_xp;
2435	xptr_t current_xp;
2436	xptr_t iter_xp;
2437	cxy_t txt0_cxy;
2438	chdev_t * txt0_ptr;
2439	xptr_t txt0_xp;
2440	xptr_t txt0_lock_xp;
2441
2442	assert( (txt_id < LOCAL_CLUSTER->nb_txt_channels) ,
2443	"illegal TXT terminal index" );
2444
2445	// get pointers on TXT0 chdev
2446	txt0_xp = chdev_dir.txt_tx[0];
2447	txt0_cxy = GET_CXY( txt0_xp );
2448	txt0_ptr = GET_PTR( txt0_xp );
2449
2450	// get extended pointer on TXT0 lock
2451	txt0_lock_xp = XPTR( txt0_cxy , &txt0_ptr->wait_lock );
2452
2453	// get pointers on TXT_RX[txt_id] chdev
2454	chdev_xp = chdev_dir.txt_rx[txt_id];
2455	chdev_cxy = GET_CXY( chdev_xp );
2456	chdev_ptr = GET_PTR( chdev_xp );
2457
2458	// get extended pointer on root & lock of attached process list
2459	root_xp = XPTR( chdev_cxy , &chdev_ptr->ext.txt.root );
2460	lock_xp = XPTR( chdev_cxy , &chdev_ptr->ext.txt.lock );
2461
2462	// get lock on attached process list
2463	remote_busylock_acquire( lock_xp );
2464
2465	// get TXT0 lock in busy waiting mode
2466	remote_busylock_acquire( txt0_lock_xp );
2467
2468	// display header
2469	nolock_printk("\n***** processes attached to TXT_%d / cycle %d\n",
2470	txt_id , (uint32_t)hal_get_cycles() );
2471
2472	// scan attached process list
2473	XLIST_FOREACH( root_xp , iter_xp )
2474	{
2475	current_xp = XLIST_ELEMENT( iter_xp , process_t , txt_list );
2476	process_display( current_xp );
2477	}
2478
2479	// release TXT0 lock in busy waiting mode
2480	remote_busylock_release( txt0_lock_xp );
2481
2482	// release lock on attached process list
2483	remote_busylock_release( lock_xp );
2484
2485	} // end process_txt_display

Note: See TracBrowser for help on using the repository browser.

Download in other formats: