Lunatik

• Index

Contents

• Class thread

Modules

• byteorder
• completion
• cpu
• crypto
• darken
• data
• device
• fib
• fifo
• hid
• lighten
• linux
• lunatik
• lunatik.runner
• mailbox
• net
• netfilter
• notifier
• probe
• rcu
• signal
• skb
• socket
• socket.inet
• socket.raw
• socket.unix
• syscall
• syscall.table
• thread
• xdp

Classes

• crypto.hkdf
• crypto_aead
• crypto_comp
• crypto_rng
• crypto_shash
• crypto_skcipher

Topics

• README

Module thread

Kernel thread primitives.

Class thread

Class thread

thread:current ()

Gets a thread object representing the current kernel task. If the current task was not created by thread.run(), the returned object will not have an associated Lunatik runtime.

Returns:

thread A thread object for the current task.

Usage:

local t = thread.current()

thread:run (runtime, name)

Creates and starts a new kernel thread to run a Lua task. The runtime must be sleepable; the script it loaded must return a function, which becomes the thread body.

Parameters:

• runtime runtime A sleepable Lunatik runtime whose script returns a function.
• name string A descriptive name for the kernel thread.

Returns:

thread A new thread object.

Raises:

Error if the runtime is not sleepable or if thread creation fails.

See also:

lunatik.runtime

thread:shouldstop ()

Checks if the current thread has been signaled to stop.

Returns:

boolean true if the thread should stop, false otherwise.

See also:

stop

Usage:

while not thread.shouldstop() do
  linux.schedule(100)
end

thread:stop (self)

Stops a running kernel thread. Signals the thread to stop and waits for it to exit.

Parameters:

• self thread thread object to stop.

Returns:

nil

Usage:

my_thread:stop()

thread:task (self)

Retrieves information about the kernel task associated with the thread.

Parameters:

• self thread thread object.

Returns:

table A table with fields: cpu (SMP only), command, pid, tgid.

Usage:

local info = my_thread:task()