home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | VERSIONS | CONFORMING TO | COLOPHONThe Linux Programming Interface


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 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 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

Linux                                 1994-08-21                              IDLE(2)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable counter