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
|
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1993 Michael Haardt
.\" (u31b3hs@pool.informatik.rwth-aachen.de),
.\" Fri Apr 2 11:32:09 MET DST 1993
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\" Modified Fri Jul 23 23:47:18 1993 by Rik Faith (faith@cs.unc.edu)
.\"
.\" Traduction 12/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 8/04/97
.TH PTRACE 2 "8 Avril 1997 " "Linux" "Manuel du programmeur Linux"
.SH NOM
ptrace \- Suivre un processus.
.SH SYNOPSIS
.B #include <sys/ptrace.h>
.sp
.BI "int ptrace(int " requte ", int " pid ", int " addr ", int " data );
.SH DESCRIPTION
.B Ptrace
fournit au processus parent un moyen de contrler l'excution d'un enfant,
et d'diter son image mmoire.
L'utilisation primordiale de cette fonction est l'implmentation de points
d'arrt pour le dbugging.
Un processus suivi se droule jusqu' l'arrive d'un signal. Ensuite il
s'interrompt et son parent sera averti grce la fonction
.BR wait (2).
Quand le processus se trouve arrt (stop), sa mmoire peut tre
lue et crite.
Le parent peut galement faire continuer l'excution de son fils, avec
une option pour ignorer le signal ayant dclench l'arrt.
.LP
La valeur de l'argument \fIrequte\fP indique prcisement l'action entreprendre.
.TP
PTRACE_TRACEME
Le processus en cours va tre suivi par son pre. Le parent doit tre en attente
de suivi du fils.
.TP
PTRACE_PEEKTEXT, PTRACE_PEEKDATA
Lire un mot l'adresse
.IR addr .
.TP
PTRACE_PEEKUSR
Lire un mot l'adresse
.I addr
dans l'espace
.B USER.
.TP
PTRACE_POKETEXT, PTRACE_POKEDATA
Ecrire un mot l'adresse
.IR addr .
.TP
PTRACE_POKEUSR
Ecrire un mot l'adresse
.I addr
dans l'espace
.B USER.
.TP
PTRACE_SYSCALL, PTRACE_CONT
Redmarrer aprs un signal.
.TP
PTRACE_KILL
Envoyer au fils un signal
.B SIGKILL
pour le terminer.
.TP
PTRACE_SINGLESTEP
Positionner un drapeau d'excution pas--pas.
.TP
PTRACE_ATTACH
Attacher le processus numro
.IR pid .
.TP
PTRACE_DETACH
Dtacher un processus prcdemment attach.
.SH NOTES
.BR init ,
le processus numro 1, ne peut pas utiliser cette fonction.
.SH "VALEUR RENVOYE"
.BR ptrace
renvoie 0 s'il russit, ou \-1 s'il choue, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
.TP 0.8i
.B EPERM
Le processus (par exemple
.BR init ),
ne peut pas tre suivi ou est dj suivi.
.TP
.B ESRCH
Le processus indiqu n'existe pas.
.TP
.B EIO
La
.I requte
n'est pas valide.
.SH "CONFORMIT"
SVr4, SVID EXT, AT&T, X/OPEN, BSD 4.3
.SH "VOIR AUSSI"
.BR gdb (1),
.BR exec (3),
.BR signal (2),
.BR wait (2)
.SH TRADUCTION
Christophe Blaess, 1997.
|
