1 /* Low level interface to ptrace, for the remote server for GDB.
2 Copyright 1995, 1996, 1998, 1999, 2000, 2001, 2002
3 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #include "linux-low.h"
27 #include <sys/param.h>
29 #include <sys/ptrace.h>
32 #include <sys/ioctl.h>
38 #define PTRACE_ARG3_TYPE long
39 #define PTRACE_XFER_TYPE int
41 #ifdef HAVE_LINUX_REGSETS
42 static int use_regsets_p
= 1;
49 /* Start an inferior process and returns its pid.
50 ALLARGS is a vector of program-name and args. */
53 create_inferior (char *program
, char **allargs
)
59 perror_with_name ("fork");
63 ptrace (PTRACE_TRACEME
, 0, 0, 0);
65 execv (program
, allargs
);
67 fprintf (stderr
, "Cannot exec %s: %s.\n", program
,
76 /* Attach to an inferior process. */
81 if (ptrace (PTRACE_ATTACH
, pid
, 0, 0) != 0)
83 fprintf (stderr
, "Cannot attach to process %d: %s (%d)\n", pid
,
84 errno
< sys_nerr
? sys_errlist
[errno
] : "unknown error",
93 /* Kill the inferior process. Make us have no inferior. */
98 if (inferior_pid
== 0)
100 ptrace (PTRACE_KILL
, inferior_pid
, 0, 0);
104 /* Return nonzero if the given thread is still alive. */
106 mythread_alive (int pid
)
111 /* Wait for process, returns status */
114 mywait (char *status
)
120 pid
= waitpid (inferior_pid
, &w
, 0);
122 if (pid
!= inferior_pid
)
123 perror_with_name ("wait");
127 fprintf (stderr
, "\nChild exited with retcode = %x \n", WEXITSTATUS (w
));
129 return ((unsigned char) WEXITSTATUS (w
));
131 else if (!WIFSTOPPED (w
))
133 fprintf (stderr
, "\nChild terminated with signal = %x \n", WTERMSIG (w
));
135 return ((unsigned char) WTERMSIG (w
));
138 fetch_inferior_registers (0);
141 return ((unsigned char) WSTOPSIG (w
));
144 /* Resume execution of the inferior process.
145 If STEP is nonzero, single-step it.
146 If SIGNAL is nonzero, give it that signal. */
149 myresume (int step
, int signal
)
152 ptrace (step
? PTRACE_SINGLESTEP
: PTRACE_CONT
, inferior_pid
, 1, signal
);
154 perror_with_name ("ptrace");
157 #define REGISTER_RAW_SIZE(regno) register_size((regno))
160 register_addr (int regnum
)
164 if (regnum
< 0 || regnum
>= num_regs
)
165 error ("Invalid register number %d.", regnum
);
167 addr
= regmap
[regnum
];
176 #ifdef HAVE_LINUX_USRREGS
178 /* Fetch one register. */
180 fetch_register (int regno
)
185 if (regno
>= num_regs
)
187 if (cannot_fetch_register (regno
))
190 regaddr
= register_addr (regno
);
193 for (i
= 0; i
< REGISTER_RAW_SIZE (regno
); i
+= sizeof (PTRACE_XFER_TYPE
))
196 *(PTRACE_XFER_TYPE
*) (register_data (regno
) + i
) =
197 ptrace (PTRACE_PEEKUSER
, inferior_pid
, (PTRACE_ARG3_TYPE
) regaddr
, 0);
198 regaddr
+= sizeof (PTRACE_XFER_TYPE
);
201 /* Warning, not error, in case we are attached; sometimes the
202 kernel doesn't let us at the registers. */
203 char *err
= strerror (errno
);
204 char *msg
= alloca (strlen (err
) + 128);
205 sprintf (msg
, "reading register %d: %s", regno
, err
);
213 /* Fetch all registers, or just one, from the child process. */
215 usr_fetch_inferior_registers (int regno
)
217 if (regno
== -1 || regno
== 0)
218 for (regno
= 0; regno
< num_regs
; regno
++)
219 fetch_register (regno
);
221 fetch_register (regno
);
224 /* Store our register values back into the inferior.
225 If REGNO is -1, do this for all registers.
226 Otherwise, REGNO specifies which register (so we can save time). */
228 usr_store_inferior_registers (int regno
)
235 if (regno
>= num_regs
)
238 if (cannot_store_register (regno
))
241 regaddr
= register_addr (regno
);
245 for (i
= 0; i
< REGISTER_RAW_SIZE (regno
); i
+= sizeof (int))
248 ptrace (PTRACE_POKEUSER
, inferior_pid
, (PTRACE_ARG3_TYPE
) regaddr
,
249 *(int *) (register_data (regno
) + i
));
252 /* Warning, not error, in case we are attached; sometimes the
253 kernel doesn't let us at the registers. */
254 char *err
= strerror (errno
);
255 char *msg
= alloca (strlen (err
) + 128);
256 sprintf (msg
, "writing register %d: %s",
261 regaddr
+= sizeof (int);
265 for (regno
= 0; regno
< num_regs
; regno
++)
266 store_inferior_registers (regno
);
268 #endif /* HAVE_LINUX_USRREGS */
272 #ifdef HAVE_LINUX_REGSETS
275 regsets_fetch_inferior_registers (void)
277 struct regset_info
*regset
;
279 regset
= target_regsets
;
281 while (regset
->size
>= 0)
286 if (regset
->size
== 0)
292 buf
= malloc (regset
->size
);
293 res
= ptrace (regset
->get_request
, inferior_pid
, 0, (int) buf
);
298 /* If we get EIO on the first regset, do not try regsets again.
299 If we get EIO on a later regset, disable that regset. */
300 if (regset
== target_regsets
)
313 perror ("Warning: ptrace(regsets_fetch_inferior_registers)");
316 regset
->store_function (buf
);
322 regsets_store_inferior_registers (void)
324 struct regset_info
*regset
;
326 regset
= target_regsets
;
328 while (regset
->size
>= 0)
333 if (regset
->size
== 0)
339 buf
= malloc (regset
->size
);
340 regset
->fill_function (buf
);
341 res
= ptrace (regset
->set_request
, inferior_pid
, 0, (int) buf
);
346 /* If we get EIO on the first regset, do not try regsets again.
347 If we get EIO on a later regset, disable that regset. */
348 if (regset
== target_regsets
)
361 perror ("Warning: ptrace(regsets_fetch_inferior_registers)");
368 #endif /* HAVE_LINUX_REGSETS */
372 fetch_inferior_registers (int regno
)
374 #ifdef HAVE_LINUX_REGSETS
377 if (regsets_fetch_inferior_registers () == 0)
381 #ifdef HAVE_LINUX_USRREGS
382 usr_fetch_inferior_registers (regno
);
387 store_inferior_registers (int regno
)
389 #ifdef HAVE_LINUX_REGSETS
392 if (regsets_store_inferior_registers () == 0)
396 #ifdef HAVE_LINUX_USRREGS
397 usr_store_inferior_registers (regno
);
402 /* Copy LEN bytes from inferior's memory starting at MEMADDR
403 to debugger memory starting at MYADDR. */
406 read_inferior_memory (CORE_ADDR memaddr
, char *myaddr
, int len
)
409 /* Round starting address down to longword boundary. */
410 register CORE_ADDR addr
= memaddr
& -(CORE_ADDR
) sizeof (PTRACE_XFER_TYPE
);
411 /* Round ending address up; get number of longwords that makes. */
413 = (((memaddr
+ len
) - addr
) + sizeof (PTRACE_XFER_TYPE
) - 1)
414 / sizeof (PTRACE_XFER_TYPE
);
415 /* Allocate buffer of that many longwords. */
416 register PTRACE_XFER_TYPE
*buffer
417 = (PTRACE_XFER_TYPE
*) alloca (count
* sizeof (PTRACE_XFER_TYPE
));
419 /* Read all the longwords */
420 for (i
= 0; i
< count
; i
++, addr
+= sizeof (PTRACE_XFER_TYPE
))
422 buffer
[i
] = ptrace (PTRACE_PEEKTEXT
, inferior_pid
, (PTRACE_ARG3_TYPE
) addr
, 0);
425 /* Copy appropriate bytes out of the buffer. */
426 memcpy (myaddr
, (char *) buffer
+ (memaddr
& (sizeof (PTRACE_XFER_TYPE
) - 1)), len
);
429 /* Copy LEN bytes of data from debugger memory at MYADDR
430 to inferior's memory at MEMADDR.
431 On failure (cannot write the inferior)
432 returns the value of errno. */
435 write_inferior_memory (CORE_ADDR memaddr
, char *myaddr
, int len
)
438 /* Round starting address down to longword boundary. */
439 register CORE_ADDR addr
= memaddr
& -(CORE_ADDR
) sizeof (PTRACE_XFER_TYPE
);
440 /* Round ending address up; get number of longwords that makes. */
442 = (((memaddr
+ len
) - addr
) + sizeof (PTRACE_XFER_TYPE
) - 1) / sizeof (PTRACE_XFER_TYPE
);
443 /* Allocate buffer of that many longwords. */
444 register PTRACE_XFER_TYPE
*buffer
= (PTRACE_XFER_TYPE
*) alloca (count
* sizeof (PTRACE_XFER_TYPE
));
447 /* Fill start and end extra bytes of buffer with existing memory data. */
449 buffer
[0] = ptrace (PTRACE_PEEKTEXT
, inferior_pid
,
450 (PTRACE_ARG3_TYPE
) addr
, 0);
455 = ptrace (PTRACE_PEEKTEXT
, inferior_pid
,
456 (PTRACE_ARG3_TYPE
) (addr
+ (count
- 1)
457 * sizeof (PTRACE_XFER_TYPE
)),
461 /* Copy data to be written over corresponding part of buffer */
463 memcpy ((char *) buffer
+ (memaddr
& (sizeof (PTRACE_XFER_TYPE
) - 1)), myaddr
, len
);
465 /* Write the entire buffer. */
467 for (i
= 0; i
< count
; i
++, addr
+= sizeof (PTRACE_XFER_TYPE
))
470 ptrace (PTRACE_POKETEXT
, inferior_pid
, (PTRACE_ARG3_TYPE
) addr
, buffer
[i
]);
479 initialize_low (void)