1 /* GNU/Linux specific methods for using the /proc file system.
3 Copyright 2001, 2002 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. */
24 #include <sys/param.h> /* for MAXPATHLEN */
25 #include <sys/procfs.h> /* for elf_gregset etc. */
26 #include "gdb_stat.h" /* for struct stat */
27 #include <ctype.h> /* for isdigit */
28 #include <unistd.h> /* for open, pread64 */
29 #include <fcntl.h> /* for O_RDONLY */
30 #include "regcache.h" /* for registers_changed */
31 #include "gregset.h" /* for gregset */
32 #include "gdbcore.h" /* for get_exec_file */
33 #include "gdbthread.h" /* for struct thread_info etc. */
34 #include "elf-bfd.h" /* for elfcore_write_* */
35 #include "cli/cli-decode.h" /* for add_info */
36 #include "gdb_string.h"
40 #include "linux-nat.h"
46 /* Function: child_pid_to_exec_file
48 * Accepts an integer pid
49 * Returns a string representing a file that can be opened
50 * to get the symbols for the child process.
54 child_pid_to_exec_file (int pid
)
58 name1
= xmalloc (MAXPATHLEN
);
59 name2
= xmalloc (MAXPATHLEN
);
60 make_cleanup (xfree
, name1
);
61 make_cleanup (xfree
, name2
);
62 memset (name2
, 0, MAXPATHLEN
);
64 sprintf (name1
, "/proc/%d/exe", pid
);
65 if (readlink (name1
, name2
, MAXPATHLEN
) > 0)
71 /* Function: read_mappings
73 * Service function for corefiles and info proc.
77 read_mapping (FILE *mapfile
,
82 char *device
, long long *inode
, char *filename
)
84 int ret
= fscanf (mapfile
, "%llx-%llx %s %llx %s %llx",
85 addr
, endaddr
, permissions
, offset
, device
, inode
);
87 if (ret
> 0 && ret
!= EOF
&& *inode
!= 0)
89 /* Eat everything up to EOL for the filename. This will prevent
90 weird filenames (such as one with embedded whitespace) from
91 confusing this code. It also makes this code more robust
92 in respect to annotations the kernel may add after the
95 Note the filename is used for informational purposes only. */
96 ret
+= fscanf (mapfile
, "%[^\n]\n", filename
);
100 filename
[0] = '\0'; /* no filename */
101 fscanf (mapfile
, "\n");
103 return (ret
!= 0 && ret
!= EOF
);
106 /* Function: linux_find_memory_regions
108 * Fills the "to_find_memory_regions" target vector.
109 * Lists the memory regions in the inferior for a corefile.
113 linux_find_memory_regions (int (*func
) (CORE_ADDR
,
115 int, int, int, void *), void *obfd
)
117 long long pid
= PIDGET (inferior_ptid
);
118 char mapsfilename
[MAXPATHLEN
];
120 long long addr
, endaddr
, size
, offset
, inode
;
121 char permissions
[8], device
[8], filename
[MAXPATHLEN
];
122 int read
, write
, exec
;
125 /* Compose the filename for the /proc memory map, and open it. */
126 sprintf (mapsfilename
, "/proc/%lld/maps", pid
);
127 if ((mapsfile
= fopen (mapsfilename
, "r")) == NULL
)
128 error ("Could not open %s\n", mapsfilename
);
131 fprintf_filtered (gdb_stdout
,
132 "Reading memory regions from %s\n", mapsfilename
);
134 /* Now iterate until end-of-file. */
135 while (read_mapping (mapsfile
, &addr
, &endaddr
, &permissions
[0],
136 &offset
, &device
[0], &inode
, &filename
[0]))
138 size
= endaddr
- addr
;
140 /* Get the segment's permissions. */
141 read
= (strchr (permissions
, 'r') != 0);
142 write
= (strchr (permissions
, 'w') != 0);
143 exec
= (strchr (permissions
, 'x') != 0);
147 fprintf_filtered (gdb_stdout
,
148 "Save segment, %lld bytes at 0x%s (%c%c%c)",
149 size
, paddr_nz (addr
),
151 write
? 'w' : ' ', exec
? 'x' : ' ');
152 if (filename
&& filename
[0])
153 fprintf_filtered (gdb_stdout
, " for %s", filename
);
154 fprintf_filtered (gdb_stdout
, "\n");
157 /* Invoke the callback function to create the corefile segment. */
158 func (addr
, size
, read
, write
, exec
, obfd
);
164 /* Function: linux_do_thread_registers
166 * Records the thread's register state for the corefile note section.
170 linux_do_thread_registers (bfd
*obfd
, ptid_t ptid
,
171 char *note_data
, int *note_size
)
174 gdb_fpregset_t fpregs
;
175 #ifdef FILL_FPXREGSET
176 gdb_fpxregset_t fpxregs
;
178 unsigned long lwp
= ptid_get_lwp (ptid
);
180 fill_gregset (&gregs
, -1);
181 note_data
= (char *) elfcore_write_prstatus (obfd
,
185 stop_signal
, &gregs
);
187 fill_fpregset (&fpregs
, -1);
188 note_data
= (char *) elfcore_write_prfpreg (obfd
,
191 &fpregs
, sizeof (fpregs
));
192 #ifdef FILL_FPXREGSET
193 fill_fpxregset (&fpxregs
, -1);
194 note_data
= (char *) elfcore_write_prxfpreg (obfd
,
197 &fpxregs
, sizeof (fpxregs
));
202 struct linux_corefile_thread_data
210 /* Function: linux_corefile_thread_callback
212 * Called by gdbthread.c once per thread.
213 * Records the thread's register state for the corefile note section.
217 linux_corefile_thread_callback (struct lwp_info
*ti
, void *data
)
219 struct linux_corefile_thread_data
*args
= data
;
220 ptid_t saved_ptid
= inferior_ptid
;
222 inferior_ptid
= ti
->ptid
;
223 registers_changed ();
224 target_fetch_registers (-1); /* FIXME should not be necessary;
225 fill_gregset should do it automatically. */
226 args
->note_data
= linux_do_thread_registers (args
->obfd
,
231 inferior_ptid
= saved_ptid
;
232 registers_changed ();
233 target_fetch_registers (-1); /* FIXME should not be necessary;
234 fill_gregset should do it automatically. */
238 /* Function: linux_do_registers
240 * Records the register state for the corefile note section.
244 linux_do_registers (bfd
*obfd
, ptid_t ptid
,
245 char *note_data
, int *note_size
)
247 registers_changed ();
248 target_fetch_registers (-1); /* FIXME should not be necessary;
249 fill_gregset should do it automatically. */
250 return linux_do_thread_registers (obfd
,
251 ptid_build (ptid_get_pid (inferior_ptid
),
252 ptid_get_pid (inferior_ptid
),
254 note_data
, note_size
);
258 /* Function: linux_make_note_section
260 * Fills the "to_make_corefile_note" target vector.
261 * Builds the note section for a corefile, and returns it
262 * in a malloc buffer.
266 linux_make_note_section (bfd
*obfd
, int *note_size
)
268 struct linux_corefile_thread_data thread_args
;
269 struct cleanup
*old_chain
;
270 char fname
[16] = { '\0' };
271 char psargs
[80] = { '\0' };
272 char *note_data
= NULL
;
273 ptid_t current_ptid
= inferior_ptid
;
275 if (get_exec_file (0))
277 strncpy (fname
, strrchr (get_exec_file (0), '/') + 1, sizeof (fname
));
278 strncpy (psargs
, get_exec_file (0), sizeof (psargs
));
279 if (get_inferior_args ())
281 strncat (psargs
, " ", sizeof (psargs
) - strlen (psargs
));
282 strncat (psargs
, get_inferior_args (),
283 sizeof (psargs
) - strlen (psargs
));
285 note_data
= (char *) elfcore_write_prpsinfo (obfd
,
287 note_size
, fname
, psargs
);
290 /* Dump information for threads. */
291 thread_args
.obfd
= obfd
;
292 thread_args
.note_data
= note_data
;
293 thread_args
.note_size
= note_size
;
294 thread_args
.num_notes
= 0;
295 iterate_over_lwps (linux_corefile_thread_callback
, &thread_args
);
296 if (thread_args
.num_notes
== 0)
298 /* iterate_over_threads didn't come up with any threads;
299 just use inferior_ptid. */
300 note_data
= linux_do_registers (obfd
, inferior_ptid
,
301 note_data
, note_size
);
305 note_data
= thread_args
.note_data
;
308 make_cleanup (xfree
, note_data
);
313 * Function: linux_info_proc_cmd
315 * Implement the "info proc" command.
319 linux_info_proc_cmd (char *args
, int from_tty
)
321 long long pid
= PIDGET (inferior_ptid
);
324 char buffer
[MAXPATHLEN
];
325 char fname1
[MAXPATHLEN
], fname2
[MAXPATHLEN
];
338 /* Break up 'args' into an argv array. */
339 if ((argv
= buildargv (args
)) == NULL
)
342 make_cleanup_freeargv (argv
);
344 while (argv
!= NULL
&& *argv
!= NULL
)
346 if (isdigit (argv
[0][0]))
348 pid
= strtoul (argv
[0], NULL
, 10);
350 else if (strncmp (argv
[0], "mappings", strlen (argv
[0])) == 0)
354 else if (strcmp (argv
[0], "status") == 0)
358 else if (strcmp (argv
[0], "stat") == 0)
362 else if (strcmp (argv
[0], "cmd") == 0)
366 else if (strncmp (argv
[0], "exe", strlen (argv
[0])) == 0)
370 else if (strcmp (argv
[0], "cwd") == 0)
374 else if (strncmp (argv
[0], "all", strlen (argv
[0])) == 0)
380 /* [...] (future options here) */
385 error ("No current process: you must name one.");
387 sprintf (fname1
, "/proc/%lld", pid
);
388 if (stat (fname1
, &dummy
) != 0)
389 error ("No /proc directory: '%s'", fname1
);
391 printf_filtered ("process %lld\n", pid
);
392 if (cmdline_f
|| all
)
394 sprintf (fname1
, "/proc/%lld/cmdline", pid
);
395 if ((procfile
= fopen (fname1
, "r")) > 0)
397 fgets (buffer
, sizeof (buffer
), procfile
);
398 printf_filtered ("cmdline = '%s'\n", buffer
);
402 warning ("unable to open /proc file '%s'", fname1
);
406 sprintf (fname1
, "/proc/%lld/cwd", pid
);
407 memset (fname2
, 0, sizeof (fname2
));
408 if (readlink (fname1
, fname2
, sizeof (fname2
)) > 0)
409 printf_filtered ("cwd = '%s'\n", fname2
);
411 warning ("unable to read link '%s'", fname1
);
415 sprintf (fname1
, "/proc/%lld/exe", pid
);
416 memset (fname2
, 0, sizeof (fname2
));
417 if (readlink (fname1
, fname2
, sizeof (fname2
)) > 0)
418 printf_filtered ("exe = '%s'\n", fname2
);
420 warning ("unable to read link '%s'", fname1
);
422 if (mappings_f
|| all
)
424 sprintf (fname1
, "/proc/%lld/maps", pid
);
425 if ((procfile
= fopen (fname1
, "r")) > 0)
427 long long addr
, endaddr
, size
, offset
, inode
;
428 char permissions
[8], device
[8], filename
[MAXPATHLEN
];
430 printf_filtered ("Mapped address spaces:\n\n");
431 if (TARGET_ADDR_BIT
== 32)
433 printf_filtered ("\t%10s %10s %10s %10s %7s\n",
436 " Size", " Offset", "objfile");
440 printf_filtered (" %18s %18s %10s %10s %7s\n",
443 " Size", " Offset", "objfile");
446 while (read_mapping (procfile
, &addr
, &endaddr
, &permissions
[0],
447 &offset
, &device
[0], &inode
, &filename
[0]))
449 size
= endaddr
- addr
;
451 /* FIXME: carlton/2003-08-27: Maybe the printf_filtered
452 calls here (and possibly above) should be abstracted
453 out into their own functions? Andrew suggests using
454 a generic local_address_string instead to print out
455 the addresses; that makes sense to me, too. */
457 if (TARGET_ADDR_BIT
== 32)
459 printf_filtered ("\t%#10lx %#10lx %#10x %#10x %7s\n",
460 (unsigned long) addr
, /* FIXME: pr_addr */
461 (unsigned long) endaddr
,
463 (unsigned int) offset
,
464 filename
[0] ? filename
: "");
468 printf_filtered (" %#18lx %#18lx %#10x %#10x %7s\n",
469 (unsigned long) addr
, /* FIXME: pr_addr */
470 (unsigned long) endaddr
,
472 (unsigned int) offset
,
473 filename
[0] ? filename
: "");
480 warning ("unable to open /proc file '%s'", fname1
);
484 sprintf (fname1
, "/proc/%lld/status", pid
);
485 if ((procfile
= fopen (fname1
, "r")) > 0)
487 while (fgets (buffer
, sizeof (buffer
), procfile
) != NULL
)
488 puts_filtered (buffer
);
492 warning ("unable to open /proc file '%s'", fname1
);
496 sprintf (fname1
, "/proc/%lld/stat", pid
);
497 if ((procfile
= fopen (fname1
, "r")) > 0)
502 if (fscanf (procfile
, "%d ", &itmp
) > 0)
503 printf_filtered ("Process: %d\n", itmp
);
504 if (fscanf (procfile
, "%s ", &buffer
[0]) > 0)
505 printf_filtered ("Exec file: %s\n", buffer
);
506 if (fscanf (procfile
, "%c ", &ctmp
) > 0)
507 printf_filtered ("State: %c\n", ctmp
);
508 if (fscanf (procfile
, "%d ", &itmp
) > 0)
509 printf_filtered ("Parent process: %d\n", itmp
);
510 if (fscanf (procfile
, "%d ", &itmp
) > 0)
511 printf_filtered ("Process group: %d\n", itmp
);
512 if (fscanf (procfile
, "%d ", &itmp
) > 0)
513 printf_filtered ("Session id: %d\n", itmp
);
514 if (fscanf (procfile
, "%d ", &itmp
) > 0)
515 printf_filtered ("TTY: %d\n", itmp
);
516 if (fscanf (procfile
, "%d ", &itmp
) > 0)
517 printf_filtered ("TTY owner process group: %d\n", itmp
);
518 if (fscanf (procfile
, "%u ", &itmp
) > 0)
519 printf_filtered ("Flags: 0x%x\n", itmp
);
520 if (fscanf (procfile
, "%u ", &itmp
) > 0)
521 printf_filtered ("Minor faults (no memory page): %u\n",
522 (unsigned int) itmp
);
523 if (fscanf (procfile
, "%u ", &itmp
) > 0)
524 printf_filtered ("Minor faults, children: %u\n",
525 (unsigned int) itmp
);
526 if (fscanf (procfile
, "%u ", &itmp
) > 0)
527 printf_filtered ("Major faults (memory page faults): %u\n",
528 (unsigned int) itmp
);
529 if (fscanf (procfile
, "%u ", &itmp
) > 0)
530 printf_filtered ("Major faults, children: %u\n",
531 (unsigned int) itmp
);
532 if (fscanf (procfile
, "%d ", &itmp
) > 0)
533 printf_filtered ("utime: %d\n", itmp
);
534 if (fscanf (procfile
, "%d ", &itmp
) > 0)
535 printf_filtered ("stime: %d\n", itmp
);
536 if (fscanf (procfile
, "%d ", &itmp
) > 0)
537 printf_filtered ("utime, children: %d\n", itmp
);
538 if (fscanf (procfile
, "%d ", &itmp
) > 0)
539 printf_filtered ("stime, children: %d\n", itmp
);
540 if (fscanf (procfile
, "%d ", &itmp
) > 0)
541 printf_filtered ("jiffies remaining in current time slice: %d\n",
543 if (fscanf (procfile
, "%d ", &itmp
) > 0)
544 printf_filtered ("'nice' value: %d\n", itmp
);
545 if (fscanf (procfile
, "%u ", &itmp
) > 0)
546 printf_filtered ("jiffies until next timeout: %u\n",
547 (unsigned int) itmp
);
548 if (fscanf (procfile
, "%u ", &itmp
) > 0)
549 printf_filtered ("jiffies until next SIGALRM: %u\n",
550 (unsigned int) itmp
);
551 if (fscanf (procfile
, "%d ", &itmp
) > 0)
552 printf_filtered ("start time (jiffies since system boot): %d\n",
554 if (fscanf (procfile
, "%u ", &itmp
) > 0)
555 printf_filtered ("Virtual memory size: %u\n",
556 (unsigned int) itmp
);
557 if (fscanf (procfile
, "%u ", &itmp
) > 0)
558 printf_filtered ("Resident set size: %u\n", (unsigned int) itmp
);
559 if (fscanf (procfile
, "%u ", &itmp
) > 0)
560 printf_filtered ("rlim: %u\n", (unsigned int) itmp
);
561 if (fscanf (procfile
, "%u ", &itmp
) > 0)
562 printf_filtered ("Start of text: 0x%x\n", itmp
);
563 if (fscanf (procfile
, "%u ", &itmp
) > 0)
564 printf_filtered ("End of text: 0x%x\n", itmp
);
565 if (fscanf (procfile
, "%u ", &itmp
) > 0)
566 printf_filtered ("Start of stack: 0x%x\n", itmp
);
567 #if 0 /* Don't know how architecture-dependent the rest is...
568 Anyway the signal bitmap info is available from "status". */
569 if (fscanf (procfile
, "%u ", &itmp
) > 0) /* FIXME arch? */
570 printf_filtered ("Kernel stack pointer: 0x%x\n", itmp
);
571 if (fscanf (procfile
, "%u ", &itmp
) > 0) /* FIXME arch? */
572 printf_filtered ("Kernel instr pointer: 0x%x\n", itmp
);
573 if (fscanf (procfile
, "%d ", &itmp
) > 0)
574 printf_filtered ("Pending signals bitmap: 0x%x\n", itmp
);
575 if (fscanf (procfile
, "%d ", &itmp
) > 0)
576 printf_filtered ("Blocked signals bitmap: 0x%x\n", itmp
);
577 if (fscanf (procfile
, "%d ", &itmp
) > 0)
578 printf_filtered ("Ignored signals bitmap: 0x%x\n", itmp
);
579 if (fscanf (procfile
, "%d ", &itmp
) > 0)
580 printf_filtered ("Catched signals bitmap: 0x%x\n", itmp
);
581 if (fscanf (procfile
, "%u ", &itmp
) > 0) /* FIXME arch? */
582 printf_filtered ("wchan (system call): 0x%x\n", itmp
);
587 warning ("unable to open /proc file '%s'", fname1
);
592 _initialize_linux_proc (void)
594 extern void inftarg_set_find_memory_regions ();
595 extern void inftarg_set_make_corefile_notes ();
597 inftarg_set_find_memory_regions (linux_find_memory_regions
);
598 inftarg_set_make_corefile_notes (linux_make_note_section
);
600 add_info ("proc", linux_info_proc_cmd
,
601 "Show /proc process information about any running process.\n\
602 Specify any process id, or use the program being debugged by default.\n\
603 Specify any of the following keywords for detailed info:\n\
604 mappings -- list of mapped memory regions.\n\
605 stat -- list a bunch of random process info.\n\
606 status -- list a different bunch of random process info.\n\
607 all -- list all available /proc info.");
611 linux_proc_xfer_memory (CORE_ADDR addr
, char *myaddr
, int len
, int write
,
612 struct mem_attrib
*attrib
, struct target_ops
*target
)
620 /* Don't bother for one word. */
621 if (len
< 3 * sizeof (long))
624 /* We could keep this file open and cache it - possibly one
625 per thread. That requires some juggling, but is even faster. */
626 sprintf (filename
, "/proc/%d/mem", PIDGET (inferior_ptid
));
627 fd
= open (filename
, O_RDONLY
| O_LARGEFILE
);
631 /* If pread64 is available, use it. It's faster if the kernel
632 supports it (only one syscall), and it's 64-bit safe even
633 on 32-bit platforms (for instance, SPARC debugging a SPARC64
636 if (pread64 (fd
, myaddr
, len
, addr
) != len
)
638 if (lseek (fd
, addr
, SEEK_SET
) == -1 || read (fd
, myaddr
, len
) != len
)
648 /* Parse LINE as a signal set and add its set bits to SIGS. */
651 linux_proc_add_line_to_sigset (const char *line
, sigset_t
*sigs
)
653 int len
= strlen (line
) - 1;
657 if (line
[len
] != '\n')
658 error ("Could not parse signal set: %s", line
);
666 if (*p
>= '0' && *p
<= '9')
668 else if (*p
>= 'a' && *p
<= 'f')
669 digit
= *p
- 'a' + 10;
671 error ("Could not parse signal set: %s", line
);
676 sigaddset (sigs
, signum
+ 1);
678 sigaddset (sigs
, signum
+ 2);
680 sigaddset (sigs
, signum
+ 3);
682 sigaddset (sigs
, signum
+ 4);
688 /* Find process PID's pending signals from /proc/pid/status and set SIGS
692 linux_proc_pending_signals (int pid
, sigset_t
*pending
, sigset_t
*blocked
, sigset_t
*ignored
)
695 char buffer
[MAXPATHLEN
], fname
[MAXPATHLEN
];
698 sigemptyset (pending
);
699 sigemptyset (blocked
);
700 sigemptyset (ignored
);
701 sprintf (fname
, "/proc/%d/status", pid
);
702 procfile
= fopen (fname
, "r");
703 if (procfile
== NULL
)
704 error ("Could not open %s", fname
);
706 while (fgets (buffer
, MAXPATHLEN
, procfile
) != NULL
)
708 /* Normal queued signals are on the SigPnd line in the status
709 file. However, 2.6 kernels also have a "shared" pending queue
710 for delivering signals to a thread group, so check for a ShdPnd
713 Unfortunately some Red Hat kernels include the shared pending queue
714 but not the ShdPnd status field. */
716 if (strncmp (buffer
, "SigPnd:\t", 8) == 0)
717 linux_proc_add_line_to_sigset (buffer
+ 8, pending
);
718 else if (strncmp (buffer
, "ShdPnd:\t", 8) == 0)
719 linux_proc_add_line_to_sigset (buffer
+ 8, pending
);
720 else if (strncmp (buffer
, "SigBlk:\t", 8) == 0)
721 linux_proc_add_line_to_sigset (buffer
+ 8, blocked
);
722 else if (strncmp (buffer
, "SigIgn:\t", 8) == 0)
723 linux_proc_add_line_to_sigset (buffer
+ 8, ignored
);