Your company here, and a link to your site. Click to find out more.

stalld - Man Page

detect starving threads and boost them


stalld [ -l ] [ -v ] [ -k ] [ -s ] [ -f ] [ -h ] [ -c cpu-list] [ -p time-in-ns ] [ -r time-in-ns ] [ -d time-in-sec ] [ -t time-in-sec ] [ -i regexes-of-thread-names ] [ -I regexes-of-process-names ] [ -R percentage ] [ -a cpu-list ]


stalld is a system daemon that monitors thread for the starvation condition. Starvation occurs when a thread sits on a cpu run-queue for longer than the starvation-threshold, meaning the thread has not been allowed to run for threshold seconds. The thread is boosted using the SCHED_DEADLINE policy and given a time period to run. Once it uses this boost period, the thread is returned to its original scheduling policy.



how long (in seconds) a thread must starve before being boosted [60 s]


SCHED_DEADLINE period in nanoseconds for a starving thread [1000000000 ns]


SCHED_DEADLINE runtime in nanoseconds for a starving thread [20000 ns]


duration in seconds the starving thread will run [ 3 s]


force using SCHED_FIFO for boosting


only log information, do no boosting [false]


print action informtion to stdout [false]


log information to the kernel buffer [false]


print information to syslog [true]


run in the foreground [false (true with -v)]


write daemon pid to specified file [none]


dispatch one thread per cpu run-queue, even if thre are no starving threads (uses more power). [false]


run as a single threaded program, it consumes less CPU, at the price of less precision/granularity. [false]


when a CPU shows threads starving for more than half of the starving_threshold time, dispatch a specialized thread to monitor it. [false]


set the granularity (in seconds) at which stalld checks for starving threads. The lower the value the more precise will be the detection, at the price of consuming more CPU time. [5 seconds]


set the percentage of CPU time reserved for stalld via SCHED_DEADLINE. In this way, stalld cannot starve due to high priority threads, also avoid indirect starvation via priority inversion. [not set]


set the stalld's affinity to the set of cpus in cpu-list.


regexes (comma-separated) of thread names that must be ignored from being boosted


regexes (comma-separated) of process names that must be ignored from being boosted


selects the backend to search for starving tasks, options are:

sched_debug || S: for sched/debug file (default option).

queue_track || Q: for tracking enqueue/dequeue of tasks in the runqueues.


print options



parameter file for systemd startup


systemd unit file


stalld executable




Daniel Bristot de Oliveira (bristot@redhat.com) Juri Lelli (juri.lelli@redhat.com)

Referenced By