This commit was generated by cvs2svn to track changes on a CVS vendor
[external/binutils.git] / gdb / proc-why.c
1 /* Machine independent support for SVR4 /proc (process file system) for GDB.
2    Copyright 1999 Free Software Foundation, Inc.
3    Written by Michael Snyder at Cygnus Solutions.
4    Based on work by Fred Fish, Stu Grossman, Geoff Noer, and others.
5
6 This file is part of GDB.
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 2 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, write to the Free Software Foundation, 
20 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
21
22 /*
23  * Pretty-print the pr_why value.
24  * 
25  * Arguments: unsigned long flags, int verbose
26  *
27  */
28
29 #include "defs.h"
30
31 #if defined(NEW_PROC_API)
32 #define _STRUCTURED_PROC 1
33 #endif
34
35 #include <stdio.h>
36 #include <sys/types.h>
37 #include <sys/procfs.h>
38
39 #include "proc-utils.h"
40
41 /*  Much of the information used in the /proc interface, particularly for
42     printing status information, is kept as tables of structures of the
43     following form.  These tables can be used to map numeric values to
44     their symbolic names and to a string that describes their specific use. */
45
46 struct trans {
47   int value;                    /* The numeric value */
48   char *name;                   /* The equivalent symbolic value */
49   char *desc;                   /* Short description of value */
50 };
51
52 /*  Translate values in the pr_why field of the prstatus struct. */
53
54 static struct trans pr_why_table[] =
55 {
56 #if defined (PR_REQUESTED)
57   /* All platforms */
58   { PR_REQUESTED, "PR_REQUESTED", 
59     "Directed to stop by debugger via P(IO)CSTOP or P(IO)CWSTOP" },
60 #endif
61 #if defined (PR_SIGNALLED)
62   /* All platforms */
63   { PR_SIGNALLED, "PR_SIGNALLED", "Receipt of a traced signal" },
64 #endif
65 #if defined (PR_SYSENTRY)
66   /* All platforms */
67   { PR_SYSENTRY, "PR_SYSENTRY", "Entry to a traced system call" },
68 #endif
69 #if defined (PR_SYSEXIT)
70   /* All platforms */
71   { PR_SYSEXIT, "PR_SYSEXIT", "Exit from a traced system call" },
72 #endif
73 #if defined (PR_JOBCONTROL)
74   /* All platforms */
75   { PR_JOBCONTROL, "PR_JOBCONTROL", "Default job control stop signal action" },
76 #endif
77 #if defined (PR_FAULTED)
78   /* All platforms */
79   { PR_FAULTED, "PR_FAULTED", "Incurred a traced hardware fault" },
80 #endif
81 #if defined (PR_SUSPENDED)
82   /* Solaris and UnixWare */
83   { PR_SUSPENDED, "PR_SUSPENDED", "Process suspended" },
84 #endif
85 #if defined (PR_CHECKPOINT)
86   /* Solaris only */
87   { PR_CHECKPOINT, "PR_CHECKPOINT", "Process stopped at checkpoint" },
88 #endif
89 #if defined (PR_FORKSTOP)
90   /* OSF only */
91   { PR_FORKSTOP, "PR_FORKSTOP", "Process stopped at end of fork call" },
92 #endif
93 #if defined (PR_TCRSTOP)
94   /* OSF only */
95   { PR_TCRSTOP, "PR_TCRSTOP", "Process stopped on thread creation" },
96 #endif
97 #if defined (PR_TTSTOP)
98   /* OSF only */
99   { PR_TTSTOP, "PR_TTSTOP", "Process stopped on thread termination" },
100 #endif
101 #if defined (PR_DEAD)
102   /* OSF only */
103   { PR_DEAD, "PR_DEAD", "Process stopped in exit system call" },
104 #endif
105 };
106
107 void
108 proc_prettyfprint_why (file, why, what, verbose)
109      FILE         *file;
110      unsigned long why; 
111      unsigned long what; 
112      int           verbose;
113 {
114   int i;
115
116   if (why == 0)
117     return;
118
119   for (i = 0; i < sizeof (pr_why_table) / sizeof (pr_why_table[0]); i++)
120     if (why == pr_why_table[i].value)
121       {
122         fprintf (file, "%s ", pr_why_table[i].name);
123         if (verbose)
124           fprintf (file, ": %s ", pr_why_table[i].desc);
125
126         switch (why) {
127 #ifdef PR_REQUESTED
128         case PR_REQUESTED:
129           break;        /* Nothing more to print. */
130 #endif
131 #ifdef PR_SIGNALLED
132         case PR_SIGNALLED:
133           proc_prettyfprint_signal (file, what, verbose);
134           break;
135 #endif
136 #ifdef PR_FAULTED
137         case PR_FAULTED:
138           proc_prettyfprint_fault (file, what, verbose);
139           break;
140 #endif
141 #ifdef PR_SYSENTRY
142         case PR_SYSENTRY:
143           fprintf (file, "Entry to ");
144           proc_prettyfprint_syscall (file, what, verbose);
145           break;
146 #endif
147 #ifdef PR_SYSEXIT
148         case PR_SYSEXIT:
149           fprintf (file, "Exit from ");
150           proc_prettyfprint_syscall (file, what, verbose);
151           break;
152 #endif
153 #ifdef PR_JOBCONTROL
154         case PR_JOBCONTROL:
155           proc_prettyfprint_signal (file, what, verbose);
156           break;
157 #endif
158 #ifdef PR_DEAD
159         case PR_DEAD:
160           fprintf (file, "Exit status: %d\n", what);
161           break;
162 #endif
163         default:
164           fprintf (file, "Unknown why %ld, what %ld\n", why, what);
165           break;
166         }
167         fprintf (file, "\n");
168
169         return;
170       }
171   fprintf (file, "Unknown pr_why.\n");
172 }
173
174 void
175 proc_prettyprint_why (why, what, verbose)
176      unsigned long why; 
177      unsigned long what; 
178      int           verbose;
179 {
180   proc_prettyfprint_why (stdout, why, what, verbose);
181 }