Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

getrusage

NOM

getrusage - Lire l'utilisation des ressources

SYNOPSIS

#include <sys/time.h>
#include <sys/resource.h>

int getrusage (int who, struct rusage *usage);

DESCRIPTION

getrusage() renvoie l'utilisation courante des ressources, pour who valant RUSAGE_SELF ou RUSAGE_CHILDREN. Le premier correspond aux ressources consommées par le processus appelant et le second par l'ensemble des processus fils terminés qui ont été attendus par un wait().

 struct rusage {
   struct timeval ru_utime; /* Temps utilisateur écoulé         */
   struct timeval ru_stime; /* Temps système écoulé             */
   long  ru_maxrss;         /* Taille résidente maximale        */
   long  ru_ixrss;          /* Taille de mémoire partagée       */
   long  ru_idrss;          /* Taille des données non partagées */
   long  ru_isrss;          /* Taille de pile                   */
   long  ru_minflt;         /* Demandes de pages                */
   long  ru_majflt;         /* Nombre de fautes de pages        */
   long  ru_nswap;          /* Nombre de swaps                  */
   long  ru_inblock;        /* Nombre de lectures de blocs      */
   long  ru_oublock;        /* Nombre d'écritures de blocs      */
   long  ru_msgsnd;         /* Nombre de messages émis          */
   long  ru_msgrcv;         /* Nombre de messages reçus         */
   long  ru_nsignals;       /* Nombre de signaux reçus          */
   long  ru_nvcsw;          /* Chgmnts de contexte volontaires  */
   long  ru_nivcsw;         /* Chgmnts de contexte involontaires*/
 };
 

VALEUR RENVOYÉE

L'appel renvoie 0 quand il réussit, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.

ERREURS

EFAULT

usage pointe en dehors de l'espace d'adressage disponible.

EINVAL

who est invalide.

CONFORMITÉ

SVr4, BSD 4.3. POSIX.1-2001 spécifie getrusage(), mais spécifie seulement les champs ru_utime et ru_stime.

NOTES

L'inclusion de <sys/time.h> n'est plus obligatoire mais améliore la portabilité. (En fait, struct timeval est définie dans <sys/time.h>).

Sous Linux avant la version 2.6.9, si le traitement de SIGCHLD est configuré avec SIG_IGN, les statistiques d'utilisation des processus enfants sont automatiquement incluses dans les valeurs renvoyées par RUSAGE_CHILDREN, bien que POSIX.1-2001 interdise explicitement cela. Cette non conformité est corrigée sous Linux 2.6.9 et ultérieurs.

Les structures ci-dessous sont extraites de BSD 4.3 Reno. Tous les champs ne sont pas significatifs sous Linux. Sous Linux 2.4 seuls les champs ru_utime, ru_stime, ru_minflt, ru_majflt sont remplis. Depuis Linux 2.6, ru_nvcsw et ru_nivcsw sont également remplis.

VOIR AUSSI

getrlimit(2), times(2), wait(2), wait4(2)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006, et mise à disposition sur http://manpagesfr.free.fr/.

Les mises à jour et corrections de la version présente dans Debian sont directement gérées par Julien Cristau <jcristau@debian.org> et l'équipe francophone de traduction de Debian.

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> ».