/* taskArchLib.c - architecture-specific task management routines *//* Copyright 1984-2001 Wind River Systems, Inc. *//*modification history--------------------01j,05jun02,wsl  remove reference to SPARC and i96001i,20nov01,hdn  updated x86 specific sections01h,14nov01,hbh  Updated for simulators.01g,03mar00,zl   merged SH support into T201f,12mar99,p_m  Fixed SPR 20355 by documenting taskSRInit() for MIPS.01e,25nov95,jdi  removed 29k stuff.01d,10feb95,rhp  Update for R4000, 29K, i386/i486.            jdi  changed 80960 to i960.01c,15feb93,jdi  made NOMANUAL: taskACWGet(), taskACWSet(), taskPCWGet(),		 taskPCWSet(), taskSRInit(), taskTCWGet(), taskTCWSet().01b,20jan93,jdi  documentation cleanup.01a,23sep92,jdi  written, based on taskArchLib.c for		 mc68k, sparc, i960, mips.*//*DESCRIPTIONThis library provides architecture-specific task management routines that setand examine architecture-dependent registers.  For information aboutarchitecture-independent task management facilities, see the manual entryfor taskLib.NOTE: There are no application-level routines in taskArchLib forSimSolaris, SimNT or SH.INCLUDE FILES: regs.h, taskArchLib.hSEE ALSO: taskLib*//********************************************************************************* taskSRSet - set the task status register (MC680x0, MIPS, x86)** This routine sets the status register of a task that is not running* (i.e., the TCB must not be that of the calling task).* Debugging facilities use this routine to set the trace bit in the * status register of a task that is being single-stepped.** .IP `x86':* The second parameter represents EFLAGS register and the size is 32 bit.** RETURNS: OK, or ERROR if the task ID is invalid.*/STATUS taskSRSet    (    int     tid,         /* task ID */    UINT16  sr           /* new SR  */    )    {    ...    }/******************************************************************************** taskPCWGet - get the task processor control word (i960)** This routine gets the task processor control word (PCW).** RETURNS: The PCW of the specified task.** NOMANUAL*/int taskPCWGet    (    INT32	tid		/* task ID */    )    {    ...    }/********************************************************************************* taskPCWSet - set the task processor control word (i960)** This routine sets the processor control word of a non-executing task* (i.e., the TCB must not be that of the calling task).** RETURNS: OK, or ERROR if the task ID is invalid.** NOMANUAL*/STATUS taskPCWSet    (    INT32 	tid, 		/* task ID */    UINT32 	pcw		/* new PCW */    )    {    ...    }/******************************************************************************** taskACWGet - get the task arithmetic control word (i960)** This routine gets the task arithmetic control word (ACW).** RETURNS: The ACW of a specified task.** NOMANUAL*/int taskACWGet    (    INT32	tid	/* task ID */    )    {    ...    }/********************************************************************************* taskACWSet - set the task arithmetic control word (i960)** This routine sets the arithmetic control word of a non-executing task* (i.e., the TCB must not be that of the calling task).** RETURNS: OK, or ERROR if the task ID is invalid.** NOMANUAL*/STATUS taskACWSet    (    INT32 	tid, 	/* task ID */    UINT32 	acw	/* new ACW */    )    {    ...    }/******************************************************************************** taskTCWGet - get the task trace control word (i960)** This routine gets the task trace control word (TCW).** RETURNS: The TCW of a specified task.** NOMANUAL*/int taskTCWGet    (    INT32 tid		/* task ID */    )    {    ...    }/********************************************************************************* taskTCWSet - set the task trace control word (i960)** This routine sets the trace control word (TCW) of a non-executing * task (i.e., the TCB must not be that of the calling * task).  It is used by the debugging facilities to set the trace mode * in the TCW of a task being debugged.** RETURNS: OK, or ERROR if the task ID is invalid.** NOMANUAL*/STATUS taskTCWSet    (    INT32 	tid, 		/* task ID */    UINT32 	tcw		/* new TCW */    )    {    ...    }/********************************************************************************* taskSRInit - initialize the default task status register (MIPS)** This routine sets the default status register for system-wide tasks.* All tasks will be spawned with the status register set to this value; thus, * it must be called before kernelInit().** RETURNS: The previous value of the default status register.*/ULONG taskSRInit    (    ULONG  newSRValue 	/* new default task status register  */    )    {    ...    }