Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] wait3, wait4 - Attendre la fin d'un processus - Style BSD. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <sys/types.h>[/b] [b]#include <sys/time.h>[/b] [b]#include <sys/resource.h>[/b] [b]#include <sys/wait.h>[/b] 2 [b][i]pid_t wait3(int * status , int options ,[/i][/b] [b][i] struct rusage * rusage );[/i][/b] [b][i]pid_t wait4(pid_t pid , int * status , int options ,[/i][/b] [b][i] struct rusage * rusage );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]wait3[/b] suspend l'exécution du processus courant jusqu'à ce qu'un enfant se termine, ou jusqu'à ce qu'un signal à intercepter arrive. Si un processus fils s'est déjà terminé au moment de l'appel (il est devenu "zombie"), la fonction revient immédiatement. Toutes les ressources utilisées par le fils sont libérées. La fonction [b]wait4[/b] suspend l'exécution du processus courant jusqu'à ce que le processus fils numéro [i]pid[/i] se termine, ou jusqu'à ce qu'un signal à intercepter arrive. Si le fils mentionné par [i]pid[/i] s'est déjà terminé au moment de l'appel (il est devenu "zombie"), la fonction revient immédiatement. Toutes les ressources utilisées par le fils sont libérées. La valeur de [i]pid[/i] peut également être l'une des suivantes : "< -1" [table][row][col]    [/col][col]attendre la fin de n'importe quel processus fils appartenant à un groupe de processus d'ID [b]pid .[/b][/col][/row][/table] -1 [table][row][col]    [/col][col]attendre la fin de n'importe quel fils. C'est le même comportement que [b]wait3 .[/b][/col][/row][/table] 0 [table][row][col]    [/col][col]attendre la fin de n'importe quel processus fils du même groupe que l'appelant.[/col][/row][/table] "> 0" [table][row][col]    [/col][col]attendre la fin du processus numéro [b]pid .[/b][/col][/row][/table] La valeur de l'argument option [i]options[/i] est un [i]OU[/i] binaire entre les constantes suivantes : [b]WNOHANG[/b] [table][row][col]    [/col][col]ne pas bloquer si aucun fils ne s'est terminé.[/col][/row][/table] [b]WUNTRACED[/b] [table][row][col]    [/col][col]recevoir l'information concernant également les fils bloqués si on ne l'a pas encore reçue.[/col][/row][/table] Si [i]status[/i] est non [b]NULL ,[/b] [b]wait3[/b] et [b]wait4[/b] y stockent l'information sur la terminaison du fils. Cette information peut être analysée avec les macros suivantes, qui prennent en argument le buffer [i]status[/i] (un [b]int[/b] et non pas un pointeur sur le buffer). [b][i]WIFEXITED( status )[/i][/b] [table][row][col]    [/col][col]non nul si le fils s'est terminé normalement[/col][/row][/table] [b][i]WEXITSTATUS( status )[/i][/b] [table][row][col]    [/col][col]donne le code de retour tel qu'il a été mentionné dans l'appel [b]exit()[/b] ou dans le [b]return[/b] de la routine [b]main.[/b] Cette macro ne peut être évaluée que si [b]WIFEXITED[/b] est non nul.[/col][/row][/table] [b][i]WIFSIGNALED( status )[/i][/b] [table][row][col]    [/col][col]indique que le fils s'est terminé à cause d'un signal non intercepté.[/col][/row][/table] [b][i]WTERMSIG( status )[/i][/b] [table][row][col]    [/col][col]donne le numéro du signal qui a causé la fin du fils. Cette macro ne peut être évaluée que si [b]WIFSIGNALED[/b] est non nul.[/col][/row][/table] [b][i]WIFSTOPPED( status )[/i][/b] [table][row][col]    [/col][col]indique que le fils est actuellement arrêté. Cette macro n'a de sens que si l'on a effectué l'appel avec l'option [b]WUNTRACED .[/b][/col][/row][/table] [b][i]WSTOPSIG( status )[/i][/b] [table][row][col]    [/col][col]donne le numéro du signal qui a causé l'arrêt du fils. Cette macro ne peut être évaluée que si [b]WIFSTOPPED[/b] est non nul.[/col][/row][/table] Si [i]rusage[/i] n'est pas [b]NULL ,[/b] La structure [b]rusage[/b] définie dans [b]<sys/resource.h>[/b] sera remplie avec les informations de comptabilité. Voir [b]getrusage (2)[/b] Pour plus de détails. [size=18] [b]Valeur renvoyée[/b] [/size] En cas de réussite, le PID du fils qui s'est terminé est renvoyé, en cas d'échec -1 est renvoyé et [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]ECHILD[/b] [table][row][col]    [/col][col]Le processus indiqué par [i]pid[/i] n'existe pas, ou n'est pas un fils du processus appelant.[/col][/row][/table] [b]EINTR[/b] [b]WNOHANG[/b] [table][row][col]    [/col][col]n'est pas indiqué, et un signal à intercepter ou [b]SIGCHLD[/b] a été reçu.[/col][/row][/table] [size=18] [b]Note[/b] [/size] L'inclusion de [i]<sys/time.h>[/i] n'est plus obligatoire, mais améliore la portabilité. (En fait, [i]<sys/resource.h>[/i] définit la structure [i]rusage[/i] qui contient des champs de type [i]struct timeval[/i] définis dans [b]<sys/time.h> ).[/b]     Les prototypes de ces fonctions ne sont disponibles que si la constante [b]_BSD_SOURCE[/b] est définie (soit explicitement, ou implicitement en ne définissant par _POSIX_SOURCE ou en compilant avec l'option -ansi). [size=18] [b]Conformité[/b] [/size] SVr4, POSIX.1 [size=18] [b]Voir aussi[/b] [/size] [b]signal (2),[/b] [b]getrusage (2),[/b] [b]wait (2),[/b] [b]signal (7)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier