kthread_create_on_node(9)

kthread_create_on_node9

Create a kthread.

Usage

struct task_struct * kthread_create_on_node(int (*threadfn) (void *data), void * data, int node, const char namefmt[], ...);

Arguments

threadfn

the function to run until signal_pending(current).

data

data ptr for threadfn.

node

memory node number.

namefmt[]

printf-style name for the thread.

...

variable arguments

Overview

This helper function creates and names a kernel thread. The thread will be stopped: use wake_up_process to start it. See also kthread_run.

If thread is going to be bound on a particular cpu, give its node in node, to get NUMA affinity for kthread stack, or else give -1. When woken, the thread will run threadfn() with data as its argument. threadfn() can either call do_exit directly if it is a standalone thread for which no one will call kthread_stop, or return when 'kthread_should_stop' is true (which means kthread_stop has been called). The return value should be zero or a negative error number; it will be passed to kthread_stop.

Returns a task_struct or ERR_PTR(-ENOMEM) or ERR_PTR(-EINTR).

Releases

2 releases since Debian 7 (Wheezy); the text changed 1 time.

  1. 7
  2. 8

From linux-manual-3.16 3.16.56-1+deb8u1 in Debian 8 (Jessie). Parsed by carta from the page's man source.