Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getrlimit, getrusage, setrlimit - Lire/écrire les limites et utilisations des ressources. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/time.h>[/b] [b][/b] [b]#include <sys/resource.h>[/b] [b][/b] [b]#include <unistd.h>[/b] [b][i]int getrlimit (int resource , struct rlimit * rlim );[/i][/b] [b][/b] [b][i]int getrusage (int who , struct rusage * usage );[/i][/b] [b][/b] [b][i]int setrlimit (int resource , const struct rlimit * rlim );[/i][/b] [size=18] [b]Description[/b] [/size] [b]getrlimit[/b] et [b]setrlimit[/b] lisent ou écrivent les limites des ressources systèmes. Chaque ressource a une limite souple et une limite stricte définies par la structure [b]rlimit[/b] (l'argument [i]rlim[/i] de [b]getrlimit () et setrlimit ()) :[/b] .in +0.5i .nf struct rlimit { rlim_t rlim_cur; /* limite souple / rlim_t rlim_max; / limite stricte (plafond de rlim_cur) / }; .fi .in -0.5i La limite souple est la valeur que le noyau prend en compte pour la ressource correspondante. La limite stricte agit comme un plafond pour la limite souple : un processus non-privilégié peut seulement modifier sa limite souple dans l'intervalle entre zéro et la limite stricte, et diminuer (de manière irréversible) sa limite stricte. Un processus privilégié peut modifier ses deux limites à sa guise. La valeur [b]RLIM_INFINITY[/b] indique une limite infinie pour la ressource (aussi bien pour [b]getrlimit ()[/b] que pour [b]setrlimit ().[/b] [i]resource[/i] doit être l'un des éléments suivants : [b]RLIMIT_CPU[/b] [table][row][col]    [/col][col]Limite de temps CPU en secondes. Si un processus atteint cette limite souple, il reçoit le signal [b]SIGXCPU .[/b] L'action par défaut en est la terminaison du processus. Mais le signal peut être capturé et le gestionnaire peut renvoyer le contrôle au programme principal. Si le processus continue à consommer du temps CPU, il recevra [b]SIGXCPU[/b] toutes les secondes jusqu'à atteindre sa limite stricte, où il recevra [b]SIGKILL .[/b] (Ceci correspond au comportement de Linux 2.2 et 2.4. Les implémentations varient sur le comportement vis-à-vis d'un processus qui continue à consommer du temps CPU après dépassement de sa limite souple. Les applications portables qui doivent capturer ce signal devrait prévoir une terminaison propre dès la première réception de [b]SIGXCPU ).[/b][/col][/row][/table] [b]RLIMIT_DATA[/b] [table][row][col]    [/col][col]Taille maximale du segment de données d'un processus (données initialisées, non-initialisées, et tas). Cette limite affecte les appels [b]brk () et sbrk (),[/b] qui échouent avec l'erreur [b]ENOMEM[/b] si la limite souple est dépassée.[/col][/row][/table] [b]RLIMIT_FSIZE[/b] [table][row][col]    [/col][col]Taille maximal d'un fichier que le processus peut créer. Les tentatives d'extension d'un fichier au-delà de cette limite resultent en un signal [b]SIGXFSZ .[/b] Par défaut ce signal termine le processus, mais il peut être capturé, et dans ce cas l'appel-système concerné (par exemple [b]write (), truncate ())[/b] échouent avec l'erreur [b]EFBIG .[/b] [b]RLIMIT_LOCKS[/b] Une limite sur le nombre combiné de verrous [b]flock ()[/b] et [b]fcntl() [/b] que le processus peut établir (Linux 2.4 et suivants).[/col][/row][/table] [b]RLIMIT_MEMLOCK[/b] [table][row][col]    [/col][col]Le nombre maximal d'octets de mémoire virtuelle que le processus peut verrouiller en RAM à l'aide des appels [b]lock () et mlockall ().[/b][/col][/row][/table] [b]RLIMIT_NOFILE[/b] [table][row][col]    [/col][col]Le nombre maximal de descripteurs de fichiers qu'un processus peut ouovrir simultanément. Les tentatives d'ouverture [b]( open (), pipe (), dup (), etc)[/b] dépassant cette limite renverront l'erreur [b]EMFILE .[/b][/col][/row][/table] [b]RLIMIT_NPROC[/b] [table][row][col]    [/col][col]Le nombre maximum de processus qui peuvent être créés pour l'UID réel du processus appelant. Une fois cette limite atteinte, [b]fork ()[/b] échoue avec l'erreur [b]EAGAIN .[/b][/col][/row][/table] [b]RLIMIT_RSS[/b] [table][row][col]    [/col][col]Indique la limite (en pages) pour la taille de l'ensemble résident du processus (le nombre de page de mémoire virtuelle en RAM). Cette limite n'a d'effet que depuis Linux 2.4, et n'affecte que les appels [b]madvise ()[/b] indiquant [b]MADVISE_WILLNEED .[/b][/col][/row][/table] [b]RLIMIT_STACK[/b] [table][row][col]    [/col][col]La taille maximal de la pile du processus, en octets. Une fois cette limite atteinte, un signal [b]SIGSEGV[/b] est déclenché. Pour gérer ce signal, le processus doit utiliser une pile spécifique pour signaux [b]( sigaltstack (2)).[/b][/col][/row][/table] [b]RLIMIT_OFILE [/b] est le nom BSD pour [b]RLIMIT_NOFILE .[/b] [b]getrusage[/b] renvoie l'utilisation courante des ressources, pour [i]who[/i] valant à [b]RUSAGE_SELF[/b] ou [b]RUSAGE_CHILDREN .[/b] 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 [b]wait[/b](). .in +0.5i .nf 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*/ }; .fi .in -0.5i [size=18] [b]Valeur renvoyée[/b] [/size] Ces fonctions renvoient 0 si elles réussissent, ou -1 si elles échouent, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EFAULT[/b] [i]rlim[/i] [table][row][col]    [/col][col]ou [i]usage[/i] pointent en dehors de l'espace d'adressage disponible.[/col][/row][/table] [b]EINVAL[/b] [b]getrlimit ou setrlimit[/b] [table][row][col]    [/col][col]est appelé avec un mauvais argument [i]resource[/i], ou [b]getrusage[/b] est appelé avec un mauvais argument [i]who[/i].[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]Tentative d'utiliser [b]setrlimit()[/b] sans être Super-User pour augmenter ses limites, ou alors le Super-User essaye d'augmenter les limites au-dessus des maxima du noyau.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVr4, BSD 4.3 [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]struct timeval[/i] est définie dans [b]<sys/time.h> ).[/b] Sous Linux, si le traitement de [b]SIGCHLD [/b] est configuré avec [b]SIG_IGN [/b] alors les statistiques d'utilisation des processus enfants sont automatiquement incluses dans les valeurs renvoyées par [b]RUSAGE_CHILDREN ,[/b] bien que POSIX 1003.1-2001 interdise explicitement cela.     Les structures ci-dessous sont extraites de BSD 4.3 Reno. Tous les champs ne sont pas significatifs sous Linux. Actuellement (Linux 2.4) seuls les champs [b]ru_utime ,[/b] [b]ru_stime ,[/b] [b]ru_minflt ,[/b] [b]ru_majflt ,[/b] et [b]ru_nswap[/b] sont remplis. [size=18] [b]Voir aussi[/b] [/size] [b]dup (2),[/b] [b]fcntl (2),[/b] [b]fork (2),[/b] [b]mlock (2),[/b] [b]mlockall (2),[/b] [b]mmap (2), [/b] [b]open (2),[/b] [b]quotactl (2),[/b] [b]sbrk (2),[/b] [b]wait3 (2),[/b] [b]wait4 (2),[/b] [b]malloc (3), [/b] [b]ulimit (3),[/b] [b]signal (7)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier