Synopsis:

        task_hangup(task_id)

Arguments:

     task_id = The id of the task to send the hangup signal to. second to put the task to sleep.

Description:   This function sends a hangup signal to the specified task ID which will cause the specified task to jump immediately into its onsignal function.     If the task specified does not have an onsignal function declared then the signal will be ignored and the task will carry on processing as normal.      If the task specified has called task_defersig(1) one or more times then the jump to onsignal will be deferred until the task clears all defers (either by calling task_defersig(0) the corresponding number of times or by calling task_clrdefer())

Return Value:

Returns 0 is call was succesfull, -1 if invalid task ID is specified.    No indication is returned as to whether the specified task actually jumped to its onsignal function.