1 /* Machine-independent support for SVR4 /proc (process file system) 2 3 Copyright (C) 1999-2016 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 } 174