[thirdparty/binutils-gdb.git] / include / elf / reloc-macros.h

/* Generic relocation support for BFD.
   Copyright 1998, 1999, 2000 Free Software Foundation, Inc.

   This file is part of BFD, the Binary File Descriptor library.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software Foundation,
   Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */

/* These macros are used by the various *.h target specific header
   files to either generate an enum containing all the known relocations
   for that target, or if RELOC_MACROS_GEN_FUNC is defined, a recognition
   function is generated instead.  (This is used by binutils/readelf.c)

   Given a header file like this:

   	START_RELOC_NUMBERS (foo)
   	    RELOC_NUMBER (R_foo_NONE,    0)
   	    RELOC_NUMBER (R_foo_32,      1)
   	    EMPTY_RELOC  (R_foo_good)
   	    FAKE_RELOC   (R_foo_illegal, 9)
   	END_RELOC_NUMBERS (R_foo_count)

   Then the following will be produced by default (ie if
   RELOC_MACROS_GEN_FUNC is *not* defined).

   	enum foo
	{
   	  R_foo_NONE = 0,
   	  R_foo_32 = 1,
	  R_foo_good,
   	  R_foo_illegal = 9,
   	  R_foo_count
   	};

   If RELOC_MACROS_GEN_FUNC *is* defined, then instead the
   following function will be generated:

   	static const char * foo PARAMS ((unsigned long rtype));
   	static const char *
   	foo (rtype)
   	    unsigned long rtype;
   	{
   	   switch (rtype)
   	   {
   	   case 0: return "R_foo_NONE";
   	   case 1: return "R_foo_32";
   	   default: return NULL;
   	   }
   	}
   */

#ifndef _RELOC_MACROS_H
#define _RELOC_MACROS_H

#ifdef RELOC_MACROS_GEN_FUNC

/* This function takes the relocation number and returns the
   string version name of the name of that relocation.  If
   the relocation is not recognised, NULL is returned.  */

#define START_RELOC_NUMBERS(name)   				\
static const char * name    PARAMS ((unsigned long rtype)); 	\
static const char *						\
name (rtype)							\
	unsigned long rtype;					\
{								\
  switch (rtype)						\
  {

#if defined (__STDC__) || defined (ALMOST_STDC)
#define RELOC_NUMBER(name, number)  case number : return #name ;
#else
#define RELOC_NUMBER(name, number)  case number : return "name" ;
#endif

#define FAKE_RELOC(name, number)
#define EMPTY_RELOC(name)

#define END_RELOC_NUMBERS(name)	\
    default: return NULL;	\
  }				\
}


#else /* Default to generating enum.  */

#define START_RELOC_NUMBERS(name)   enum name {
#define RELOC_NUMBER(name, number)  name = number,
#define FAKE_RELOC(name, number)    name = number,
#define EMPTY_RELOC(name)           name,
#define END_RELOC_NUMBERS(name)     name };

#endif

#endif /* RELOC_MACROS_H */
Commit	Line	Data
252b5132	1	/* Generic relocation support for BFD.
4f1d9bd8	2	Copyright 1998, 1999, 2000 Free Software Foundation, Inc.
252b5132 RH	3
	4	This file is part of BFD, the Binary File Descriptor library.
	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 2 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, write to the Free Software Foundation,
	18	Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
	19
	20	/* These macros are used by the various *.h target specific header
	21	files to either generate an enum containing all the known relocations
	22	for that target, or if RELOC_MACROS_GEN_FUNC is defined, a recognition
	23	function is generated instead. (This is used by binutils/readelf.c)
	24
	25	Given a header file like this:
	26
	27	START_RELOC_NUMBERS (foo)
	28	RELOC_NUMBER (R_foo_NONE, 0)
	29	RELOC_NUMBER (R_foo_32, 1)
1b452ec6 AM	30	EMPTY_RELOC (R_foo_good)
	31	FAKE_RELOC (R_foo_illegal, 9)
	32	END_RELOC_NUMBERS (R_foo_count)
252b5132 RH	33
	34	Then the following will be produced by default (ie if
	35	RELOC_MACROS_GEN_FUNC is not defined).
	36
	37	enum foo
	38	{
252b5132 RH	39	R_foo_NONE = 0,
252b5132 RH	40	R_foo_32 = 1,
1b452ec6 AM	41	R_foo_good,
	42	R_foo_illegal = 9,
	43	R_foo_count
252b5132 RH	44	};
	45
	46	If RELOC_MACROS_GEN_FUNC is defined, then instead the
	47	following function will be generated:
	48
e15e4a63 NC	49	static const char * foo PARAMS ((unsigned long rtype));
e15e4a63 NC	50	static const char *
252b5132 RH	51	foo (rtype)
	52	unsigned long rtype;
	53	{
	54	switch (rtype)
	55	{
	56	case 0: return "R_foo_NONE";
	57	case 1: return "R_foo_32";
	58	default: return NULL;
	59	}
	60	}
	61	*/
859e1e49	62
252b5132 RH	63	#ifndef _RELOC_MACROS_H
	64	#define _RELOC_MACROS_H
	65
	66	#ifdef RELOC_MACROS_GEN_FUNC
	67
	68	/* This function takes the relocation number and returns the
	69	string version name of the name of that relocation. If
	70	the relocation is not recognised, NULL is returned. */
	71
	72	#define START_RELOC_NUMBERS(name) \
	73	static const char * name PARAMS ((unsigned long rtype)); \
	74	static const char * \
	75	name (rtype) \
	76	unsigned long rtype; \
	77	{ \
	78	switch (rtype) \
	79	{
	80
859e1e49	81	#if defined (__STDC__) \|\| defined (ALMOST_STDC)
252b5132 RH	82	#define RELOC_NUMBER(name, number) case number : return #name ;
	83	#else
	84	#define RELOC_NUMBER(name, number) case number : return "name" ;
	85	#endif
	86
859e1e49	87	#define FAKE_RELOC(name, number)
252b5132	88	#define EMPTY_RELOC(name)
859e1e49	89
1b452ec6	90	#define END_RELOC_NUMBERS(name) \
252b5132 RH	91	default: return NULL; \
	92	} \
	93	}
	94
	95
	96	#else /* Default to generating enum. */
	97
1b452ec6 AM	98	#define START_RELOC_NUMBERS(name) enum name {
	99	#define RELOC_NUMBER(name, number) name = number,
	100	#define FAKE_RELOC(name, number) name = number,
	101	#define EMPTY_RELOC(name) name,
	102	#define END_RELOC_NUMBERS(name) name };
252b5132 RH	103
	104	#endif
	105
	106	#endif /* RELOC_MACROS_H */