thread(9s) [osf1 man page]

thread(9s)																thread(9s)

NAME

       thread - General: Contains kernel threads-related information

SYNOPSIS

       ----------------------------
       Member Name   Data Type
       ----------------------------
       wait_result   kern_return_t
       ----------------------------

MEMBERS

       Specifies  the  outcome	of  the  wait. The kernel can set this member to one of the following values: THREAD_AWAKENED, THREAD_INTERRUPTED,
       THREAD_TIMED_OUT, THREAD_SHOULD_TERMINATE, and THREAD_RESTART.

DESCRIPTION

       The thread data structure contains kernel threads-related information. Kernel modules typically use the wait_result member (with  the  cur-
       rent_thread  routine)  to  check for the result of the wait. The values associated with the wait_result member have the following meanings:
       The result of the assert wait is a normal wakeup.  The wait condition was interrupted by the clear_wait routine.  The specified timeout has
       expired.  The result of the assert wait is that the current kernel thread should terminate.  The current kernel thread should be restarted.

NOTES

       The  header  file <thread.h> shows a typedef statement that assigns the alternate name thread_t for a pointer to the thread data structure.
       Many of the kernel threads-related routines operate on these pointers to thread data structures.

       The thread data structure is an opaque data structure; that is, all of its associated members (except for the wait_result member) are  ref-
       erenced and manipulated by the operating system and not by the user of kernel threads.

FILES

SEE ALSO

       Routines: clear_wait(9r), current_thread(9r), thread_block(9r), thread_set_timeout(9r), thread_wakeup(9r), thread_wakeup_one(9r)

																	thread(9s)

kernel_thread_w_arg(9r) 												   kernel_thread_w_arg(9r)

NAME

       kernel_thread_w_arg - General: Starts a kernel thread with a calling argument passed in

SYNOPSIS

       thread_t kernel_thread_w_arg(
	       task_t task,
	       void (*start) (void),
	       void* argument );

ARGUMENTS

       Specifies  a  pointer to a task structure.  This pointer identifies the task in which the kernel_thread_w_arg routine starts the newly cre-
       ated kernel thread.  Specifies a pointer to a routine that is the entry point for the newly created kernel thread.  Specifies the  argument
       that kernel_thread_w_arg passes to the entry point specified in start.

DESCRIPTION

       The  kernel_thread_w_arg  routine  creates  and	starts a kernel thread in the specified task at the specified entry point with a specified
       argument. The kernel_thread_w_arg routine passes the specified argument to the newly created kernel thread.  The  kernel_thread_w_arg  rou-
       tine  creates and starts a kernel thread with timeshare scheduling. A kernel thread created with timeshare scheduling means that its prior-
       ity degrades if it consumes an inordinate amount of CPU resources.  A kernel module should call kernel_thread_w_arg only  for  long-running
       tasks. A kernel module should always attach a kernel thread to the ``first task.''

NOTES

       This routine is actually a convenience wrapper for the thread_create routine (which creates the kernel thread) and the thread_start routine
       (which starts the newly created kernel thread).

       The kernel_thread_w_arg routine behaves identically to kernel_isrthread except that with kernel_thread_w_arg you can pass  an  argument	to
       the entry point for the newly created kernel thread.

RETURN VALUES

       Upon  successful completion, kernel_thread_w_arg returns a pointer to the thread structure associated with the kernel thread started at the
       specified entry point. Kernel modules can use this pointer as a handle to a specific kernel thread in calls to other kernel threads-related
       routines.

SEE ALSO

       Routines: kernel_isrthread(9r), thread_create(9r), thread_start(9r)

       Data Structures: task(9s), thread(9s)

															   kernel_thread_w_arg(9r)