gdb/proc-why.c

   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 }