GDB (xrefs)
/tmp/gdb-7.10/gdb/proc-why.c
Go to the documentation of this file.
1 /* Machine-independent support for SVR4 /proc (process file system)
2 
3  Copyright (C) 1999-2015 Free Software Foundation, Inc.
4 
5  Written by Michael Snyder at Cygnus Solutions.
6  Based on work by Fred Fish, Stu Grossman, Geoff Noer, and others.
7 
8  This program is free software; you can redistribute it and/or modify
9  it under the terms of the GNU General Public License as published by
10  the Free Software Foundation; either version 3 of the License, or
11  (at your option) any later version.
12 
13  This program is distributed in the hope that it will be useful,
14  but WITHOUT ANY WARRANTY; without even the implied warranty of
15  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  GNU General Public License for more details.
17 
18  You should have received a copy of the GNU General Public License
19  along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 
21 #include "defs.h"
22 
23 #ifdef NEW_PROC_API
24 #define _STRUCTURED_PROC 1
25 #endif
26 
27 #include <sys/types.h>
28 #include <sys/procfs.h>
29 
30 #include "proc-utils.h"
31 
32 /* Much of the information used in the /proc interface, particularly
33  for printing status information, is kept as tables of structures of
34  the following form. These tables can be used to map numeric values
35  to their symbolic names and to a string that describes their
36  specific use. */
37 
38 struct trans
39 {
40  int value; /* The numeric value. */
41  char *name; /* The equivalent symbolic value. */
42  char *desc; /* Short description of value. */
43 };
44 
45 /* Translate values in the pr_why field of a `struct prstatus' or
46  `struct lwpstatus'. */
47 
48 static struct trans pr_why_table[] =
49 {
50 #if defined (PR_REQUESTED)
51  /* All platforms. */
52  { PR_REQUESTED, "PR_REQUESTED",
53  "Directed to stop by debugger via P(IO)CSTOP or P(IO)CWSTOP" },
54 #endif
55 #if defined (PR_SIGNALLED)
56  /* All platforms. */
57  { PR_SIGNALLED, "PR_SIGNALLED", "Receipt of a traced signal" },
58 #endif
59 #if defined (PR_SYSENTRY)
60  /* All platforms. */
61  { PR_SYSENTRY, "PR_SYSENTRY", "Entry to a traced system call" },
62 #endif
63 #if defined (PR_SYSEXIT)
64  /* All platforms. */
65  { PR_SYSEXIT, "PR_SYSEXIT", "Exit from a traced system call" },
66 #endif
67 #if defined (PR_JOBCONTROL)
68  /* All platforms. */
69  { PR_JOBCONTROL, "PR_JOBCONTROL", "Default job control stop signal action" },
70 #endif
71 #if defined (PR_FAULTED)
72  /* All platforms. */
73  { PR_FAULTED, "PR_FAULTED", "Incurred a traced hardware fault" },
74 #endif
75 #if defined (PR_SUSPENDED)
76  /* Solaris only. */
77  { PR_SUSPENDED, "PR_SUSPENDED", "Process suspended" },
78 #endif
79 #if defined (PR_CHECKPOINT)
80  /* Solaris only. */
81  { PR_CHECKPOINT, "PR_CHECKPOINT", "Process stopped at checkpoint" },
82 #endif
83 #if defined (PR_FORKSTOP)
84  /* OSF/1 only. */
85  { PR_FORKSTOP, "PR_FORKSTOP", "Process stopped at end of fork call" },
86 #endif
87 #if defined (PR_TCRSTOP)
88  /* OSF/1 only. */
89  { PR_TCRSTOP, "PR_TCRSTOP", "Process stopped on thread creation" },
90 #endif
91 #if defined (PR_TTSTOP)
92  /* OSF/1 only. */
93  { PR_TTSTOP, "PR_TTSTOP", "Process stopped on thread termination" },
94 #endif
95 #if defined (PR_DEAD)
96  /* OSF/1 only. */
97  { PR_DEAD, "PR_DEAD", "Process stopped in exit system call" },
98 #endif
99 };
100 
101 /* Pretty-print the pr_why field of a `struct prstatus' or `struct
102  lwpstatus'. */
103 
104 void
105 proc_prettyfprint_why (FILE *file, unsigned long why, unsigned long what,
106  int verbose)
107 {
108  int i;
109 
110  if (why == 0)
111  return;
112 
113  for (i = 0; i < ARRAY_SIZE (pr_why_table); i++)
114  if (why == pr_why_table[i].value)
115  {
116  fprintf (file, "%s ", pr_why_table[i].name);
117  if (verbose)
118  fprintf (file, ": %s ", pr_why_table[i].desc);
119 
120  switch (why) {
121 #ifdef PR_REQUESTED
122  case PR_REQUESTED:
123  break; /* Nothing more to print. */
124 #endif
125 #ifdef PR_SIGNALLED
126  case PR_SIGNALLED:
127  proc_prettyfprint_signal (file, what, verbose);
128  break;
129 #endif
130 #ifdef PR_FAULTED
131  case PR_FAULTED:
132  proc_prettyfprint_fault (file, what, verbose);
133  break;
134 #endif
135 #ifdef PR_SYSENTRY
136  case PR_SYSENTRY:
137  fprintf (file, "Entry to ");
138  proc_prettyfprint_syscall (file, what, verbose);
139  break;
140 #endif
141 #ifdef PR_SYSEXIT
142  case PR_SYSEXIT:
143  fprintf (file, "Exit from ");
144  proc_prettyfprint_syscall (file, what, verbose);
145  break;
146 #endif
147 #ifdef PR_JOBCONTROL
148  case PR_JOBCONTROL:
149  proc_prettyfprint_signal (file, what, verbose);
150  break;
151 #endif
152 #ifdef PR_DEAD
153  case PR_DEAD:
154  fprintf (file, "Exit status: %ld\n", what);
155  break;
156 #endif
157  default:
158  fprintf (file, "Unknown why %ld, what %ld\n", why, what);
159  break;
160  }
161  fprintf (file, "\n");
162 
163  return;
164  }
165 
166  fprintf (file, "Unknown pr_why.\n");
167 }
168 
169 void
170 proc_prettyprint_why (unsigned long why, unsigned long what, int verbose)
171 {
172  proc_prettyfprint_why (stdout, why, what, verbose);
173 }
void proc_prettyfprint_why(FILE *file, unsigned long why, unsigned long what, int verbose)
Definition: proc-why.c:105
char * desc
Definition: proc-api.c:58
void proc_prettyprint_why(unsigned long why, unsigned long what, int verbose)
Definition: proc-why.c:170
const char *const name
Definition: aarch64-tdep.c:68
long value
Definition: proc-api.c:56
char * name
Definition: proc-api.c:57
Definition: value.c:172
void proc_prettyfprint_signal(FILE *file, int signo, int verbose)
Definition: proc-events.c:1546
void proc_prettyfprint_fault(FILE *file, int faultno, int verbose)
Definition: proc-events.c:1664
void proc_prettyfprint_syscall(FILE *file, int num, int verbose)
Definition: proc-events.c:1361
Definition: proc-api.c:55