gdb/proc-flags.c

   1 /* Machine independent support for Solaris /proc (process file system) for GDB.
   2    Copyright (C) 1999-2024 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 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 /*
  22  * Pretty-print the prstatus flags.
  23  *
  24  * Arguments: unsigned long flags, int verbose
  25  *
  26  */
  27
  28
  29 #include <sys/types.h>
  30 #include <sys/procfs.h>
  31
  32 #include "proc-utils.h"
  33
  34 /*  Much of the information used in the /proc interface, particularly for
  35     printing status information, is kept as tables of structures of the
  36     following form.  These tables can be used to map numeric values to
  37     their symbolic names and to a string that describes their specific use.  */
  38
  39 struct trans {
  40   int value;                    /* The numeric value */
  41   const char *name;             /* The equivalent symbolic value */
  42   const char *desc;             /* Short description of value */
  43 };
  44
  45 /* Translate bits in the pr_flags member of the prstatus structure,
  46    into the names and desc information.  */
  47
  48 static struct trans pr_flag_table[] =
  49 {
  50   /* lwp is stopped */
  51   { PR_STOPPED, "PR_STOPPED", "Process (LWP) is stopped" },
  52   /* lwp is stopped on an event of interest */
  53   { PR_ISTOP, "PR_ISTOP", "Stopped on an event of interest" },
  54   /* lwp has a stop directive in effect */
  55   { PR_DSTOP, "PR_DSTOP", "A stop directive is in effect" },
  56   /* lwp has a single-step directive in effect */
  57   { PR_STEP, "PR_STEP", "A single step directive is in effect" },
  58   /* lwp is sleeping in a system call */
  59   { PR_ASLEEP, "PR_ASLEEP", "Sleeping in an (interruptible) system call" },
  60   /* contents of pr_instr undefined */
  61   { PR_PCINVAL, "PR_PCINVAL", "PC (pr_instr) is invalid" },
  62   /* this lwp is the aslwp */
  63   { PR_ASLWP, "PR_ASLWP", "This is the asynchronous signal LWP" },
  64   /* this lwp is the /proc agent lwp */
  65   { PR_AGENT, "PR_AGENT", "This is the /proc agent LWP" },
  66   /* this is a system process */
  67   { PR_ISSYS, "PR_ISSYS", "Is a system process/thread" },
  68   /* process is the parent of a vfork()d child */
  69   { PR_VFORKP, "PR_VFORKP", "Process is the parent of a vforked child" },
  70   /* process's process group is orphaned */
  71   { PR_ORPHAN, "PR_ORPHAN", "Process's process group is orphaned" },
  72   /* inherit-on-fork is in effect */
  73   { PR_FORK, "PR_FORK", "Inherit-on-fork is in effect" },
  74   /* run-on-last-close is in effect */
  75   { PR_RLC, "PR_RLC", "Run-on-last-close is in effect" },
  76   /* kill-on-last-close is in effect */
  77   { PR_KLC, "PR_KLC", "Kill-on-last-close is in effect" },
  78   /* asynchronous-stop is in effect */
  79   { PR_ASYNC, "PR_ASYNC", "Asynchronous stop is in effect" },
  80   /* micro-state usage accounting is in effect */
  81   { PR_MSACCT, "PR_MSACCT", "Microstate accounting enabled" },
  82   /* breakpoint trap pc adjustment is in effect */
  83   { PR_BPTADJ, "PR_BPTADJ", "Breakpoint PC adjustment in effect" },
  84   /* ptrace-compatibility mode is in effect */
  85   { PR_PTRACE, "PR_PTRACE", "Process is being controlled by ptrace" },
  86   /* micro-state accounting inherited on fork */
  87   { PR_MSFORK, "PR_PCOMPAT", "Micro-state accounting inherited on fork" },
  88 };
  89
  90 void
  91 proc_prettyfprint_flags (FILE *file, unsigned long flags, int verbose)
  92 {
  93   int i;
  94
  95   for (i = 0; i < sizeof (pr_flag_table) / sizeof (pr_flag_table[0]); i++)
  96     if (flags & pr_flag_table[i].value)
  97       {
  98         fprintf (file, "%s ", pr_flag_table[i].name);
  99         if (verbose)
 100           fprintf (file, "%s\n", pr_flag_table[i].desc);
 101       }
 102   if (!verbose)
 103     fprintf (file, "\n");
 104 }
 105
 106 void
 107 proc_prettyprint_flags (unsigned long flags, int verbose)
 108 {
 109   proc_prettyfprint_flags (stdout, flags, verbose);
 110 }