Man page 2 : wait

L'appel système wait() suspend l'exécution du processus appelant jusqu'à ce que l'un de ses enfants se termine. L'appel wait(&status) est équivalent à :

    waitpid(-1, &status, 0);

L'appel système waitpid() suspend l'exécution du processus appelant jusqu'à ce qu'un fils spécifié par l'argument pid change d'état. Par défaut, waitpid() n'attend que les fils terminés, mais ce comportement peut être modifié par l'argument options, de la façon décrite ci-dessous. La valeur de pid peut être l'une des suivantes :

< -1 Attendre la fin de n'importe quel processus fils appartenant au groupe de processus d'ID -pid.

-1 Attendre n'importe lequel des processus fils.

0 Attendre la fin de n'importe quel processus fils du même groupe que l'appelant.

> 0 Attendre la fin du processus numéro pid.

La valeur de l'argument option options est un OU binaire entre les constantes suivantes :

• WNOHANG
              Ne pas bloquer si aucun fils ne s'est terminé.
• WUNTRACED
      Recevoir l'information concernant également les fils bloqués (mais non suivis par ptrace(2)) si on ne l'a pas encore reçue. L'état des fils suivis est fourni même sans cette option.
• WCONTINUED (Depuis Linux 2.6.10)
      Renvoyer également si un processus fils stoppé a été relancé par le signal SIGCONT.

(Pour les options spécifiques à Linux, voir plus bas.)

Si status n'est pas NULL, wait() et waitpid() stockent l'état du fils dans la variable de type int pointée. Cet entier peut être évalué avec les macros suivantes (qui prennent l'entier lui-même comme argument, et pas un pointeur vers celui-ci, comme le font wait() et waitpid() !) :

• WIFEXITED(status)
      Vrai si le fils s'est terminé normalement, c'est-à-dire par un appel à exit(3) ou _exit(2), ou par un return depuis main().
• WEXITSTATUS(status)
      Donne le code de retour, consistant en les 8 bits de poids faibles du paramètre status fourni à exit(3) ou _exit(2) ou dans le return de la routine main(). Cette macro ne peut être évaluée que si WIFEXITED est non nul.
• WIFSIGNALED(status)
      Vrai si le fils s'est terminé à cause d'un signal non intercepté.
• WTERMSIG(status)
      Donne le numéro du signal qui a causé la fin du fils. Cette macro ne peut être évaluée que si WIFSIGNALED est non nul.
• WCOREDUMP(status)
      Vrai si le processus fils a produit une image mémoire (« core dump »). Cette macro ne doit être évaluée que si WIFSIGNALED a renvoyé une valeur non nulle. Cette macro n'est pas décrite par POSIX.1-2001 et n'est pas disponible sur certaines variantes d'UNIX (par exemple AIX ou SunOS). N'utilisez cette macro qu'entourée de #ifdef WCOREDUMP ... #endif.
• WIFSTOPPED(status)
      Vrai si le fils est actuellement arrêté. Cela n'est possible que si l'on a effectué l'appel avec l'option WUNTRACED ou si le fils est suivi (voir ptrace(2)).
• WSTOPSIG(status)
      Donne le numéro du signal qui a causé l'arrêt du fils. Cette macro ne peut être évaluée que si WIFSTOPPED est non nul.
• WIFCONTINUED(status)
      (Depuis Linux 2.6.10) Vrai si le processus fils a été relancé par SIGCONT.

L'appel système waitid(), disponible depuis Linux 2.6.9, fournit des moyens plus fins de contrôler quels changements d'états attendre. Les arguments idtype et id sélectionnent le(s) fils à attendre, comme suit :

idtype == P_PID Attendre la fin du processus numéro id.

idtype == P_PGID Attendre la fin de n'importe quel processus fils appartenant à un groupe de processus d'ID id.

idtype == P_ALL Attendre n'importe quel fils ; l'argument id est ignoré.

Les changements d'état à attendre sont indiqués par un OU binaire des attributs suivants dans le paramètre options :

• WEXITED
              Attendre les fils qui se sont terminés.
• WSTOPPED
      Attendre les enfants qui ont été arrêtés par un signal.
• WCONTINUED
      Attendre les enfants précédemment arrêtés qui ont été relancés par le signal SIGCONT.

Les attributs suivants peuvent également être utilisés dans options :

• WNOHANG
              Comme pour waitpid().
• WNOWAIT
      Laisser le fils dans un état prêt ; un appel ultérieur à wait() pourra de nouveau fournir des informations sur l'état du fils.

Si l'appel réussit, waitid() remplit les champs suivants de la structure siginfo_t pointée par infop :

• si_pid
              L'identifiant de processus du fils.
• si_uid
      L'UID réel du fils. Ce champ n'est pas rempli par la plupart des autres implémentations.
• si_signo
      Toujours SIGCHLD.
• si_status
      Soit le code de retour du fils donné à _exit(2) ou exit(3), soit le signal ayant provoqué la terminaison, l'arrêt, ou la relance du fils. Le champ si_code permet de savoir comment interpréter ce champ.
• si_code
      L'un de CLD_EXITED (le fils a appelé _exit(2)), CLD_KILLED (le fils a été tué par un signal), CLD_DUMPED (le fils a été tué par un signal, et a produit une image (core dump)), CLD_STOPPED (le fils a été arrêté par un signal), CLD_TRAPPED (le fils suivi a été rattrapé) ou CLD_CONTINUED (le fils a été relancé par SIGCONT).

Si WNOHANG est utilisé dans options et aucun fils n'est prêt, waitid() renvoie 0 immédiatement et l'état de la structure siginfo_t pointée par infop n'est pas précisé. Pour différencier ce cas de celui où un des fils était prêt, définissez le champ si_pid avant l'appel, et vérifiez sa valeur après le retour.

Dans le noyau Linux, un thread ordonnancé par le noyau n'est pas différent d'un simple processus. En fait, un thread est juste un processus qui est créé à l'aide de la routine spécifique à Linux clone(2). Les routines portables, comme pthread_create(3), sont implémentées en appelant clone(2). Avant Linux 2.4, un thread était simplement un cas particulier de processus, et en conséquence un thread ne pouvait pas attendre les enfants d'un autre thread, même si ce dernier appartenait au même groupe de threads. Toutefois, POSIX réclame une telle fonctionnalité, et depuis Linux 2.4 un thread peut, par défaut, attendre les enfants des autres threads du même groupe.

Les options suivantes sont spécifiques à Linux, et servent pour les enfants créés avec clone(2) ; elles ne peuvent pas être utilisées avec waitid() :

• __WCLONE Attendre uniquement des enfants clones. Sinon, attendre uniquement les enfants non-clones (un enfant « clone » est un enfant qui n'envoie pas de signal, ou un autre signal que SIGCHLD à son père à sa terminaison). Cette option est ignorée si __WALL est aussi indiqué.
• __WALL (depuis Linux 2.4) Attendre tous les enfants, quel que soit leur type (clone ou non-clone).
• __WNOTHREAD (Depuis Linux 2.4) Ne pas attendre les enfants des autres threads du même groupe de threads. Ceci était le cas par défaut avant Linux 2.4.