Provided by: manpages-fr-dev_3.65d1p1-1_all bug

NOM

       wait, waitpid, waitid - Attendre la fin d'un processus

SYNOPSIS

       #include <sys/types.h>
       #include <sys/wait.h>

       pid_t wait(int *status);

       pid_t waitpid(pid_t pid, int *status, int options);

       int waitid(idtype_t idtype, id_t id, siginfo_t *infop, int options);
                       /* Il s'agit de l'interface de glibc et POSIX ; consultez les
                          NOTES pour des informations sur les appels système bruts. */

   Exigences    de    macros    de   test   de   fonctionnalités   pour   la   glibc   (consultez
   feature_test_macros(7)) :

       waitid() :
           _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
           || /* Depuis la glibc 2.12 : */ _POSIX_C_SOURCE >= 200809L

DESCRIPTION

       Tous ces appels système attendent qu'un des fils du processus appelant change  d'état,  et
       permettent  d'obtenir des informations sur le fils en question. Un processus est considéré
       comme changeant d'état s'il termine, s'il est stoppé par un signal, ou  s'il  est  relancé
       par  un  signal.  Dans  le  cas  d'un fils qui se termine, l'attendre permet au système de
       libérer les ressources qui lui étaient allouées ; si le processus n'est  pas  attendu,  il
       reste en état de « zombie » (voir les NOTES plus bas).

       Si  un  fils a déjà changé d'état, ces appels système retournent immédiatement. Sinon, ils
       bloquent jusqu'à ce qu'un fils change d'état ou qu'un gestionnaire  de  signal  interrompe
       l'appel  (sauf si les appels système sont relancés automatiquement par l'option SA_RESTART
       de sigaction(2)). Dans la suite de cette page, un fils qui a changé d'état et qui n'a  pas
       été attendu est appelé prêt (waitable).

   wait() et waitpid()
       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.

   waitid()
       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.

VALEUR RENVOYÉE

       wait() : en cas de réussite, l'identifiant du processus fils terminé est renvoyé ; en  cas
       d'erreur, la valeur de retour est -1.

       waitpid() :  s'il  réussit,  l'appel renvoie l'identifiant du processus fils dont l'état a
       changé ; si WNOHANG est utilisé et un fils (ou plus) spécifié par  pid  existe,  mais  n'a
       toujours pas changé d'état, la valeur de retour est 0. En cas d'erreur, -1 est renvoyé.

       waitid() :  renvoie  0  s'il  réussit  ou  si WNOHANG est utilisé et aucun fils n'a changé
       d'état. En cas d'erreur, il renvoie -1. Chacun de ces appels système positionne errno à la
       valeur appropriée en cas d'erreur.

ERREURS

       ECHILD (pour wait()) Le processus appelant n'a pas de fils qui n'ont pas été attendus.

       ECHILD (pour  waitpid() ou waitid()) Le processus indiqué par pid (waitpid()) ou idtype et
              id (waitid()) n'existe pas, ou n'est pas un fils du processus appelant. (Ceci  peut
              arriver  pour  son  propre  fils si l'action de SIGCHLD est placé sur SIG_IGN, voir
              également le passage de la section Notes sur Linux concernant les threads.)

       EINTR  WNOHANG n'est pas indiqué, et un signal à  intercepter  ou  SIGCHLD  a  été  reçu ;
              consultez signal(7).

       EINVAL L'argument options est invalide.

CONFORMITÉ

       SVr4, BSD 4.3, POSIX.1-2001.

NOTES

       Un  fils  qui se termine mais n'a pas été attendu devient un « zombie ». Le noyau conserve
       des  informations  minimales  sur  le  processus  zombie  (identifiant,  code  de  retour,
       informations  d'utilisation  des  ressources)  pour permettre au parent de l'attendre plus
       tard et d'obtenir des informations sur le fils. Tant que le zombie  n'est  pas  effacé  du
       système  par  une attente, il prendra un emplacement dans la table des processus du noyau,
       et si cette table est remplie, il sera impossible de créer de nouveaux  processus.  Si  un
       processus  parent  se  termine,  ses fils zombies sont adoptés par init(8), qui les attend
       automatiquement pour les supprimer.

       POSIX.1-2001 indique que si l'action pour SIGCHLD est définie à SIG_IGN ou  si  l'attribut
       SA_NOCLDWAIT est indiqué pour SIGCHLD (voir sigaction(2)), les enfants qui se terminent ne
       deviennent pas des zombies et un appel à wait() ou waitpid() sera bloquant jusqu'à ce  que
       tous  les  fils  soient  terminés, et échouera ensuite en positionnant errno à ECHILD. (La
       norme POSIX originale ne décrivait pas le comportement  si  l'action  pour  SIGCHLD  était
       SIG_IGN.  Veuillez  noter que même si la disposition par défaut de SIGCHLD est « ignore »,
       la configuration explicite de la disposition de SIG_IGN entraîne un  traitement  différent
       des  processus fils zombies.) Linux 2.6 se conforme à cette norme. Cependant, ce n'est pas
       le cas de Linux 2.4 et précédents : si un appel à wait() ou waitpid() est fait  alors  que
       SIGCHLD  est  ignoré, l'appel se comporte comme si SIGCHLD n'était pas ignoré, ce qui veut
       dire qu'il attend jusqu'à ce que le prochain fils se termine, et renvoie l'identifiant  et
       le code de retour de ce fils.

   Notes sur Linux
       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.

       L'appel système brut waitid() prend un cinquième paramètre, de type struct rusage *. Si ce
       paramètre n'est pas NULL, il est utilisé pour renvoyer les informations d'utilisation  des
       ressources  au sujet du thread fils, de la même façon que wait4(2). Consultez getrusage(2)
       pour plus de détails.

BOGUES

       Selon la norme POSIX.1-2008, une application appelant  waitid() doit  garantir  que  infop
       pointe  sur  une  structure  siginfo_t  (c'est-à-dire qu'elle ne pointe pas sur NULL). Sur
       Linux, si infop est NULL, waitid() réussit, et renvoie l'identificateur du processus  fils
       attendu.  Dans  la  mesure  du possible, les applications doivent éviter d'avoir recours à
       cette fonctionnalité incohérente, non standard et superflue.

EXEMPLE

       Le programme suivant montre l'utilisation de fork(2) et de waitpid(). Le programme crée un
       processus  fils. Si aucun argument n'est fourni dans la ligne de commande du programme, le
       fils suspend son exécution avec pause(2), pour que l'utilisateur puisse  lui  envoyer  des
       signaux.  Sinon,  le  fils  se  termine immédiatement, en utilisant l'entier fourni sur la
       ligne de commande comme code de retour. Le processus père boucle en surveillant l'état  du
       fils  avec  waitpid(), et utilise les macros W*() décrites ci-dessus pour analyser le code
       d'état du fils.

       La session interactive suivante montre l'utilisation de ce programme :

           $ ./a.out &
           Le PID du fils est 32360
           [1] 32359
           $ kill -STOP 32360
           arrêté par le signal 19
           $ kill -CONT 32360
           relancé
           $ kill -TERM 32360
           tué par le signal 15
           [1]+  Done                    ./a.out
           $

   Source du programme

       #include <sys/wait.h>
       #include <stdlib.h>
       #include <unistd.h>
       #include <stdio.h>

       int
       main(int argc, char *argv[])
       {
           pid_t cpid, w;
           int status;

           cpid = fork();
           if (cpid == -1) {
               perror("fork");
               exit(EXIT_FAILURE);
           }

           if (cpid == 0) {            /* Code exécuté par le fils */
               printf("Le PID du fils est %ld\n", (long) getpid());
               if (argc == 1)
                   pause();                    /* Attendre un signal */
               _exit(atoi(argv[1]));

           } else {                    /* Code exécuté par le père */
               do {
                   w = waitpid(cpid, &status, WUNTRACED | WCONTINUED);
                   if (w == -1) {
                       perror("waitpid");
                       exit(EXIT_FAILURE);
                   }

                   if (WIFEXITED(status)) {
                       printf("terminé, code=%d\n", WEXITSTATUS(status));
                   } else if (WIFSIGNALED(status)) {
                       printf("tué par le signal %d\n", WTERMSIG(status));
                   } else if (WIFSTOPPED(status)) {
                       printf("arrêté par le signal %d\n", WSTOPSIG(status));
                   } else if (WIFCONTINUED(status)) {
                       printf("relancé\n");
                   }
               } while (!WIFEXITED(status) && !WIFSIGNALED(status));
               exit(EXIT_SUCCESS);
           }
       }

VOIR AUSSI

       _exit(2),  clone(2),  fork(2),  kill(2),  ptrace(2),  sigaction(2),  signal(2),  wait4(2),
       pthread_create(3), credentials(7), signal(7)

COLOPHON

       Cette  page  fait partie de la publication 3.65 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».