mirror of
https://github.com/elliotnunn/sys7.1-doc-wip.git
synced 2024-12-13 11:29:15 +00:00
321 lines
11 KiB
C
321 lines
11 KiB
C
|
/*
|
|||
|
|
File: FragLoad.h
|
|||
|
|
|
|||
|
|
Contains: CFM Public API
|
|||
|
|
|
|||
|
|
Written by: Erik Eidt, Alan Lillich, Jeff Cobb
|
|||
|
|
|
|||
|
|
Copyright: © 1993 by Apple Computer, Inc., all rights reserved.
|
|||
|
|
|
|||
|
|
Change History (most recent first):
|
|||
|
|
|
|||
|
|
<15> 6/16/93 ELE (with AWL) Added new error code for UserInitProcFailure.
|
|||
|
|
<14> 6/9/93 jrc (with SP) In the CFMTrap macro, remove the cast of (arg) to
|
|||
|
|
signed short. This was confusing the interfacer.
|
|||
|
|
<13> 6/9/93 EPT Changes for Universal Headers. Synched up with Reality.
|
|||
|
|
<12> 6/5/93 BT (With JRG) "#ifndef interface_glue" should only be bracketing
|
|||
|
|
the prototypes, not the type information. This was causing a
|
|||
|
|
problem for ProcessesPriv.h where Eric was expecting some type
|
|||
|
|
information to be available.
|
|||
|
|
<11> 5/10/93 jrc Make C++ Happy.
|
|||
|
|
<10> 4/7/93 jrc Use symbolic names for the MixedMode and CFM A-traps.
|
|||
|
|
<9> 3/17/93 JRG Change how procinfos are constructed
|
|||
|
|
<8> 3/4/93 AWL Change to "pascal" routines for Dagon.
|
|||
|
|
<7> 3/2/93 jrc Fix Erik's fixes. "FourBytes" not "FourByte".
|
|||
|
|
<6> 3/2/93 ELE Fixed two typo's in proc infos.
|
|||
|
|
<5> 2/18/93 ELE Moved a bunch of stuff into here
|
|||
|
|
from CodeFragments.h
|
|||
|
|
<4> 2/15/93 ELE Added kAnyArchType.
|
|||
|
|
<3> 1/28/93 jrc Rev for d4 MixedMode.
|
|||
|
|
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/*******************************************************************************
|
|||
|
|
|
|||
|
|
FILENAME
|
|||
|
|
FragLoad.h
|
|||
|
|
|
|||
|
|
COPYRIGHT
|
|||
|
|
Copyright © Apple Computer, Inc. 1992
|
|||
|
|
All rights reserved.
|
|||
|
|
|
|||
|
|
*******************************************************************************/
|
|||
|
|
|
|||
|
|
|
|||
|
|
#ifndef __FRAGLOAD__
|
|||
|
|
#define __FRAGLOAD__ 1
|
|||
|
|
|
|||
|
|
|
|||
|
|
#include <Types.h>
|
|||
|
|
#include <Files.h>
|
|||
|
|
#include <Traps.h>
|
|||
|
|
|
|||
|
|
typedef long ConnectionID;
|
|||
|
|
typedef unsigned long Mask;
|
|||
|
|
typedef unsigned char SymClass;
|
|||
|
|
|
|||
|
|
#define kPowerPC 'pwpc' // use as the architecture type
|
|||
|
|
#define kAnyArchType 0x3f3f3f3f // '????'
|
|||
|
|
|
|||
|
|
#define kNoLibName ((unsigned char *) 0)
|
|||
|
|
#define kNoConnectionID ((ConnectionID) 0)
|
|||
|
|
#define kUnresolvedSymbolAddress ((Ptr) 0x0)
|
|||
|
|
|
|||
|
|
enum { // use for findFlags mask
|
|||
|
|
kLoadLib = 1, // use existing connection if possible
|
|||
|
|
kFindLib = 2, // just see if library is already loaded
|
|||
|
|
kLoadNewCopy = 5, // load a new instance no matter what
|
|||
|
|
kUseInPlace = 0x80 // use container's sections in place
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
enum {
|
|||
|
|
kCodeSym = 0,
|
|||
|
|
kDataSym = 1,
|
|||
|
|
kTVectSym = 2,
|
|||
|
|
kTOCSym = 3,
|
|||
|
|
kGlueSym = 4
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
/************************************************************************/
|
|||
|
|
/* for fragment initialization routines */
|
|||
|
|
/************************************************************************/
|
|||
|
|
|
|||
|
|
struct MemFragment {
|
|||
|
|
Ptr address;
|
|||
|
|
long length;
|
|||
|
|
Boolean inPlace;
|
|||
|
|
};
|
|||
|
|
typedef struct MemFragment MemFragment;
|
|||
|
|
|
|||
|
|
struct DiskFragment {
|
|||
|
|
FSSpecPtr fileSpec;
|
|||
|
|
long offset;
|
|||
|
|
long length;
|
|||
|
|
};
|
|||
|
|
typedef struct DiskFragment DiskFragment;
|
|||
|
|
|
|||
|
|
struct SegmentedFragment {
|
|||
|
|
FSSpecPtr fileSpec;
|
|||
|
|
OSType rsrcType;
|
|||
|
|
short rsrcID;
|
|||
|
|
};
|
|||
|
|
typedef struct SegmentedFragment SegmentedFragment;
|
|||
|
|
|
|||
|
|
struct FragmentLocator {
|
|||
|
|
long where;
|
|||
|
|
union {
|
|||
|
|
MemFragment inMem;
|
|||
|
|
DiskFragment onDisk;
|
|||
|
|
SegmentedFragment inSegs;
|
|||
|
|
} u;
|
|||
|
|
};
|
|||
|
|
typedef struct FragmentLocator FragmentLocator, *FragmentLocatorPtr;
|
|||
|
|
|
|||
|
|
|
|||
|
|
// NOTE: when fragLocator. where == kOnDisk, then
|
|||
|
|
// fragLocator. u. onDisk. fileSpec is a pointer
|
|||
|
|
// to the file that the library belonged to.
|
|||
|
|
// the pointer is valid only for the duration
|
|||
|
|
// of the init routine's invocation, so make
|
|||
|
|
// a copy of the filespec if it is important
|
|||
|
|
struct InitBlock {
|
|||
|
|
long contextID;
|
|||
|
|
long closureID;
|
|||
|
|
long connectionID;
|
|||
|
|
FragmentLocator fragLocator;
|
|||
|
|
Ptr libName;
|
|||
|
|
long reserved4a;
|
|||
|
|
long reserved4b;
|
|||
|
|
long reserved4c;
|
|||
|
|
long reserved4d;
|
|||
|
|
};
|
|||
|
|
typedef struct InitBlock InitBlock, *InitBlockPtr;
|
|||
|
|
|
|||
|
|
|
|||
|
|
// prototype for initialization routines
|
|||
|
|
// Pascal calling conventions
|
|||
|
|
// NOTE: initialization routines may comfortably ignore
|
|||
|
|
// their parameters, however, they must return
|
|||
|
|
// an error status (ie: noErr) in order to succeed
|
|||
|
|
// with the load of the library
|
|||
|
|
typedef pascal OSErr ConnectionInitializationRoutine ( InitBlockPtr initBlkPtr );
|
|||
|
|
|
|||
|
|
// termination routines get no parameters / return value
|
|||
|
|
// Pascal calling conventions
|
|||
|
|
typedef pascal void ConnectionTerminationRoutine ( void );
|
|||
|
|
|
|||
|
|
|
|||
|
|
/************************************************************************/
|
|||
|
|
/* for building shared libraries */
|
|||
|
|
/************************************************************************/
|
|||
|
|
|
|||
|
|
#define kCFMRsrcType 'cfrg'
|
|||
|
|
#define kSHLBFileType 'shlb'
|
|||
|
|
|
|||
|
|
|
|||
|
|
/************************************************************************/
|
|||
|
|
/* error codes */
|
|||
|
|
/************************************************************************/
|
|||
|
|
|
|||
|
|
enum {
|
|||
|
|
fragNoErr = 0,
|
|||
|
|
fragContextNotFound = -2800, // contextID was not valid
|
|||
|
|
fragConnectionIDNotFound = -2801, // connecionID was not valid
|
|||
|
|
fragSymbolNotFound = -2802, // symbol was not found in connection
|
|||
|
|
fragSectionNotFound = -2803, // section was not found
|
|||
|
|
fragLibNotFound = -2804, // library name not found in Frag registry
|
|||
|
|
fragDupRegLibName = -2805, // registered name already in use
|
|||
|
|
fragFormatUnknown = -2806, // fragment container format unknown
|
|||
|
|
fragHadUnresolveds = -2807, // loaded fragment had unacceptable unresolveds
|
|||
|
|
fragHadSoftUnresolveds = -2808, // loaded fragment has acceptable unresolveds
|
|||
|
|
fragNoMem = -2809, // out of memory for interal bookkeeping
|
|||
|
|
fragNoAddrSpace = -2810, // out of memory in user's address space for loadable section
|
|||
|
|
fragNoContextIDs = -2811, // no more context id’s
|
|||
|
|
fragObjectInitSeqErr = -2812, // order error during user initialization function invocation
|
|||
|
|
fragImportTooOld = -2813, // import library was too old and therefore incompatible
|
|||
|
|
fragImportTooNew = -2814, // import library was too new and therefore incompatible
|
|||
|
|
fragInitLoop = -2815, // circularity detected in mandatory initialization order
|
|||
|
|
fragInitRtnUsageErr = -2816, // boot library has initialization routine
|
|||
|
|
fragLibConnErr = -2817, // error connecting to library (error occured in sub prepare)
|
|||
|
|
fragMgrInitErr = -2818, // error in initailization of this manager
|
|||
|
|
fragConstErr = -2819, // internal inconstistancy
|
|||
|
|
fragCorruptErr = -2820, // fragment container corrupted (known format)
|
|||
|
|
fragUserInitProcErr = -2821, // user intialization routine did not return noErr
|
|||
|
|
fragLastErrCode = -2899 // last reserved error code number
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
|
|||
|
|
#if TurnOff68KCFMTraps || __powerc || powerc
|
|||
|
|
#define CFMTrap(arg) /* don't want trap: 68k-code to link directly */
|
|||
|
|
#else
|
|||
|
|
#define CFMTrap(arg) = { 0x3F3C, arg, _CodeFragmentDispatch }
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
extern "C" {
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
|
|||
|
|
pascal OSErr GetSharedLibrary ( Str63 libName,
|
|||
|
|
OSType archType,
|
|||
|
|
Mask findFlags,
|
|||
|
|
ConnectionID *connID,
|
|||
|
|
Ptr *mainAddr,
|
|||
|
|
Str255 errName )
|
|||
|
|
CFMTrap ( 1 );
|
|||
|
|
|
|||
|
|
#define GetSharedLibraryProcInfo \
|
|||
|
|
(kPascalStackBased | \
|
|||
|
|
STACK_RESULT_FIELD(kTwoByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(1, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(2, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(3, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(4, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(5, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(6, kFourByteCode))
|
|||
|
|
|
|||
|
|
|
|||
|
|
pascal OSErr GetDiskFragment ( FSSpecPtr fileSpec,
|
|||
|
|
long offset,
|
|||
|
|
long length,
|
|||
|
|
Str63 fragName,
|
|||
|
|
Mask findFlags,
|
|||
|
|
ConnectionID *connID,
|
|||
|
|
Ptr *mainAddr,
|
|||
|
|
Str255 errName )
|
|||
|
|
CFMTrap ( 2 );
|
|||
|
|
|
|||
|
|
#define GetDiskFragmentProcInfo \
|
|||
|
|
(kPascalStackBased | \
|
|||
|
|
STACK_RESULT_FIELD(kTwoByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(1, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(2, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(3, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(4, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(5, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(6, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(7, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(8, kFourByteCode))
|
|||
|
|
|
|||
|
|
|
|||
|
|
pascal OSErr GetMemFragment ( Ptr memAddr,
|
|||
|
|
long length,
|
|||
|
|
Str63 fragName,
|
|||
|
|
Mask findFlags,
|
|||
|
|
ConnectionID *connID,
|
|||
|
|
Ptr *mainAddr,
|
|||
|
|
Str255 errName )
|
|||
|
|
CFMTrap ( 3 );
|
|||
|
|
|
|||
|
|
#define GetMemFragmentProcInfo \
|
|||
|
|
(kPascalStackBased | \
|
|||
|
|
STACK_RESULT_FIELD(kTwoByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(1, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(2, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(3, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(4, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(5, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(6, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(7, kFourByteCode))
|
|||
|
|
|
|||
|
|
|
|||
|
|
pascal OSErr CloseConnection ( ConnectionID *connID )
|
|||
|
|
CFMTrap ( 4 );
|
|||
|
|
|
|||
|
|
#define CloseConnectionProcInfo \
|
|||
|
|
(kPascalStackBased | \
|
|||
|
|
STACK_RESULT_FIELD(kTwoByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(1, kFourByteCode))
|
|||
|
|
|
|||
|
|
|
|||
|
|
pascal OSErr FindSymbol ( ConnectionID connID,
|
|||
|
|
Str255 symName,
|
|||
|
|
Ptr *symAddr,
|
|||
|
|
SymClass *symClass )
|
|||
|
|
CFMTrap ( 5 );
|
|||
|
|
|
|||
|
|
#define FindSymbolProcInfo \
|
|||
|
|
(kPascalStackBased | \
|
|||
|
|
STACK_RESULT_FIELD(kTwoByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(1, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(2, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(3, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(4, kFourByteCode))
|
|||
|
|
|
|||
|
|
|
|||
|
|
pascal OSErr CountSymbols ( ConnectionID connID,
|
|||
|
|
long *symCount )
|
|||
|
|
CFMTrap ( 6 );
|
|||
|
|
|
|||
|
|
#define CountSymbolsProcInfo \
|
|||
|
|
(kPascalStackBased | \
|
|||
|
|
STACK_RESULT_FIELD(kTwoByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(1, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(2, kFourByteCode))
|
|||
|
|
|
|||
|
|
|
|||
|
|
pascal OSErr GetIndSymbol ( ConnectionID connID,
|
|||
|
|
long symIndex,
|
|||
|
|
Str255 symName,
|
|||
|
|
Ptr *symAddr,
|
|||
|
|
SymClass *symClass )
|
|||
|
|
CFMTrap ( 7 );
|
|||
|
|
|
|||
|
|
#define GetIndSymbolProcInfo \
|
|||
|
|
(kPascalStackBased | \
|
|||
|
|
STACK_RESULT_FIELD(kTwoByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(1, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(2, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(3, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(4, kFourByteCode) | \
|
|||
|
|
STACK_PARAM_FIELD(5, kFourByteCode))
|
|||
|
|
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
}
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
#endif
|