mirror of https://github.com/cc65/cc65.git
171 lines
7.4 KiB
C
171 lines
7.4 KiB
C
/*****************************************************************************/
|
|
/* */
|
|
/* segments.h */
|
|
/* */
|
|
/* Segment handling for the ld65 linker */
|
|
/* */
|
|
/* */
|
|
/* */
|
|
/* (C) 1998-2012, Ullrich von Bassewitz */
|
|
/* Roemerstrasse 52 */
|
|
/* D-70794 Filderstadt */
|
|
/* EMail: uz@cc65.org */
|
|
/* */
|
|
/* */
|
|
/* This software is provided 'as-is', without any expressed or implied */
|
|
/* warranty. In no event will the authors be held liable for any damages */
|
|
/* arising from the use of this software. */
|
|
/* */
|
|
/* Permission is granted to anyone to use this software for any purpose, */
|
|
/* including commercial applications, and to alter it and redistribute it */
|
|
/* freely, subject to the following restrictions: */
|
|
/* */
|
|
/* 1. The origin of this software must not be misrepresented; you must not */
|
|
/* claim that you wrote the original software. If you use this software */
|
|
/* in a product, an acknowledgment in the product documentation would be */
|
|
/* appreciated but is not required. */
|
|
/* 2. Altered source versions must be plainly marked as such, and must not */
|
|
/* be misrepresented as being the original software. */
|
|
/* 3. This notice may not be removed or altered from any source */
|
|
/* distribution. */
|
|
/* */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef SEGMENTS_H
|
|
#define SEGMENTS_H
|
|
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
/* common */
|
|
#include "coll.h"
|
|
#include "exprdefs.h"
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
/* Data */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
/* Forwards */
|
|
struct MemoryArea;
|
|
|
|
/* Segment structure */
|
|
typedef struct Segment Segment;
|
|
struct Segment {
|
|
unsigned Name; /* Name index of the segment */
|
|
unsigned Id; /* Segment id for debug info */
|
|
Segment* Next; /* Hash list */
|
|
unsigned Flags; /* Segment flags */
|
|
Collection Sections; /* Sections in this segment */
|
|
struct MemoryArea* MemArea; /* Run memory area once placed */
|
|
unsigned long PC; /* PC were this segment is located */
|
|
unsigned long Size; /* Size of data so far */
|
|
const char* OutputName; /* Name of output file or NULL */
|
|
unsigned long OutputOffs; /* Offset in output file */
|
|
unsigned long Alignment; /* Alignment needed */
|
|
unsigned char FillVal; /* Value to use for fill bytes */
|
|
unsigned char AddrSize; /* Address size of segment */
|
|
unsigned char ReadOnly; /* True for readonly segments (config) */
|
|
unsigned char Dumped; /* Did we dump this segment? */
|
|
};
|
|
|
|
|
|
|
|
/* Section structure (a section is a part of a segment) */
|
|
typedef struct Section Section;
|
|
struct Section {
|
|
Section* Next; /* List of sections in a segment */
|
|
Segment* Seg; /* Segment that contains the section */
|
|
struct ObjData* Obj; /* Object file this section comes from */
|
|
struct Fragment* FragRoot; /* Fragment list */
|
|
struct Fragment* FragLast; /* Pointer to last fragment */
|
|
unsigned long Offs; /* Offset into the segment */
|
|
unsigned long Size; /* Size of the section */
|
|
unsigned long Fill; /* Fill bytes for alignment */
|
|
unsigned long Alignment; /* Alignment */
|
|
unsigned char AddrSize; /* Address size of segment */
|
|
};
|
|
|
|
|
|
|
|
/* Prototype for a function that is used to write expressions to the target
|
|
** file (used in SegWrite). It returns one of the following values:
|
|
*/
|
|
#define SEG_EXPR_OK 0U /* Ok */
|
|
#define SEG_EXPR_RANGE_ERROR 1U /* Range error */
|
|
#define SEG_EXPR_TOO_COMPLEX 2U /* Expression too complex */
|
|
#define SEG_EXPR_INVALID 3U /* Expression is invalid (e.g. unmapped segment) */
|
|
|
|
typedef unsigned (*SegWriteFunc) (ExprNode* E, /* The expression to write */
|
|
int Signed, /* Signed expression? */
|
|
unsigned Size, /* Size (=range) */
|
|
unsigned long Offs, /* File offset */
|
|
void* Data); /* Callers data */
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
/* Code */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
Segment* GetSegment (unsigned Name, unsigned char AddrSize, const char* ObjName);
|
|
/* Search for a segment and return an existing one. If the segment does not
|
|
** exist, create a new one and return that. ObjName is only used for the error
|
|
** message and may be NULL if the segment is linker generated.
|
|
*/
|
|
|
|
Section* NewSection (Segment* Seg, unsigned long Alignment, unsigned char AddrSize);
|
|
/* Create a new section for the given segment */
|
|
|
|
Section* ReadSection (FILE* F, struct ObjData* O);
|
|
/* Read a section from a file */
|
|
|
|
Segment* SegFind (unsigned Name);
|
|
/* Return the given segment or NULL if not found. */
|
|
|
|
int IsBSSType (Segment* S);
|
|
/* Check if the given segment is a BSS style segment, that is, it does not
|
|
** contain non-zero data.
|
|
*/
|
|
|
|
void SegDump (void);
|
|
/* Dump the segments and it's contents */
|
|
|
|
unsigned SegWriteConstExpr (FILE* F, ExprNode* E, int Signed, unsigned Size);
|
|
/* Write a supposedly constant expression to the target file. Do a range
|
|
** check and return one of the SEG_EXPR_xxx codes.
|
|
*/
|
|
|
|
void SegWrite (const char* TgtName, FILE* Tgt, Segment* S, SegWriteFunc F, void* Data);
|
|
/* Write the data from the given segment to a file. For expressions, F is
|
|
** called (see description of SegWriteFunc above).
|
|
*/
|
|
|
|
unsigned SegmentCount (void);
|
|
/* Return the total number of segments */
|
|
|
|
void PrintSegmentMap (FILE* F);
|
|
/* Print a segment map to the given file */
|
|
|
|
void PrintDbgSegments (FILE* F);
|
|
/* Output the segments to the debug file */
|
|
|
|
void CheckSegments (void);
|
|
/* Walk through the segment list and check if there are segments that were
|
|
** not written to the output file. Output an error if this is the case.
|
|
*/
|
|
|
|
|
|
|
|
/* End of segments.h */
|
|
|
|
#endif
|