File: getrlimit.2

package info (click to toggle)
manpages-fr 0.8-1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 5,760 kB
  • ctags: 4
  • sloc: makefile: 57; sh: 8
file content (159 lines) | stat: -rw-r--r-- 5,292 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1992 Drew Eckhardt, March 28, 1992
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified by Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de)
.\" Modified Fri Jul 23 21:18:14 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Jan 13, 1996 by Arnt Gulbrandsen <agulbra@troll.no>
.\" 
.\" Traduction  11/10/1996 Christophe BLAESS (ccb@club-internet.fr)
.\" Mise a jour 8/04/97
.\" mj 09/04/99 LDP-man-pages 1.22
.\" mj 30/08/99 
.TH GETRLIMIT 2 "30 Aot 1999" Linux "Manuel du programmeur Linux"
.SH NOM
getrlimit, getrusage, setrlimit \- Lire / crire les limites d'utilisation des ressources systmes.
.SH SYNOPSIS
.B #include <sys/time.h>
.br
.B #include <sys/resource.h>
.br
.B #include <unistd.h>
.sp
.BI "int getrlimit (int " resource ", struct rlimit *" rlim );
.br
.BI "int getrusage (int " who ", struct rusage *" usage );
.br
.BI "int setrlimit (int " resource ", const struct rlimit *" rlim );
.SH DESCRIPTION
.B getrlimit
et
.B setrlimit
lisent ou crivent les limites des ressources systmes.
.I resource
doit tre l'un des lments suivants :
.PP
\fBRLIMIT_CPU\fP	/* Temps CPU en secondes           */
.br
\fBRLIMIT_FSIZE\fP	/* Taille maximale d'un fichier    */
.br
\fBRLIMIT_DATA\fP	/* Taille maximale zone de donnes */
.br
\fBRLIMIT_STACK\fP	/* Taille maximale de la pile      */
.br
\fBRLIMIT_CORE\fP	/* Taille maximale fichier core    */
.br
\fBRLIMIT_RSS\fP	/* Taille rsidente maximale       */
.br
\fBRLIMIT_NPROC\fP	/* Nombre maximal de processus     */
.br
\fBRLIMIT_NOFILE\fP	/* Nombre maximal fichiers ouverts */
.br
\fBRLIMIT_MEMLOCK\fP	/* Verrouillage maximal en mmoire */
.PP
Une ressource peut tre illimite si l'on prcise
.BR RLIM_INFINITY ". " RLIMIT_OFILE
est le nom "BSD" pour
.BR RLIMIT_NOFILE .
.PP
La structure
.B rlimit
est dfinie comme suit :
.PP
.in +0.5i
.nf
struct rlimit
{
	rlim_t	rlim_cur;
	rlim_t	rlim_max;
};
.fi
.in -0.5i
.PP
Sous Linux 2.2, rlim_t est quivalent  un long int.

.B getrusage
renvoie l'utilisation courante des ressources, pour \fIwho\fP
correspondant  
.BR RUSAGE_SELF ,
.BR RUSAGE_CHILDREN ,
ou
.B RUSAGE_BOTH
correspondant aux ressources consommes respectivement par le processus
appelant, l'ensemble des processus fils termins, ou la somme de ces deux
statistiques.
.PP 
.in +0.5i
.nf
struct rusage
{
  struct timeval ru_utime; /* Temps utilisateur coul         */
  struct timeval ru_stime; /* Temps systme coul             */
  long  ru_maxrss;         /* Taille rsidente maximale        */
  long  ru_ixrss;          /* Taille de mmoire partage       */
  long  ru_idrss;          /* Taille des donnes non partages */
  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 reus         */
  long  ru_nsignals;       /* Nombre de signaux reus          */
  long  ru_nvcsw;          /* Chgmnts de contexte volontaires  */
  long  ru_nivcsw;         /* Chgmnts de contexte involontaires*/
};
.fi
.in -0.5i
En fait, sous Linux 2.2, seuls les membres ru_utime, ru_stime, ru_minflt,
ru_majflt, et ru_nswap sont remplis. Les autres sont mis  zro.
.SH "VALEUR RENVOYE"
Ces fonctions
renvoient 0 si elles russissent, ou \-1 si elles chouent, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
.TP
.B EFAULT
.I rlim
ou
.I usage
pointent en dehors de l'espace d'adressage disponible.
.TP
.B EINVAL
.BR getrlimit " ou " setrlimit
est appel avec un mauvais argument \fIresource\fP, 
ou \fBgetrusage\fP est appel avec un mauvais argument \fIwho\fP.
.TP
.B EPERM
Tentative d'utiliser \fBsetrlimit()\fP sans tre Super\-User pour
augmenter ses limites, ou alors le Super\-User essaye d'augmenter
les limites au-dessus des maxima du noyau.
.SH "CONFORMIT"
SVr4, BSD 4.3
.SH "VOIR AUSSI"
.BR ulimit "(2), " quotactl (2)

.SH TRADUCTION
Christophe Blaess, 1997.