git.infodrom.org Git - infodrom/manpages-de/blob - man2/ptrace.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (c) 1993 Michael Haardt
   4 .\" (u31b3hs@pool.informatik.rwth-aachen.de),
   5 .\" Fri Apr  2 11:32:09 MET DST 1993
   6 .\"
   7 .\" This is free documentation; you can redistribute it and/or
   8 .\" modify it under the terms of the GNU General Public License as
   9 .\" published by the Free Software Foundation; either version 2 of
  10 .\" the License, or (at your option) any later version.
  11 .\"
  12 .\" The GNU General Public License's references to "object code"
  13 .\" and "executables" are to be interpreted as the output of any
  14 .\" document formatting or typesetting system, including
  15 .\" intermediate and printed output.
  16 .\"
  17 .\" This manual is distributed in the hope that it will be useful,
  18 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 .\" GNU General Public License for more details.
  21 .\"
  22 .\" You should have received a copy of the GNU General Public
  23 .\" License along with this manual; if not, write to the Free
  24 .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
  25 .\" USA.
  26 .\"
  27 .\" Modified Fri Jul 23 23:47:18 1993 by Rik Faith (faith@cs.unc.edu)
  28 .\" Translated to German Sun Oct 06 15:00:00 1996 by Patrick Rother <krd@gulu.net>
  29 .\"
  30 .\"
  31 .TH PTRACE 2 "6. Oktober 1996" "Linux 0.99.11" "Systemaufrufe"
  32 .SH NAME
  33 ptrace \- Prozessverfolgung
  34 .SH ÜBERSICHT
  35 .B #include <sys/ptrace.h>
  36 .sp
  37 .BI "int ptrace(int " request ", int " pid ", int " addr ", int " data );
  38 .SH BESCHREIBUNG
  39 .B Ptrace
  40 stellt einen Weg zur Verfügung, durch den ein Vaterprozess die Ausführung
  41 eines Tochterprozesses kontrollieren und sein core überwachen und
  42 ändern kann.  Der Hauptnutzen besteht in der Implementation von
  43 Fehlersuche mit Unterbrechungspunkten (breakpoint debugging).  Ein
  44 getraceter Prozess läuft bis ein Signal auftritt.  Dann
  45 stoppt er und der Vater wird benachrichtigt durch
  46 .BR wait (2).
  47 Wenn des Prozess sich in gestopptem Zustand befindet, kann sein Speicher
  48 gelesen und beschrieben werden.  Der Vater kann auch die Tochter bewegen,
  49 die Ausführung fortzusetzen; optional kann das Signal, dass das Stoppen
  50 bewirkte, ignoriert werden.
  51 .LP
  52 Der Wert des Arguments
  53 .I request
  54 legt die genaue Aktion des Systemaufrufs
  55 fest:
  56 .TP
  57 PTRACE_TRACEME
  58 Dieser Prozess wird durch seinen Vater verfolgt.  Der Vater sollte erwarten
  59 die Tochter zu verfolgen.
  60 .TP
  61 PTRACE_PEEKTEXT, PTRACE_PEEKDATA
  62 Lese Wort bei Adresse
  63 .IR addr .
  64 .TP
  65 PTRACE_PEEKUSR
  66 Lese Wort bei Adresse
  67 .I addr
  68 im
  69 .BR USER \-Bereich.
  70 .TP
  71 PTRACE_POKETEXT, PTRACE_POKEDATA
  72 Schreibe Wort an Adresse
  73 .IR addr .
  74 .TP
  75 PTRACE_POKEUSR
  76 Schreibe Wort an Adresse
  77 .I addr
  78 im
  79 .BR USER \-Bereich.
  80 .TP
  81 PTRACE_SYSCALL, PTRACE_CONT
  82 Fahre fort nach Signal.
  83 .TP
  84 PTRACE_KILL
  85 Sendet dem Tochterprozess ein
  86 .B SIGKILL
  87 um ihn zu beenden.
  88 .TP
  89 PTRACE_SINGLESTEP
  90 Setze das trap Flag für Einzelschrittmodus.
  91 .TP
  92 PTRACE_ATTACH
  93 Hänge an den Prozess an, der durch
  94 .IR pid
  95 spezifiziert ist.
  96 .TP
  97 PTRACE_DETACH
  98 Gib einen Prozess frei, der vorher verbunden war.
  99 .SH BEMERKUNGEN
 100 .BR init ,
 101 der Prozess mit der Prozessnummer 1, darf diese Funktion nicht benutzen.
 102 .SH "RÜCKGABEWERT"
 103 Bei Erfolg wird Null zurückgegeben.  Im Fehlerfall wird \-1 zurückgegeben und
 104 .I errno
 105 entsprechend gesetzt.
 106 .SH FEHLER
 107 .TP 0.8i
 108 .B EPERM
 109 Der angegebene Prozess (d.h.
 110 .BR init ),
 111 kann nicht verfolgt werden oder wird bereits verfolgt.
 112 .TP
 113 .B ESRCH
 114 Der angegebene Prozess existiert nicht.
 115 .TP
 116 .B EIO
 117 .I Request
 118 ist nicht gültig.
 119 .SH "KONFORM ZU"
 120 SVID EXT, AT&T, X/OPEN, BSD 4.3
 121 .SH "SIEHE AUCH"
 122 .BR gdb (1),
 123 .BR exec (2),
 124 .BR signal (2),
 125 .BR wait (2).
 126