lib/libelf/elf_errmsg.c

   1 /*-
   2  * Copyright (c) 2006,2008,2011 Joseph Koshy
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  */
  26
  27 #include <sys/cdefs.h>
  28
  29 #include <libelf.h>
  30 #include <stdio.h>
  31 #include <string.h>
  32
  33 #include "_libelf.h"
  34
  35 LIBELF_VCSID("$Id$");
  36
  37 /*
  38  * Retrieve a human readable translation for an error message.
  39  */
  40
  41 const char *_libelf_errors[] = {
  42 #define DEFINE_ERROR(N,S)       [ELF_E_##N] = S
  43         DEFINE_ERROR(NONE,      "No Error"),
  44         DEFINE_ERROR(ARCHIVE,   "Malformed ar(1) archive"),
  45         DEFINE_ERROR(ARGUMENT,  "Invalid argument"),
  46         DEFINE_ERROR(CLASS,     "ELF class mismatch"),
  47         DEFINE_ERROR(DATA,      "Invalid data buffer descriptor"),
  48         DEFINE_ERROR(HEADER,    "Missing or malformed ELF header"),
  49         DEFINE_ERROR(IO,        "I/O error"),
  50         DEFINE_ERROR(LAYOUT,    "Layout constraint violation"),
  51         DEFINE_ERROR(MODE,      "Incorrect ELF descriptor mode"),
  52         DEFINE_ERROR(RANGE,     "Value out of range of target"),
  53         DEFINE_ERROR(RESOURCE,  "Resource exhaustion"),
  54         DEFINE_ERROR(SECTION,   "Invalid section descriptor"),
  55         DEFINE_ERROR(SEQUENCE,  "API calls out of sequence"),
  56         DEFINE_ERROR(UNIMPL,    "Unimplemented feature"),
  57         DEFINE_ERROR(VERSION,   "Unknown ELF API version"),
  58         DEFINE_ERROR(NUM,       "Unknown error")
  59 #undef  DEFINE_ERROR
  60 };
  61
  62 const char *
  63 elf_errmsg(int error)
  64 {
  65         int oserr;
  66
  67         if (error == ELF_E_NONE &&
  68             (error = LIBELF_PRIVATE(error)) == 0)
  69             return NULL;
  70         else if (error == -1)
  71             error = LIBELF_PRIVATE(error);
  72
  73         oserr = error >> LIBELF_OS_ERROR_SHIFT;
  74         error &= LIBELF_ELF_ERROR_MASK;
  75
  76         if (error < ELF_E_NONE || error >= ELF_E_NUM)
  77                 return _libelf_errors[ELF_E_NUM];
  78         if (oserr) {
  79                 (void) snprintf(LIBELF_PRIVATE(msg),
  80                     sizeof(LIBELF_PRIVATE(msg)), "%s: %s",
  81                     _libelf_errors[error], strerror(oserr));
  82                 return (const char *)&LIBELF_PRIVATE(msg);
  83         }
  84         return _libelf_errors[error];
  85 }