gdb/gdbserver/utils.c

   1 /* General utility routines for the remote server for GDB.
   2    Copyright (C) 1986-2014 Free Software Foundation, Inc.
   3
   4    This file is part of GDB.
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  18
  19 #include "server.h"
  20
  21 #ifdef IN_PROCESS_AGENT
  22 #  define PREFIX "ipa: "
  23 #  define TOOLNAME "GDBserver in-process agent"
  24 #else
  25 #  define PREFIX "gdbserver: "
  26 #  define TOOLNAME "GDBserver"
  27 #endif
  28
  29 /* Generally useful subroutines used throughout the program.  */
  30
  31 void
  32 malloc_failure (long size)
  33 {
  34   fprintf (stderr,
  35            PREFIX "ran out of memory while trying to allocate %lu bytes\n",
  36            (unsigned long) size);
  37   exit (1);
  38 }
  39
  40 /* Copy a string into a memory buffer.
  41    If malloc fails, this will print a message to stderr and exit.  */
  42
  43 char *
  44 xstrdup (const char *s)
  45 {
  46   char *ret = strdup (s);
  47   if (ret == NULL)
  48     malloc_failure (strlen (s) + 1);
  49   return ret;
  50 }
  51
  52 /* Print the system error message for errno, and also mention STRING
  53    as the file name for which the error was encountered.
  54    Then return to command level.  */
  55
  56 void
  57 perror_with_name (const char *string)
  58 {
  59   const char *err;
  60   char *combined;
  61
  62   err = strerror (errno);
  63   if (err == NULL)
  64     err = "unknown error";
  65
  66   combined = (char *) alloca (strlen (err) + strlen (string) + 3);
  67   strcpy (combined, string);
  68   strcat (combined, ": ");
  69   strcat (combined, err);
  70
  71   error ("%s.", combined);
  72 }
  73
  74 /* Print an error message and return to command level.
  75    STRING is the error message, used as a fprintf string,
  76    and ARG is passed as an argument to it.  */
  77
  78 void
  79 error (const char *string,...)
  80 {
  81 #ifndef IN_PROCESS_AGENT
  82   extern jmp_buf toplevel;
  83 #endif
  84   va_list args;
  85   va_start (args, string);
  86   fflush (stdout);
  87   vfprintf (stderr, string, args);
  88   fprintf (stderr, "\n");
  89 #ifndef IN_PROCESS_AGENT
  90   longjmp (toplevel, 1);
  91 #else
  92   exit (1);
  93 #endif
  94 }
  95
  96 /* Print an error message and exit reporting failure.
  97    This is for a error that we cannot continue from.
  98    STRING and ARG are passed to fprintf.  */
  99
 100 /* VARARGS */
 101 void
 102 fatal (const char *string,...)
 103 {
 104   va_list args;
 105   va_start (args, string);
 106   fprintf (stderr, PREFIX);
 107   vfprintf (stderr, string, args);
 108   fprintf (stderr, "\n");
 109   va_end (args);
 110   exit (1);
 111 }
 112
 113 /* VARARGS */
 114 void
 115 warning (const char *string,...)
 116 {
 117   va_list args;
 118   va_start (args, string);
 119   fprintf (stderr, PREFIX);
 120   vfprintf (stderr, string, args);
 121   fprintf (stderr, "\n");
 122   va_end (args);
 123 }
 124
 125 /* Report a problem internal to GDBserver, and exit.  */
 126
 127 void
 128 internal_error (const char *file, int line, const char *fmt, ...)
 129 {
 130   va_list args;
 131   va_start (args, fmt);
 132
 133   fprintf (stderr,  "\
 134 %s:%d: A problem internal to " TOOLNAME " has been detected.\n", file, line);
 135   vfprintf (stderr, fmt, args);
 136   fprintf (stderr, "\n");
 137   va_end (args);
 138   exit (1);
 139 }
 140
 141 /* Convert a CORE_ADDR into a HEX string, like %lx.
 142    The result is stored in a circular static buffer, NUMCELLS deep.  */
 143
 144 char *
 145 paddress (CORE_ADDR addr)
 146 {
 147   return phex_nz (addr, sizeof (CORE_ADDR));
 148 }
 149
 150 /* Convert a file descriptor into a printable string.  */
 151
 152 char *
 153 pfildes (gdb_fildes_t fd)
 154 {
 155 #if USE_WIN32API
 156   return phex_nz (fd, sizeof (gdb_fildes_t));
 157 #else
 158   return plongest (fd);
 159 #endif
 160 }