IDLE(2)                   Linux Programmer's Manual                  IDLE(2)

NAME         top

       idle - make process 0 idle

SYNOPSIS         top

       #include <unistd.h>

       int idle(void);

DESCRIPTION         top

       idle() is an internal system call used during bootstrap.  It marks
       the process's pages as swappable, lowers its priority, and enters the
       main scheduling loop.  idle() never returns.

       Only process 0 may call idle().  Any user process, even a process
       with superuser permission, will receive EPERM.

RETURN VALUE         top

       idle() never returns for process 0, and always returns -1 for a user
       process.

ERRORS         top

       EPERM  Always, for a user process.

VERSIONS         top

       Since Linux 2.3.13, this system call does not exist anymore.

CONFORMING TO         top

       This function is Linux-specific, and should not be used in programs
       intended to be portable.

COLOPHON         top

       This page is part of release 4.15 of the Linux man-pages project.  A
       description of the project, information about reporting bugs, and the
       latest version of this page, can be found at
       https://www.kernel.org/doc/man-pages/.

Linux                            2012-12-31                          IDLE(2)

Pages that refer to this page: syscalls(2)

Copyright and license for this manual page

HTML rendering created 2018-02-02 by Michael Kerrisk, author of The Linux Programming Interface, maintainer of the Linux man-pages project. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.