File: profil.3

package info (click to toggle)
manpages-fr 1.58.1-3
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 10,104 kB
  • ctags: 4
  • sloc: makefile: 106; sh: 8
file content (78 lines) | stat: -rw-r--r-- 2,773 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
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
.\"
.\" 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 Fri Jun 23 01:35:19 1995 Andries Brouwer <aeb@cwi.nl>
.\" (prompted by Bas V. de Bakker <bas@phys.uva.nl>)
.\" Corrected (and moved to man3), 980612, aeb
.\" Traduction 14/12/1998 par Christophe Blaess (ccb@club-internet.fr)
.\" LDP man-pages 1.21
.\" MJ 21/07/2003 LDP-1.56
.TH PROFIL 3 "21 juillet 2003" LDP "Manuel du programmeur Linux"
.SH NOM
profil \- Suivi du temps d'excution.
.SH SYNOPSIS
.B #include <unistd.h>
.sp
.BI "int profil(u_short *" buffer ", size_t " taille_buf ", size_t " offset ", u_int " echelle );
.SH DESCRIPTION
Cette routine fournit un moyen de dtecter les zones o votre programme
passe l'essentiel de son temps. L'argument
.I buffer
pointe sur
.I taille_buf
octets de mmoire. Toutes les 10 millisecondes virtuelles, le compteur
de programme (PC) est examin. On lui soustrait la valeur
.I offset
et le rsultat est multipli par 
.IR echelle
puis divis par 65536.
Si la valeur rsultant est infrieure a
.IR taille_buff ,
alors l'lment correspondant du
.I buffer
est incrment.
Si
.I buffer
est NULL, Le suivi est dsactiv.
.SH "VALEUR RENVOYE"
Cette routine renvoie toujours zro.
.SH BOGUES
.B profil
ne doit pas tre invoqu dans les programmes qui
utilisent des timers
.BR ITIMER_PROF .

Un vrai suivi fourni par le noyau donnerait des rsultats plus prcis.
La bibliothque Libc 4.4 contenait un patch pour implmenter un
appel systme profil dans le noyau.
.SH "CONFORMIT"
Similaire  un appel de SVr4 (mais pas POSIX.1).
.SH "VOIR AUSSI"
.BR gprof (1),
.BR setitimer (2),
.BR signal (2),
.BR sigaction (2).

.SH TRADUCTION
Christophe Blaess, 1998-2003.