source: trunk/kernel/kern/process.h @ 436

Last change on this file since 436 was 436, checked in by alain, 6 years ago

1) improve the threads and process destruction mechanism.
2) introduce FIFOs in the soclib_tty driver.

File size: 35.4 KB
RevLine 
[1]1/*
2 * process.h - process related management functions
[173]3 *
[1]4 * Authors  Ghassan Almaless (2008,2009,2010,2011,2012)
5 *          Mohamed Lamine Karaoui (2015)
[433]6 *          Alain Greiner (2016,2017,2018)
[1]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#ifndef _PROCESS_H_
27#define _PROCESS_H_
28
[14]29#include <kernel_config.h>
[1]30#include <errno.h>
31#include <hal_types.h>
32#include <list.h>
33#include <xlist.h>
34#include <bits.h>
35#include <spinlock.h>
36#include <hal_atomic.h>
37#include <vmm.h>
38#include <cluster.h>
39#include <vfs.h>
40
41/****  Forward declarations  ****/
42
43struct thread_s;
44
45/*********************************************************************************************
46 * These macros are used to compose or decompose global process identifier (PID)
47 * to or from cluster identifier / local process index (CXY , LPID)
48 ********************************************************************************************/
49
50#define LPID_FROM_PID( pid )       (lpid_t)(pid & 0x0000FFFF)
51#define CXY_FROM_PID( pid )        (cxy_t)(pid >> 16)
52#define PID( cxy , lpid )          (pid_t)((cxy << 16) | lpid )
53
54/*********************************************************************************************
[428]55 * This enum defines the actions that can be executed by the process_sigaction() function.
[409]56 ********************************************************************************************/
57
58enum process_sigactions
59{
[436]60    BLOCK_ALL_THREADS    = 0x11,
61    UNBLOCK_ALL_THREADS  = 0x22,
62    DELETE_ALL_THREADS   = 0x33, 
[409]63};
64
65/*********************************************************************************************
[1]66 * This structure defines an array of extended pointers on the open file descriptors
67 * for a given process. We use an extended pointer because the open file descriptor
68 * is always stored in the same cluster as the inode associated to the file.
69 * A free entry in this array contains the XPTR_NULL value.
70 * The array size is defined by a the CONFIG_PROCESS_FILE_MAX_NR parameter.
[23]71 * All modifications (open/close) in this structure must be done by the reference cluster,
72 * and reported in process copies.
[1]73 ********************************************************************************************/
74
75typedef struct fd_array_s
76{
[101]77        remote_spinlock_t lock;                               /*! lock protecting fd_array      */
78    uint32_t          current;                            /*! current number of open files  */
79        xptr_t            array[CONFIG_PROCESS_FILE_MAX_NR];  /*! xptr on open file descriptors */
[1]80}
81fd_array_t;
82
83/*********************************************************************************************
84 * This structure defines a process descriptor.
85 * A process is identified by a unique PID (process identifier):
86 * - The PID 16 LSB bits contain the LPID (Local Process Index)
87 * - The PID 16 MSB bits contain the owner cluster CXY.
[409]88 * In each cluster, the process manager allocates  the LPID values for the process that
89 * are owned by this cluster.
90 * The process descriptor is replicated in all clusters containing at least one thread
91 * of the PID process, with the following rules :
[23]92 * 1) The <pid>, <ppid>, <ref_xp>, <vfs_root_xp>, <vfs_bin_xp>  fields are defined
93 *    in all process descriptor copies.
94 * 2) The <vfs_cwd_xp> and associated <cwd_lock>, that can be dynamically modified,
95 *    are only defined in the reference process descriptor.
[409]96 * 2) The <vmm>, containing the VSL (list of registered vsegs), and the GPT (generic
97 *    page table), are only complete in the reference process cluster, other copies
98 *    are actually use as read-only caches.
[23]99 * 3) the <fd_array>, containing extended pointers on the open file descriptors, is only
100 *    complete in the reference process cluster, other copies are read-only caches.
[173]101 * 4) The <sem_root>, <mutex_root>, <barrier_root>, <condvar_root>, and the associated
[23]102 *    <sync_lock>, that are dynamically allocated, are only defined in the reference cluster.
[428]103 * 5) The <children_root>, <children_nr>, <brothers_list>, and <txt_list> fields are only
104 *    defined in the reference cluster, and are undefined in other clusters.
105 * 6) The <local_list>, <copies_list>, <th_tbl>, <th_nr>, <th_lock> fields
[23]106 *    are defined in all process descriptors copies.
[433]107 * 7) The termination <flags> and <exit_status> are only defined in the reference cluster.
[1]108 ********************************************************************************************/
109
110typedef struct process_s
111{
[23]112        vmm_t             vmm;              /*! embedded virtual memory manager                 */
[1]113
[23]114        fd_array_t        fd_array;         /*! embedded open file descriptors array            */
[1]115
[173]116        xptr_t            vfs_root_xp;      /*! extended pointer on current VFS root inode      */
[428]117        xptr_t            vfs_bin_xp;       /*! extended pointer on .elf file descriptor        */
[23]118        pid_t             pid;              /*! process identifier                              */
119    xptr_t            ref_xp;           /*! extended pointer on reference process           */
[428]120    xptr_t            parent_xp;        /*! extended pointer on parent process              */
[1]121
[23]122        xptr_t            vfs_cwd_xp;       /*! extended pointer on current working dir inode   */
123        remote_rwlock_t   cwd_lock;         /*! lock protecting working directory changes       */
[173]124
[23]125        xlist_entry_t     children_root;    /*! root of the children process xlist              */
[428]126    remote_spinlock_t children_lock;    /*! lock protecting children process xlist          */
[23]127    uint32_t          children_nr;      /*! number of children processes                    */
[1]128
[428]129        xlist_entry_t     children_list;    /*! member of list of children of same parent       */
[23]130    xlist_entry_t     local_list;       /*! member of list of process in same cluster       */
131    xlist_entry_t     copies_list;      /*! member of list of copies of same process        */
[428]132    xlist_entry_t     txt_list;         /*! member of list of processes sharing same TXT    */
[1]133
[23]134        spinlock_t        th_lock;          /*! lock protecting th_tbl[] concurrent access      */
135        uint32_t          th_nr;            /*! number of threads in this cluster               */
[428]136
[23]137        struct thread_s * th_tbl[CONFIG_THREAD_MAX_PER_CLUSTER]; /*! pointers on local threads  */
[1]138
[23]139    xlist_entry_t     sem_root;         /*! root of the process semaphore list              */
140    xlist_entry_t     mutex_root;       /*! root of the process mutex list                  */
141    xlist_entry_t     barrier_root;     /*! root of the process barrier list                */
142    xlist_entry_t     condvar_root;     /*! root of the process condvar list                */
[428]143    remote_spinlock_t sync_lock;        /*! lock protecting sem,mutex,barrier,condvar lists */
[1]144
[433]145    uint32_t          term_state;       /*! termination status (flags & exit status)        */
[428]146
147    bool_t            txt_owner;        /*! current TXT owner                               */
[1]148}
149process_t;
150
151/*********************************************************************************************
[101]152 * This structure defines the information required by the process_make_exec() function
[409]153 * to create a new reference process descriptor, and the associated main thread.
[1]154 ********************************************************************************************/
155
156typedef struct exec_info_s
157{
[23]158    char               path[CONFIG_VFS_MAX_PATH_LENGTH];   /*!  .elf file path              */
[1]159
160    char            ** args_pointers;  /*! physical base address of array of pointers       */
161    char             * args_buf_base;  /*! physical base address of kernel args buffer      */
162    uint32_t           args_nr;        /*! actual number of arguments                       */
163
164    char            ** envs_pointers;  /*! physical base address of array of pointers       */
165    char             * envs_buf_base;  /*! physical base address of kernel args buffer      */
166    char             * envs_buf_free;  /*! physical address of first free slot in envs_buf  */
167    uint32_t           envs_nr;        /*! actual number of environment variables           */
168}
169exec_info_t;
170
171/***************   Process Descriptor Operations    *****************************************/
172
[173]173/*********************************************************************************************
174 * This function allocates memory in local cluster for a process descriptor.
175 *********************************************************************************************
[1]176 * @ returns pointer on process descriptor if success / return NULL if failure
177 ********************************************************************************************/
178process_t * process_alloc();
179
[173]180/*********************************************************************************************
181 * This function releases memory in local cluster for a process descriptor.
182 *********************************************************************************************
[1]183 * @ process      : pointer on process descriptor to release.
184 ********************************************************************************************/
185void process_free( process_t * process );
186
[173]187/*********************************************************************************************
[428]188 * This function initialize, in each cluster, the kernel "process_zero", that is the owner
189 * of all kernel threads in a given cluster. It is called by the kernel_init() function.
190 * The process_zero descriptor is allocated as a global variable in file kernel_init.c
191 * Both the PID and PPID fields are set to zero, the ref_xp is the local process_zero,
192 * and the parent process is set to XPTR_NULL. The th_tbl[] is initialized as empty.
193 *********************************************************************************************
194 * @ process      : [in] pointer on local process descriptor to initialize.
195 ********************************************************************************************/
196void process_zero_create( process_t * process );
197
198/*********************************************************************************************
[173]199 * This function allocates memory and initializes the "process_init" descriptor and the
[409]200 * associated "thread_init" descriptor. It is called once at the end of the kernel
[428]201 * initialisation procedure. Its local process identifier is 1, and parent process
202 * is the kernel process in cluster 0.
[173]203 * The "process_init" is the first user process, and all other user processes will be forked
[101]204 * from this process. The code executed by "process_init" is stored in a .elf file, whose
[409]205 * pathname is defined by the CONFIG_PROCESS_INIT_PATH configuration variable.
[428]206 * The process_init does not use the [STDIN/STDOUT/STDERR] streams, but it is linked
207 * to kernel TXT0, because these streams must be defined for all user processes.
[173]208 ********************************************************************************************/
[1]209void process_init_create();
210
[173]211/*********************************************************************************************
[428]212 * This function initializes a local, reference, user process descriptor from another process
213 * descriptor, defined by the <model_xp> argument. The <process> and <pid> arguments must
214 * be previously allocated by he caller. This function can be called by three functions:
215 * 1) process_init_create() : process is the reference INIT process / pid = 1 /
216 *    the parent and model process descriptors are both the kernel process_zero.
217 * 2) process_make_fork() : the model process descriptor is the (generally remote)
218 *    parent process.
219 * 3) process_make exec() : the model process is the local old_process, the new_process
220 *    parent is the same as the old_process parent.
221 * The following fields are initialised :
222 * - It set the pid / ppid / ref_xp / parent_xp / state fields.
[409]223 * - It initializes the VMM (register the kentry, args, envs vsegs in VSL)
[408]224 * - It initializes the FDT, defining the three pseudo files STDIN / STDOUT / STDERR.
225 * - It set the root_xp, bin_xp, cwd_xp fields.
226 * - It reset the children list as empty, but does NOT register it in parent children list.
227 * - It reset the TH_TBL list of threads as empty.
228 * - It reset the semaphore / mutex / barrier / condvar lists as empty.
229 * - It registers the process in the local_list, rooted in the local cluster manager.
230 * - It registers the process in the copies_list, rooted in the owner cluster manager.
231 * - It registers the process extended pointer in the local pref_tbl[] array.
232 *********************************************************************************************
233 * @ process      : [in] pointer on local process descriptor to initialize.
234 * @ pid          : [in] process identifier.
[428]235 * @ parent_xp    : [in] extended pointer on parent process descriptor.
236 * @ model_xp     : [in] extended pointer on model process descriptor.
[408]237 ********************************************************************************************/
[1]238void process_reference_init( process_t * process,
239                             pid_t       pid,
[428]240                             xptr_t      parent_xp,
[408]241                             xptr_t      model_xp );
[1]242
[173]243/*********************************************************************************************
244 * This function initializes a copy process descriptor, in the local cluster,
245 * from information defined in the reference remote process descriptor.
246 *********************************************************************************************
[1]247 * @ process              : [in] local pointer on process descriptor to initialize.
248 * @ reference_process_xp : [in] extended pointer on reference process descriptor.
249 * @ return 0 if success / return ENOMEM if failure
250 ********************************************************************************************/
251error_t process_copy_init( process_t * local_process,
252                           xptr_t      reference_process_xp );
253
[173]254/*********************************************************************************************
[1]255 * This function releases all memory allocated for a process descriptor in the local cluster,
[23]256 * including memory allocated for embedded substructures (fd_array, vmm, etc).
[1]257 * The local th_tbl[] array must be empty.
[173]258 *********************************************************************************************
[1]259 * @ process     : pointer on the process descriptor.
260 ********************************************************************************************/
261void process_destroy( process_t * process );
262
[173]263/*********************************************************************************************
[428]264 * This debug function diplays on the kernel terminal TXT0 detailed informations on a
265 * reference process identified by the <process_xp> argument.
266 * It can be called by a thread running in any cluster.
267 *********************************************************************************************
268 * @ process_xp : extended pointer on reference process.
269 ********************************************************************************************/
270void process_display( xptr_t process_xp );
271
272/*********************************************************************************************
273 * This function returns a printable string defining the sigaction type.
274 *********************************************************************************************
275 * @ sigaction_type   : BLOCK_ALL_THREADS / UNBLOCK_ALL_THREADS / DELETE_ALL_THREADS
276 * @ return a string pointer.
277 ********************************************************************************************/
278char * process_action_str( uint32_t sigaction_type );
279
280/*********************************************************************************************
[435]281 * This function allows a client thread running in any cluster to block, unblock or delete
282 * all threads of a process identified by the <pid> argument, depending on the
[436]283 * <action_type> argument.
284 * WARNING : the DELETE action is NOT executed on the target process main thread
285 * (thread 0 in process owner cluster).
286 * It uses the multicast, non blocking rpc_process_sigaction_client() function to send
287 * parallel requests to all remote clusters containing a process copy.
288 * Then it blocks and deschedule to wait completion of these parallel requests.
289 *
[416]290 * It is used by the sys_kill() & sys_exit() functions to handle the "kill" & "exit" syscalls.
291 * It is also used by the process_make_exec() function to handle the "exec" syscall.
[436]292 * It is also called by the TXT device ISR to execute the ctrl C & ctrl Z commands.
293 *
294 * Implementation note:
295 * This function allocates a - shared - RPC descriptor in client thread stack,
296 * and initializes it. This RPC descriptor can be shared because all parallel,
297 * non-blocking, RPC server threads use the same input arguments, including the
298 * RPC responses counter field.
[409]299 *********************************************************************************************
[435]300 * @ pid         : target process identifier.
[416]301 * @ action_type : BLOCK_ALL_THREADS / UNBLOCK_ALL_THREADS / DELETE_ALL_THREADS
[1]302 ********************************************************************************************/
[435]303void process_sigaction( pid_t       pid,
[409]304                        uint32_t    action_type );
[1]305
[173]306/*********************************************************************************************
[436]307 * This function blocks all threads - but the main thread - for a given <process>
308 * in a given cluster. It sets the THREAD_BLOCKED_GLOBAL bit in the thread descriptor,
[416]309 * and request the relevant schedulers to acknowledge the blocking, using IPI if required.
310 * The threads are not detached from the scheduler, and not detached from the local process.
311 * This function returns only when all blockable threads in cluster are actually blocked.
[409]312 *********************************************************************************************
313 * @ process     : pointer on the target process descriptor.
314 ********************************************************************************************/
[433]315void process_block_threads( process_t * process );
[409]316
317/*********************************************************************************************
318 * This function unblocks all threads of a given user process in a given cluster.
319 *********************************************************************************************
320 * @ process     : pointer on the process descriptor.
321 ********************************************************************************************/
[428]322void process_unblock_threads( process_t * process );
[409]323
324/*********************************************************************************************
[436]325 * This function marks for deletion all threads - but the main thread - for a given <process>
326 * in a given cluster. It sets the THREAD_FLAG_REQ_DELETE bit. For each marked thread,
327 * the following actions will be done by the scheduler at the next scheduling point:
[416]328 * - the thread will be detached from the scheduler.
329 * - the thread will be detached from the local process descriptor.
330 * - the thread will be detached from parent if required.
331 * - the memory allocated to the thread descriptor is released.
332 * - the memory allocated to the process descriptor is released, if it is the last thread.
[409]333 *********************************************************************************************
334 * @ process     : pointer on the process descriptor.
335 ********************************************************************************************/
[433]336void process_delete_threads( process_t * process );
[409]337
338/*********************************************************************************************
[1]339 * This function returns a pointer on the local copy of a process identified by its PID.
[173]340 * If this local copy does not exist yet, it is dynamically created, from the reference
[1]341 * process descriptor, registered in the global copies_list, and registered in the local_list.
[23]342 * This function is used by the thread_user_create() function.
[173]343 *********************************************************************************************
[1]344 * @ pid     : searched process identifier.
345 * @ returns pointer on the local process descriptor if success / returns NULL if failure.
346 ********************************************************************************************/
347process_t * process_get_local_copy( pid_t pid );
348
[173]349/*********************************************************************************************
[436]350 * This function returns the parent process identifier for a remote process descriptor
351 * identified by an extended pointer.
352 *********************************************************************************************
353 * @ process_xp   : extended pointer on remote process descriptor.
354 * @ returns parent process dentifier.
355 ********************************************************************************************/
356pid_t process_get_ppid( xptr_t process_xp );
357
358/*********************************************************************************************
[409]359 * This function implements the "exec" system call, and is called by the sys_exec() function.
[408]360 * The "new" process keep the "old" process PID and PPID, all open files, and env variables,
361 * the vfs_root and vfs_cwd, but build a brand new memory image (new VMM from the new .elf).
[409]362 * It actually creates a "new" reference process descriptor, and copies all relevant
363 * information from the "old" process descriptor to the "new" process descriptor.
[408]364 * It completes the "new" process descriptor, from information found in the <exec_info>
365 * structure (defined in the process.h file), that must be built by the caller.
366 * It creates and initializes the associated main thread. It finally destroys all copies
[409]367 * of the "old" process in all clusters, and destroys all old associated threads.
[408]368 * It is executed in the local cluster, that becomes both the "owner" and the "reference"
369 * cluster for the "new" process.
[173]370 *********************************************************************************************
[1]371 * @ exec_info   : [in]  pointer on the exec_info structure.
372 * @ return 0 if success / return non-zero if error.
373 ********************************************************************************************/
374error_t process_make_exec( exec_info_t * exec_info );
375
[408]376/*********************************************************************************************
[409]377 * This function implements the "fork" system call, and is called by the sys_fork() function.
[408]378 * It allocates memory and initializes a new "child" process descriptor, and the
379 * associated "child" thread descriptor in the local cluster. This function can involve
380 * up to three different clusters :
[433]381 * - the child (local) cluster can be any cluster defined by the sys_fork function.
[409]382 * - the parent cluster must be the reference cluster for the parent process.
383 * - the client cluster containing the thread requesting the fork can be any cluster.
[408]384 * The new "child" process descriptor is initialised from informations found in the "parent"
385 * reference process descriptor, containing the complete process description.
386 * The new "child" thread descriptor is initialised from informations found in the "parent"
387 * thread descriptor.
388 *********************************************************************************************
389 * @ parent_process_xp  : extended pointer on the reference parent process.
390 * @ parent_thread_xp   : extended pointer on the parent thread requesting the fork.
391 * @ child_pid          : [out] child process identifier.
392 * @ child_thread_ptr   : [out] local pointer on child thread in target cluster.
393 * @ return 0 if success / return non-zero if error.
394 ********************************************************************************************/
395error_t process_make_fork(  xptr_t             parent_process_xp,
396                            xptr_t             parent_thread_xp,
397                            pid_t            * child_pid, 
398                            struct thread_s ** child_thread_ptr );
[1]399
[409]400
[173]401/********************   File Management Operations   ****************************************/
[1]402
403/*********************************************************************************************
[173]404 * This function initializes all entries of the local fd_array as empty.
405 *********************************************************************************************
[1]406 * @ process  : pointer on the local process descriptor.
407 ********************************************************************************************/
408void process_fd_init( process_t * process );
409
410/*********************************************************************************************
[23]411 * This function uses as many remote accesses as required, to reset an entry in fd_array[],
[407]412 * in all clusters containing a copy. The entry is identified by the <fdid> argument.
[173]413 * This function must be executed by a thread running reference cluster, that contains
[23]414 * the complete list of process descriptors copies.
[173]415 *********************************************************************************************
[1]416 * @ process  : pointer on the local process descriptor.
[407]417 * @ fdid     : file descriptor index in the fd_array.
[1]418 ********************************************************************************************/
[23]419void process_fd_remove( process_t * process,
[407]420                        uint32_t    fdid );
[1]421
422/*********************************************************************************************
[173]423 * This function returns an extended pointer on a file descriptor identified by its index
[23]424 * in fd_array. It can be called by any thread running in any cluster.
[173]425 * It accesses first the local process descriptor. In case of local miss, it uses remote
426 * access to access the reference process descriptor.
427 * It updates the local fd_array when the file descriptor exists in reference cluster.
[23]428 * The file descriptor refcount is not incremented.
[173]429 *********************************************************************************************
[1]430 * @ process  : pointer on the local process descriptor.
[407]431 * @ fdid     : file descriptor index in the fd_array.
[23]432 * @ return extended pointer on file descriptor if success / return XPTR_NULL if not found.
[1]433 ********************************************************************************************/
[23]434xptr_t process_fd_get_xptr( process_t * process,
[407]435                            uint32_t    fdid );
[1]436
437/*********************************************************************************************
[173]438 * This function checks the number of open files for a given process.
[23]439 * It can be called by any thread in any cluster, because it uses portable remote access
440 * primitives to access the reference process descriptor.
[173]441 *********************************************************************************************
[23]442 * @ returns true if file descriptor array full.
[1]443 ********************************************************************************************/
[23]444bool_t process_fd_array_full();
[1]445
446/*********************************************************************************************
[23]447 * This function allocates a free slot in the fd_array of the reference process,
448 * register the <file_xp> argument in the allocated slot, and return the slot index.
449 * It can be called by any thread in any cluster, because it uses portable remote access
450 * primitives to access the reference process descriptor.
[173]451 *********************************************************************************************
[23]452 * @ file_xp  : extended pointer on the file descriptor to be registered.
[407]453 * @ fdid     : [out] buffer for fd_array slot index.
[23]454 * @ return 0 if success / return EMFILE if array full.
[1]455 ********************************************************************************************/
[407]456error_t process_fd_register( process_t * process,
457                             xptr_t      file_xp,
458                             uint32_t  * fdid );
[1]459
460/*********************************************************************************************
[409]461 * This function copies all non-zero entries (other than the three first stdin/stdout/stderr)
462 * from a remote <src_xp> fd_array, embedded in a process descriptor, to another remote
463 * <dst_xp> fd_array, embedded in another process descriptor.
464 * The calling thread can be running in any cluster.
[1]465 * It takes the remote lock protecting the <src_xp> fd_array during the copy.
[173]466 * For each involved file descriptor, the refcount is incremented.
467 *********************************************************************************************
[1]468 * @ dst_xp   : extended pointer on the destination fd_array_t.
469 * @ src_xp   : extended pointer on the source fd_array_t.
470 ********************************************************************************************/
471void process_fd_remote_copy( xptr_t dst_xp,
472                             xptr_t src_xp );
473
474
[23]475
[173]476/********************   Thread Related Operations   *****************************************/
[1]477
478/*********************************************************************************************
479 * This function registers a new thread in the local process descriptor.
480 * It checks that there is an available slot in the local th_tbl[] array,
481 * allocates a new LTID, and registers the new thread in the th_tbl[].
482 * WARNING : the lock protecting the th_tbl[] must be taken by the caller.
[173]483 *********************************************************************************************
[1]484 * @ process  : pointer on the local process descriptor.
485 * @ thread   : pointer on new thread to be registered.
486 * @ trdid    : [out] address of buffer for allocated trdid.
487 * @ returns 0 if success / returns non zero if no slot available.
488 ********************************************************************************************/
489error_t process_register_thread( process_t       * process,
490                                 struct thread_s * thread,
491                                 trdid_t         * trdid );
492
493/*********************************************************************************************
494 * This function removes a thread registration from the local process descriptor.
495 * WARNING : the lock protecting the th_tbl[] must be taken by the caller.
[173]496 *********************************************************************************************
[1]497 * @ thread   : local pointer on thread to be removed.
498 ********************************************************************************************/
499void process_remove_thread( struct thread_s * thread );
500
501
[428]502/***************   Terminals related operations  ********************************************/
[1]503
[428]504/*********************************************************************************************
505 * This function scan the set of user TXT terminals to find a free terminal
506 * (the list of attached processes is empty for a free TXT terminal).
507 * It is called only by the process_reference_init() function when creating a KSH process.
508 * It makes a kernel panic if no free TXT terminal is found.
509 * As a KSH process is never deleted, the allocated TXT terminal is never released.
510 *********************************************************************************************
511 * @ return TXT terminal index if succes / kernel panic if no terminal found.
512 ********************************************************************************************/
513uint32_t process_txt_alloc();
514
515/*********************************************************************************************
[436]516 * This function attach a process descriptor in owner cluster, identified by the <process>
[428]517 * argument to a TXT terminal, identified by its <txt_id> channel index argument.
518 * It insert the process descriptor in the xlist rooted in the TXT_RX device.
519 * It is called by the process_reference_init() function.
520 *********************************************************************************************
521 * @ process  : local pointer on process descriptor.
522 * @ txt_id   : TXT channel index.
523 ********************************************************************************************/
524void process_txt_attach( process_t * process,
525                         uint32_t    txt_id );
526
527/*********************************************************************************************
[436]528 * This function detach a process, identified by the <process_xp> argument,
529 * from the list of process attached to a given TXT terminal.
530 * The target process descriptor must be in the owner cluster, but the calling thread can
531 * be running in any cluster.
[428]532 *********************************************************************************************
[436]533 * @ process_xp  : extended pointer on process descriptor.
[428]534 ********************************************************************************************/
[436]535void process_txt_detach( xptr_t  process_xp );                     
[428]536
537/*********************************************************************************************
[436]538 * This function gives to a process identified by the <owner_xp> argument, and attached
[428]539 * to terminal TXT[i] the exclusive ownership of the TXT_RX[i] terminal.
[436]540 * The process descriptor must be in the process owner cluster.
[428]541 *********************************************************************************************
[436]542 * @ owner_xp  : extended pointer on process descriptor in owner cluster.
[428]543 ********************************************************************************************/
[436]544void process_txt_set_ownership( xptr_t owner_xp );
[428]545
546/*********************************************************************************************
[436]547 * When the process dentified by the <owner_xp> argument has the exclusive ownership of
548 * the TXT_RX terminal, this function transfer this ownership to another attached process.
549 * The process descriptor must be in the process owner cluster.
550 * This function does nothing if the <pid> process is not the owner.
551 * - If the current owner is not the KSH process, the new owner is the KSH process.
552 * - If the <pid> process is the the KSH process, the new owner is another attached process.
553 * - If there is no other attached process, the TXT has no more defined owner.
[428]554 *********************************************************************************************
[436]555 * @ owner_xp  : extended pointer on process descriptor in owner cluster.
[428]556 ********************************************************************************************/
[436]557void process_txt_transfer_ownership( xptr_t owner_xp );
[428]558
[435]559/*********************************************************************************************
[436]560 * This function returns the TXT owner process (foreground process)
[435]561 * for a given TXT terminal identified by its <channel> index.
562 *********************************************************************************************
563 * @ channel  : TXT terminal channel.
[436]564 * @ return extentded pointer on TXT owner process in owner cluster.
[435]565 ********************************************************************************************/
[436]566xptr_t process_txt_get_owner( uint32_t channel );
[435]567
568/*********************************************************************************************
569 * This debug function diplays on the kernel terminal the list of processes attached
570 * to a given terminal identified by the <txt_id> argument.
571 *********************************************************************************************
572 * @ txt_id  : TXT terminal channel.
573 ********************************************************************************************/
574void process_txt_display( uint32_t txt_id );
575
576
[1]577#endif  /* _PROCESS_H_ */
Note: See TracBrowser for help on using the repository browser.