cddl/contrib/opensolaris/lib/libdtrace/common/dt_error.c

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21
  22 /*
  23  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26
  27 /*
  28  * Copyright (c) 2012 by Delphix. All rights reserved.
  29  */
  30
  31 #include <string.h>
  32 #include <strings.h>
  33 #include <dt_impl.h>
  34
  35 static const struct {
  36         int err;
  37         const char *msg;
  38 } _dt_errlist[] = {
  39         { EDT_VERSION,  "Client requested version newer than library" },
  40         { EDT_VERSINVAL, "Version is not properly formatted or is too large" },
  41         { EDT_VERSUNDEF, "Requested version is not supported by compiler" },
  42         { EDT_VERSREDUCED, "Requested version conflicts with earlier setting" },
  43         { EDT_CTF,      "Unexpected libctf error" },
  44         { EDT_COMPILER, "Error in D program compilation" },
  45         { EDT_NOTUPREG, "Insufficient tuple registers to generate code" },
  46         { EDT_NOMEM,    "Memory allocation failure" },
  47         { EDT_INT2BIG,  "Integer constant table limit exceeded" },
  48         { EDT_STR2BIG,  "String constant table limit exceeded" },
  49         { EDT_NOMOD,    "Unknown module name" },
  50         { EDT_NOPROV,   "Unknown provider name" },
  51         { EDT_NOPROBE,  "No probe matches description" },
  52         { EDT_NOSYM,    "Unknown symbol name" },
  53         { EDT_NOSYMADDR, "No symbol corresponds to address" },
  54         { EDT_NOTYPE,   "Unknown type name" },
  55         { EDT_NOVAR,    "Unknown variable name" },
  56         { EDT_NOAGG,    "Unknown aggregation name" },
  57         { EDT_BADSCOPE, "Improper use of scoping operator in type name" },
  58         { EDT_BADSPEC,  "Overspecified probe description" },
  59         { EDT_BADSPCV,  "Undefined macro variable in probe description" },
  60         { EDT_BADID,    "Unknown probe identifier" },
  61         { EDT_NOTLOADED, "Module is no longer loaded" },
  62         { EDT_NOCTF,    "Module does not contain any CTF data" },
  63         { EDT_DATAMODEL, "Module and program data models do not match" },
  64         { EDT_DIFVERS,  "Library uses newer DIF version than kernel" },
  65         { EDT_BADAGG,   "Unknown aggregating action" },
  66         { EDT_FIO,      "Error occurred while reading from input stream" },
  67         { EDT_DIFINVAL, "DIF program content is invalid" },
  68         { EDT_DIFSIZE,  "DIF program exceeds maximum program size" },
  69         { EDT_DIFFAULT, "DIF program contains invalid pointer" },
  70         { EDT_BADPROBE, "Invalid probe specification" },
  71         { EDT_BADPGLOB, "Probe description has too many globbing characters" },
  72         { EDT_NOSCOPE,  "Declaration scope stack underflow" },
  73         { EDT_NODECL,   "Declaration stack underflow" },
  74         { EDT_DMISMATCH, "Data record list does not match statement" },
  75         { EDT_DOFFSET,  "Data record offset exceeds buffer boundary" },
  76         { EDT_DALIGN,   "Data record has inappropriate alignment" },
  77         { EDT_BADOPTNAME, "Invalid option name" },
  78         { EDT_BADOPTVAL, "Invalid value for specified option" },
  79         { EDT_BADOPTCTX, "Option cannot be used from within a D program" },
  80         { EDT_CPPFORK,  "Failed to fork preprocessor" },
  81         { EDT_CPPEXEC,  "Failed to exec preprocessor" },
  82         { EDT_CPPENT,   "Preprocessor not found" },
  83         { EDT_CPPERR,   "Preprocessor failed to process input program" },
  84         { EDT_SYMOFLOW, "Symbol table identifier space exhausted" },
  85         { EDT_ACTIVE,   "Operation illegal when tracing is active" },
  86         { EDT_DESTRUCTIVE, "Destructive actions not allowed" },
  87         { EDT_NOANON,   "No anonymous tracing state" },
  88         { EDT_ISANON,   "Can't claim anonymous state and enable probes" },
  89         { EDT_ENDTOOBIG, "END enablings exceed size of principal buffer" },
  90         { EDT_NOCONV,   "Failed to load type for printf conversion" },
  91         { EDT_BADCONV,  "Incomplete printf conversion" },
  92         { EDT_BADERROR, "Invalid library ERROR action" },
  93         { EDT_ERRABORT, "Abort due to error" },
  94         { EDT_DROPABORT, "Abort due to drop" },
  95         { EDT_DIRABORT, "Abort explicitly directed" },
  96         { EDT_BADRVAL,  "Invalid return value from callback" },
  97         { EDT_BADNORMAL, "Invalid normalization" },
  98         { EDT_BUFTOOSMALL, "Enabling exceeds size of buffer" },
  99         { EDT_BADTRUNC, "Invalid truncation" },
 100         { EDT_BUSY, "DTrace cannot be used when kernel debugger is active" },
 101         { EDT_ACCESS, "DTrace requires additional privileges" },
 102         { EDT_NOENT, "DTrace device not available on system" },
 103         { EDT_BRICKED, "Abort due to systemic unresponsiveness" },
 104         { EDT_HARDWIRE, "Failed to load language definitions" },
 105         { EDT_ELFVERSION, "libelf is out-of-date with respect to libdtrace" },
 106         { EDT_NOBUFFERED, "Attempt to buffer output without handler" },
 107         { EDT_UNSTABLE, "Description matched an unstable set of probes" },
 108         { EDT_BADSETOPT, "Invalid setopt() library action" },
 109         { EDT_BADSTACKPC, "Invalid stack program counter size" },
 110         { EDT_BADAGGVAR, "Invalid aggregation variable identifier" },
 111         { EDT_OVERSION, "Client requested deprecated version of library" },
 112         { EDT_ENABLING_ERR, "Failed to enable probe" }
 113 };
 114
 115 static const int _dt_nerr = sizeof (_dt_errlist) / sizeof (_dt_errlist[0]);
 116
 117 const char *
 118 dtrace_errmsg(dtrace_hdl_t *dtp, int error)
 119 {
 120         const char *str;
 121         int i;
 122
 123         if (error == EDT_COMPILER && dtp != NULL && dtp->dt_errmsg[0] != '\0')
 124                 str = dtp->dt_errmsg;
 125         else if (error == EDT_CTF && dtp != NULL && dtp->dt_ctferr != 0)
 126                 str = ctf_errmsg(dtp->dt_ctferr);
 127         else if (error >= EDT_BASE && (error - EDT_BASE) < _dt_nerr) {
 128                 for (i = 0; i < _dt_nerr; i++) {
 129                         if (_dt_errlist[i].err == error)
 130                                 return (_dt_errlist[i].msg);
 131                 }
 132                 str = NULL;
 133         } else
 134                 str = strerror(error);
 135
 136         return (str ? str : "Unknown error");
 137 }
 138
 139 int
 140 dtrace_errno(dtrace_hdl_t *dtp)
 141 {
 142         return (dtp->dt_errno);
 143 }
 144
 145 #if defined(sun)
 146 int
 147 dt_set_errno(dtrace_hdl_t *dtp, int err)
 148 {
 149         dtp->dt_errno = err;
 150         return (-1);
 151 }
 152 #else
 153 int
 154 _dt_set_errno(dtrace_hdl_t *dtp, int err, const char *errfile, int errline)
 155 {
 156         dtp->dt_errno = err;
 157         dtp->dt_errfile = errfile;
 158         dtp->dt_errline = errline;
 159         return (-1);
 160 }
 161
 162 void dt_get_errloc(dtrace_hdl_t *dtp, const char **p_errfile, int *p_errline)
 163 {
 164         *p_errfile = dtp->dt_errfile;
 165         *p_errline = dtp->dt_errline;
 166 }
 167 #endif
 168
 169 void
 170 dt_set_errmsg(dtrace_hdl_t *dtp, const char *errtag, const char *region,
 171     const char *filename, int lineno, const char *format, va_list ap)
 172 {
 173         size_t len, n;
 174         char *p, *s;
 175
 176         s = dtp->dt_errmsg;
 177         n = sizeof (dtp->dt_errmsg);
 178
 179         if (errtag != NULL && (yypcb->pcb_cflags & DTRACE_C_ETAGS))
 180                 (void) snprintf(s, n, "[%s] ", errtag);
 181         else
 182                 s[0] = '\0';
 183
 184         len = strlen(dtp->dt_errmsg);
 185         s = dtp->dt_errmsg + len;
 186         n = sizeof (dtp->dt_errmsg) - len;
 187
 188         if (filename == NULL)
 189                 filename = dtp->dt_filetag;
 190
 191         if (filename != NULL)
 192                 (void) snprintf(s, n, "\"%s\", line %d: ", filename, lineno);
 193         else if (lineno != 0)
 194                 (void) snprintf(s, n, "line %d: ", lineno);
 195         else if (region != NULL)
 196                 (void) snprintf(s, n, "in %s: ", region);
 197
 198         len = strlen(dtp->dt_errmsg);
 199         s = dtp->dt_errmsg + len;
 200         n = sizeof (dtp->dt_errmsg) - len;
 201         (void) vsnprintf(s, n, format, ap);
 202
 203         if ((p = strrchr(dtp->dt_errmsg, '\n')) != NULL)
 204                 *p = '\0'; /* remove trailing \n from message buffer */
 205
 206         dtp->dt_errtag = errtag;
 207 }
 208
 209 /*ARGSUSED*/
 210 const char *
 211 dtrace_faultstr(dtrace_hdl_t *dtp, int fault)
 212 {
 213         int i;
 214
 215         static const struct {
 216                 int code;
 217                 const char *str;
 218         } faults[] = {
 219                 { DTRACEFLT_BADADDR,    "invalid address" },
 220                 { DTRACEFLT_BADALIGN,   "invalid alignment" },
 221                 { DTRACEFLT_ILLOP,      "illegal operation" },
 222                 { DTRACEFLT_DIVZERO,    "divide-by-zero" },
 223                 { DTRACEFLT_NOSCRATCH,  "out of scratch space" },
 224                 { DTRACEFLT_KPRIV,      "invalid kernel access" },
 225                 { DTRACEFLT_UPRIV,      "invalid user access" },
 226                 { DTRACEFLT_TUPOFLOW,   "tuple stack overflow" },
 227                 { DTRACEFLT_BADSTACK,   "bad stack" },
 228                 { DTRACEFLT_LIBRARY,    "library-level fault" },
 229                 { 0,                    NULL }
 230         };
 231
 232         for (i = 0; faults[i].str != NULL; i++) {
 233                 if (faults[i].code == fault)
 234                         return (faults[i].str);
 235         }
 236
 237         return ("unknown fault");
 238 }