summaryrefslogtreecommitdiff
path: root/misc/buildroot/toolchain/nxflat/nxflat.h
diff options
context:
space:
mode:
Diffstat (limited to 'misc/buildroot/toolchain/nxflat/nxflat.h')
-rw-r--r--misc/buildroot/toolchain/nxflat/nxflat.h164
1 files changed, 164 insertions, 0 deletions
diff --git a/misc/buildroot/toolchain/nxflat/nxflat.h b/misc/buildroot/toolchain/nxflat/nxflat.h
new file mode 100644
index 000000000..e8419426a
--- /dev/null
+++ b/misc/buildroot/toolchain/nxflat/nxflat.h
@@ -0,0 +1,164 @@
+/****************************************************************************
+ * toolchain/nxflat/nxflat.h
+ *
+ * Copyright (C) 2009 Gregory Nutt. All rights reserved.
+ * Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ * 3. Neither the name NuttX nor the names of its contributors may be
+ * used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ ****************************************************************************/
+
+#ifndef __TOOLCHAIN_NXFLAT_NXFLAT_H
+#define __TOOLCHAIN_NXFLAT_NXFLAT_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <sys/types.h>
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+#define NXFLAT_MAX_STRING_SIZE 64 /* Largest size of string (w/zterminator) */
+#define NXFLAT_MAGIC "NxFT" /* NXFLAT magic number */
+
+/****************************************************************************
+ * Public Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * The NXFLAT file header
+ *
+ * The elements within this structure are stored in network order (i.e.,
+ * ntohs() and ntohl() should be used to access fields within the
+ * header.
+ ****************************************************************************/
+
+struct nxflat_hdr_s
+ {
+ /* The "magic number" identifying the file type. This field should contain
+ * "NxFT". NOTE that there is no other versioning information other than
+ * this magic number. */
+
+ char h_magic[4];
+
+ /* The following fields provide the memory map for the nxflat binary.
+ * h_entry - Offset to the the first executable insruction from the
+ * beginning of the file. h_datastart - Offset to the beginning of the data
+ * segment from the beginning of the file. This field can also interpreted
+ * as the size of the ISpace segment. h_dataend - Offset to the end of the
+ * data segment from the beginning of the file. h_bssend - Offset to the
+ * end of bss segment from the beginning of the file. The text segment can
+ * be considered to be the contiguous (unrelocated) address space range
+ * from address zero through (but not including) h_datastart. The size of
+ * the data/bss segment includes (as a minimum) the data and bss regions
+ * (bss_end - data_start) as well as the size of the stack. At run time,
+ * this region will also include program arguments and environement
+ * variables. The bss segment is data_end through bss_end. */
+
+ u_int32_t h_entry;
+ u_int32_t h_datastart;
+ u_int32_t h_dataend;
+ u_int32_t h_bssend;
+
+ /* Size of stack, in bytes */
+
+ u_int32_t h_stacksize;
+
+ /* Relocation entries h_relocstart - Offset to the beginning of an array of
+ * relocation records (struct nxflat_reloc). The offset is relative to the
+ * start of the file h_reloccount - The number of relocation records in the
+ * arry */
+
+ u_int32_t h_relocstart; /* Offset of relocation records */
+ u_int32_t h_reloccount; /* Number of relocation records */
+
+ /* Imported symbol table (NOTE no symbols are exported) h_importsymbols -
+ * Offset to the beginning of an array of imported symbol structures
+ * (struct nxflat_import). The h_importsymbols offset is relative to the
+ * beginning of the file. Each entry of the array contains an u_int32_t
+ * offset (again from the beginning of the file) to the name of a symbol
+ * string. This string is null-terminated. h_importcount - The number of
+ * records in the h_exportsymbols array. */
+
+ u_int32_t h_importsymbols; /* Offset to list of imported symbols */
+ u_int16_t h_importcount; /* Number of imported symbols */
+ };
+
+/****************************************************************************
+ * NXFLAT Relocation types.
+ *
+ * The relocation records are an array of the following type.
+ ****************************************************************************/
+
+struct nxflat_reloc_s
+ {
+ u_int32_t r_info; /* Bit-encoded relocation info */
+ };
+
+/* Pack the type and the offset into one 32-bit value */
+
+#define NXFLAT_RELOC(t,o) (((u_int32_t)((t) & 3) << 28) | ((o) & 0x1fffffff))
+
+/* The top three bits of the relocation info is the relocation type (see the
+ * NXFLAT_RELOC_TYPE_* definitions below. This is an unsigned value.
+ */
+
+#define NXFLAT_RELOC_TYPE(r) ((u_int32_t)(r) >> 28)
+
+/* The bottom 28 bits of the relocation info is the (non-negative) offset into
+ * the D-Space that needs the fixup.
+ */
+
+#define NXFLAT_RELOC_OFFSET(r) ((u_int32_t)(r) & 0x1fffffff)
+
+/* These are possible values for the relocation type */
+
+#define NXFLAT_RELOC_TYPE_NONE 0 /* Invalid relocation type */
+#define NXFLAT_RELOC_TYPE_TEXT 1 /* Symbol lies in .text region */
+#define NXFLAT_RELOC_TYPE_DATA 2 /* Symbol lies in .data region */
+#define NXFLAT_RELOC_TYPE_BSS 3 /* Symbol lies in .bss region */
+#define NXFLAT_RELOC_TYPE_NUM 4
+
+/****************************************************************************
+ * NXFLAT Imported symbol type
+ *
+ * The imported symbols are an array of the following type. The fields
+ * in each element are stored in native machine order.
+ ****************************************************************************/
+
+struct nxflat_import_s
+ {
+ u_int32_t i_funcname; /* Offset to name of imported function */
+ u_int32_t i_funcaddress; /* Resolved address of imported function */
+ };
+
+#endif /* __TOOLCHAIN_NXFLAT_NXFLAT_H */
+