source: trunk/binutils/include/xtensa-isa.h@ 2795

/* Interface definition for configurable Xtensa ISA support.
   Copyright 2003 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.  */

#ifndef XTENSA_LIBISA_H
#define XTENSA_LIBISA_H

/* Use the statically-linked version for the GNU tools.  */
#define STATIC_LIBISA 1

#ifdef __cplusplus
extern "C" {
#endif

#ifndef uint32
#define uint32 unsigned int
#endif

/* This file defines the interface to the Xtensa ISA library.  This library
   contains most of the ISA-specific information for a particular Xtensa
   processor.  For example, the set of valid instructions, their opcode
   encodings and operand fields are all included here.  To support Xtensa's
   configurability and user-defined instruction extensions (i.e., TIE), the
   library is initialized by loading one or more dynamic libraries; only a
   small set of interface code is present in the statically-linked portion
   of the library.

   This interface basically defines four abstract data types.

   . an instruction buffer - for holding the raw instruction bits
   . ISA info - information about the ISA as a whole
   . opcode info - information about individual instructions
   . operand info - information about specific instruction operands

   It would be nice to implement these as classes in C++, but the library is
   implemented in C to match the expectations of the GNU tools.
   Instead, the interface defines a set of functions to access each data
   type.  With the exception of the instruction buffer, the internal
   representations of the data structures are hidden.  All accesses must be
   made through the functions defined here.  */

typedef void* xtensa_isa;
typedef void* xtensa_operand;


/* Opcodes are represented here using sequential integers beginning with 0.
   The specific value used for a particular opcode is only fixed for a
   particular instantiation of an xtensa_isa structure, so these values
   should only be used internally.  */
typedef int xtensa_opcode;

/* Define a unique value for undefined opcodes ("static const int" doesn't
   seem to work for this because EGCS 1.0.3 on i686-Linux without -O won't
   allow it to be used as an initializer).  */
#define XTENSA_UNDEFINED -1


typedef int libisa_module_specifier;

extern xtensa_isa xtensa_isa_init (void);


/* Instruction buffers.  */

typedef uint32 xtensa_insnbuf_word;
typedef xtensa_insnbuf_word *xtensa_insnbuf;

/* Get the size in words of the xtensa_insnbuf array.  */
extern int xtensa_insnbuf_size (xtensa_isa); 

/* Allocate (with malloc) an xtensa_insnbuf of the right size.  */
extern xtensa_insnbuf xtensa_insnbuf_alloc (xtensa_isa);

/* Release (with free) an xtensa_insnbuf of the right size.  */
extern void xtensa_insnbuf_free (xtensa_insnbuf);

/* Inward and outward conversion from memory images (byte streams) to our
   internal instruction representation.  */
extern void xtensa_insnbuf_to_chars (xtensa_isa, const xtensa_insnbuf,
                                     char *);

extern void xtensa_insnbuf_from_chars (xtensa_isa, xtensa_insnbuf,
                                       const char *);


/* ISA information.  */

/* Load the ISA information from a shared library.  If successful, this returns
   a value which identifies the ISA for use in subsequent calls to the ISA
   library; otherwise, it returns NULL.  Multiple ISAs can be loaded to support
   heterogeneous multiprocessor systems.  */
extern xtensa_isa xtensa_load_isa (libisa_module_specifier);

/* Extend an existing set of ISA information by loading an additional shared
   library of ISA information.  This is primarily intended for loading TIE
   extensions.  If successful, the return value is non-zero.  */
extern int xtensa_extend_isa (xtensa_isa, libisa_module_specifier);

/* The default ISA.  This variable is set automatically to the ISA most
   recently loaded and is provided as a convenience.  An exception is the GNU
   opcodes library, where there is a fixed interface that does not allow
   passing the ISA as a parameter and the ISA must be taken from this global
   variable.  (Note: Since this variable is just a convenience, it is not
   exported when libisa is built as a DLL, due to the hassle of dealing with