Debian Codegraph @

upstream/debian-unstable/man2/idle.2

raw
1 .\" Copyright 1993, Rickard E. Faith <[email protected]>
2 .\" Copyright, the authors of the Linux man-pages project
3 .\"
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\"
6 .TH idle 2 2026-02-08 "Linux man-pages 6.18"
7 .SH NAME
8 idle \- make process 0 idle
9 .SH SYNOPSIS
10 .nf
11 .B #include <unistd.h>
12 .P
13 .B [[deprecated]] int idle(void);
14 .fi
15 .SH DESCRIPTION
16 .BR idle ()
17 is an internal system call used during bootstrap.
18 It marks the process's pages as swappable, lowers its priority,
19 and enters the main scheduling loop.
20 .BR idle ()
21 never returns.
22 .P
23 Only process 0 may call
24 .BR idle ().
25 Any user process, even a process with superuser permission,
26 will receive
27 .BR EPERM .
28 .SH RETURN VALUE
29 .BR idle ()
30 never returns for process 0, and always returns \-1 for a user process.
31 .SH ERRORS
32 .TP
33 .B EPERM
34 Always, for a user process.
35 .SH STANDARDS
36 Linux.
37 .SH HISTORY
38 Removed in Linux 2.3.13.