Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   12896 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 created
       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 argu‐
       ment. The kernel_thread_w_arg routine passes the specified argument  to
       the  newly created kernel thread.  The kernel_thread_w_arg routine cre‐
       ates and starts a kernel thread with  timeshare	scheduling.  A	kernel
       thread  created	with  timeshare	 scheduling  means  that  its priority
       degrades if it consumes an inordinate amount of CPU resources.  A  ker‐
       nel 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)

Vote for polarhome