You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
641 lines
22 KiB
641 lines
22 KiB
5 years ago
|
/*
|
||
|
|
File: CodeFragments.h
|
||
|
|
|
||
|
|
Contains: Public Code Fragment Manager Interfaces.
|
||
|
|
|
||
|
|
Version: QuickTime 7.3
|
||
|
|
|
||
|
|
Copyright: (c) 2007 (c) 1992-2001 by Apple Computer, Inc., all rights reserved.
|
||
|
|
|
||
|
|
Bugs?: For bug reports, consult the following page on
|
||
|
|
the World Wide Web:
|
||
|
|
|
||
|
|
http://developer.apple.com/bugreporter/
|
||
|
|
|
||
|
|
*/
|
||
|
|
/*
|
||
|
|
o
|
||
|
|
===========================================================================================
|
||
|
|
The Code Fragment Manager API
|
||
|
|
=============================
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
#ifndef __CODEFRAGMENTS__
|
||
|
|
#define __CODEFRAGMENTS__
|
||
|
|
|
||
|
|
#ifndef __MACTYPES__
|
||
|
|
#include <MacTypes.h>
|
||
|
|
#endif
|
||
|
|
|
||
|
|
|
||
|
|
#ifndef __CFBUNDLE__
|
||
|
|
#include <CFBundle.h>
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifndef __FILES__
|
||
|
|
#include <Files.h>
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifndef __MULTIPROCESSING__
|
||
|
|
#include <Multiprocessing.h>
|
||
|
|
#endif
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
#if PRAGMA_ONCE
|
||
|
|
#pragma once
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if PRAGMA_IMPORT
|
||
|
|
#pragma import on
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if PRAGMA_STRUCT_ALIGN
|
||
|
|
#pragma options align=mac68k
|
||
|
|
#elif PRAGMA_STRUCT_PACKPUSH
|
||
|
|
#pragma pack(push, 2)
|
||
|
|
#elif PRAGMA_STRUCT_PACK
|
||
|
|
#pragma pack(2)
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/*
|
||
|
|
.
|
||
|
|
===========================================================================================
|
||
|
|
General Types and Constants
|
||
|
|
===========================
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
enum {
|
||
|
|
kCFragResourceType = FOUR_CHAR_CODE('cfrg'),
|
||
|
|
kCFragResourceID = 0,
|
||
|
|
kCFragLibraryFileType = FOUR_CHAR_CODE('shlb'),
|
||
|
|
kCFragAllFileTypes = (long)0xFFFFFFFF
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
typedef OSType CFragArchitecture;
|
||
|
|
enum {
|
||
|
|
/* Values for type CFragArchitecture.*/
|
||
|
|
kPowerPCCFragArch = FOUR_CHAR_CODE('pwpc'),
|
||
|
|
kMotorola68KCFragArch = FOUR_CHAR_CODE('m68k'),
|
||
|
|
kAnyCFragArch = 0x3F3F3F3F
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
#if TARGET_CPU_PPC
|
||
|
|
enum {
|
||
|
|
kCompiledCFragArch = kPowerPCCFragArch
|
||
|
|
};
|
||
|
|
|
||
|
|
#endif /* TARGET_CPU_PPC */
|
||
|
|
|
||
|
|
#if TARGET_CPU_68K
|
||
|
|
enum {
|
||
|
|
kCompiledCFragArch = kMotorola68KCFragArch
|
||
|
|
};
|
||
|
|
|
||
|
|
#endif /* TARGET_CPU_68K */
|
||
|
|
|
||
|
|
typedef UInt32 CFragVersionNumber;
|
||
|
|
enum {
|
||
|
|
kNullCFragVersion = 0,
|
||
|
|
kWildcardCFragVersion = (long)0xFFFFFFFF
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
typedef UInt8 CFragUsage;
|
||
|
|
enum {
|
||
|
|
/* Values for type CFragUsage.*/
|
||
|
|
kImportLibraryCFrag = 0, /* Standard CFM import library.*/
|
||
|
|
kApplicationCFrag = 1, /* MacOS application.*/
|
||
|
|
kDropInAdditionCFrag = 2, /* Application or library private extension/plug-in*/
|
||
|
|
kStubLibraryCFrag = 3, /* Import library used for linking only*/
|
||
|
|
kWeakStubLibraryCFrag = 4 /* Import library used for linking only and will be automatically weak linked*/
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
enum {
|
||
|
|
kIsCompleteCFrag = 0, /* A "base" fragment, not an update.*/
|
||
|
|
kFirstCFragUpdate = 1 /* The first update, others are numbered 2, 3, ...*/
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
enum {
|
||
|
|
kCFragGoesToEOF = 0
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
typedef UInt8 CFragLocatorKind;
|
||
|
|
enum {
|
||
|
|
/* Values for type CFragLocatorKind.*/
|
||
|
|
kMemoryCFragLocator = 0, /* Container is in memory.*/
|
||
|
|
kDataForkCFragLocator = 1, /* Container is in a file's data fork.*/
|
||
|
|
kResourceCFragLocator = 2, /* Container is in a file's resource fork.*/
|
||
|
|
kNamedFragmentCFragLocator = 4, /* ! Reserved for possible future use!*/
|
||
|
|
kCFBundleCFragLocator = 5, /* Container is in the executable of a CFBundle*/
|
||
|
|
kCFBundlePreCFragLocator = 6 /* passed to init routines in lieu of kCFBundleCFragLocator*/
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
A 'cfrg' resource consists of a header followed by a sequence of variable length
|
||
|
|
members. The constant kDefaultCFragNameLen only provides for a legal ANSI declaration
|
||
|
|
and for a reasonable display in a debugger. The actual name field is cut to fit.
|
||
|
|
There may be "extensions" after the name, the memberSize field includes them. The
|
||
|
|
general form of an extension is a 16 bit type code followed by a 16 bit size in bytes.
|
||
|
|
Only one standard extension type is defined at present, it is used by SOM's searching
|
||
|
|
mechanism.
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
union CFragUsage1Union { /* ! Meaning differs depending on value of "usage".*/
|
||
|
|
UInt32 appStackSize; /* If the fragment is an application. (Not used by CFM!)*/
|
||
|
|
};
|
||
|
|
typedef union CFragUsage1Union CFragUsage1Union;
|
||
|
|
union CFragUsage2Union { /* ! Meaning differs depending on value of "usage".*/
|
||
|
|
SInt16 appSubdirID; /* If the fragment is an application.*/
|
||
|
|
UInt16 libFlags; /* If the fragment is an import library.*/
|
||
|
|
};
|
||
|
|
typedef union CFragUsage2Union CFragUsage2Union;
|
||
|
|
enum {
|
||
|
|
/* Bit masks for the CFragUsage2Union libFlags variant.*/
|
||
|
|
kCFragLibUsageMapPrivatelyMask = 0x0001 /* Put container in app heap if necessary.*/
|
||
|
|
};
|
||
|
|
|
||
|
|
union CFragWhere1Union { /* ! Meaning differs depending on value of "where".*/
|
||
|
|
UInt32 spaceID; /* If the fragment is in memory. (Actually an AddressSpaceID.)*/
|
||
|
|
};
|
||
|
|
typedef union CFragWhere1Union CFragWhere1Union;
|
||
|
|
union CFragWhere2Union { /* ! Meaning differs depending on value of "where".*/
|
||
|
|
UInt16 reserved;
|
||
|
|
};
|
||
|
|
typedef union CFragWhere2Union CFragWhere2Union;
|
||
|
|
enum {
|
||
|
|
kDefaultCFragNameLen = 16
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
struct CFragResourceMember {
|
||
|
|
CFragArchitecture architecture;
|
||
|
|
UInt16 reservedA; /* ! Must be zero!*/
|
||
|
|
UInt8 reservedB; /* ! Must be zero!*/
|
||
|
|
UInt8 updateLevel;
|
||
|
|
CFragVersionNumber currentVersion;
|
||
|
|
CFragVersionNumber oldDefVersion;
|
||
|
|
CFragUsage1Union uUsage1;
|
||
|
|
CFragUsage2Union uUsage2;
|
||
|
|
CFragUsage usage;
|
||
|
|
CFragLocatorKind where;
|
||
|
|
UInt32 offset;
|
||
|
|
UInt32 length;
|
||
|
|
CFragWhere1Union uWhere1;
|
||
|
|
CFragWhere2Union uWhere2;
|
||
|
|
UInt16 extensionCount; /* The number of extensions beyond the name.*/
|
||
|
|
UInt16 memberSize; /* Size in bytes, includes all extensions.*/
|
||
|
|
unsigned char name[16]; /* ! Actually a sized PString.*/
|
||
|
|
};
|
||
|
|
typedef struct CFragResourceMember CFragResourceMember;
|
||
|
|
typedef CFragResourceMember * CFragResourceMemberPtr;
|
||
|
|
struct CFragResourceExtensionHeader {
|
||
|
|
UInt16 extensionKind;
|
||
|
|
UInt16 extensionSize;
|
||
|
|
};
|
||
|
|
typedef struct CFragResourceExtensionHeader CFragResourceExtensionHeader;
|
||
|
|
typedef CFragResourceExtensionHeader * CFragResourceExtensionHeaderPtr;
|
||
|
|
struct CFragResourceSearchExtension {
|
||
|
|
CFragResourceExtensionHeader header;
|
||
|
|
OSType libKind;
|
||
|
|
unsigned char qualifiers[1]; /* ! Actually four PStrings.*/
|
||
|
|
};
|
||
|
|
typedef struct CFragResourceSearchExtension CFragResourceSearchExtension;
|
||
|
|
typedef CFragResourceSearchExtension * CFragResourceSearchExtensionPtr;
|
||
|
|
enum {
|
||
|
|
kCFragResourceSearchExtensionKind = 0x30EE
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
struct CFragResource {
|
||
|
|
UInt32 reservedA; /* ! Must be zero!*/
|
||
|
|
UInt32 reservedB; /* ! Must be zero!*/
|
||
|
|
UInt16 reservedC; /* ! Must be zero!*/
|
||
|
|
UInt16 version;
|
||
|
|
UInt32 reservedD; /* ! Must be zero!*/
|
||
|
|
UInt32 reservedE; /* ! Must be zero!*/
|
||
|
|
UInt32 reservedF; /* ! Must be zero!*/
|
||
|
|
UInt32 reservedG; /* ! Must be zero!*/
|
||
|
|
UInt16 reservedH; /* ! Must be zero!*/
|
||
|
|
UInt16 memberCount;
|
||
|
|
CFragResourceMember firstMember;
|
||
|
|
};
|
||
|
|
typedef struct CFragResource CFragResource;
|
||
|
|
typedef CFragResource * CFragResourcePtr;
|
||
|
|
typedef CFragResourcePtr * CFragResourceHandle;
|
||
|
|
enum {
|
||
|
|
kCurrCFragResourceVersion = 1
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
#define AlignToFour(aValue) (((aValue) + 3) & ~3)
|
||
|
|
#define CFMOffsetOf(structure,field) ((UInt32)&((structure *) 0)->field)
|
||
|
|
#define kBaseCFragResourceMemberSize (CFMOffsetOf ( CFragResourceMember, name ) )
|
||
|
|
#define kBaseCFragResourceSize (CFMOffsetOf ( CFragResource, firstMember.name ) )
|
||
|
|
#define NextCFragResourceMemberPtr(aMemberPtr) \
|
||
|
|
((CFragResourceMemberPtr) ((BytePtr)aMemberPtr + aMemberPtr->memberSize))
|
||
|
|
#define FirstCFragResourceExtensionPtr(aMemberPtr) \
|
||
|
|
((CFragResourceExtensionHeaderPtr) ((BytePtr)aMemberPtr + \
|
||
|
|
AlignToFour ( kBaseCFragResourceMemberSize + \
|
||
|
|
aMemberPtr->name[0] + 1 ) ))
|
||
|
|
#define NextCFragResourceExtensionPtr(anExtensionPtr) \
|
||
|
|
((CFragResourceExtensionHeaderPtr) ((BytePtr)anExtensionPtr + \
|
||
|
|
((CFragResourceExtensionHeaderPtr)anExtensionPtr)->extensionSize ))
|
||
|
|
#define FirstCFragResourceSearchQualifier(searchExtensionPtr) \
|
||
|
|
((StringPtr) ((BytePtr)searchExtensionPtr + \
|
||
|
|
CFMOffsetOf ( CFragResourceSearchExtension, qualifiers ) ))
|
||
|
|
#define NextCFragResourceSearchQualifier(searchQualifierPtr) \
|
||
|
|
((StringPtr) ((BytePtr)searchQualifierPtr + searchQualifierPtr[0] + 1))
|
||
|
|
|
||
|
|
typedef MPProcessID CFragContextID;
|
||
|
|
typedef struct OpaqueCFragConnectionID* CFragConnectionID;
|
||
|
|
typedef struct OpaqueCFragClosureID* CFragClosureID;
|
||
|
|
typedef struct OpaqueCFragContainerID* CFragContainerID;
|
||
|
|
typedef OptionBits CFragLoadOptions;
|
||
|
|
enum {
|
||
|
|
/* Values for type CFragLoadOptions.*/
|
||
|
|
kReferenceCFrag = 0x0001, /* Try to use existing copy, increment reference counts.*/
|
||
|
|
kFindCFrag = 0x0002, /* Try find an existing copy, do not increment reference counts.*/
|
||
|
|
kPrivateCFragCopy = 0x0005 /* Prepare a new private copy. (kReferenceCFrag | 0x0004)*/
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
enum {
|
||
|
|
kUnresolvedCFragSymbolAddress = 0
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
typedef UInt8 CFragSymbolClass;
|
||
|
|
enum {
|
||
|
|
/* Values for type CFragSymbolClass.*/
|
||
|
|
kCodeCFragSymbol = 0,
|
||
|
|
kDataCFragSymbol = 1,
|
||
|
|
kTVectorCFragSymbol = 2,
|
||
|
|
kTOCCFragSymbol = 3,
|
||
|
|
kGlueCFragSymbol = 4
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
.
|
||
|
|
===========================================================================================
|
||
|
|
Macros and Functions
|
||
|
|
====================
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
#define CFragHasFileLocation(where) \
|
||
|
|
( ((where) == kDataForkCFragLocator) || ((where) == kResourceCFragLocator) )
|
||
|
|
/*
|
||
|
|
* GetSharedLibrary()
|
||
|
|
*
|
||
|
|
* Discussion:
|
||
|
|
* The connID, mainAddr, and errMessage parameters may be NULL with
|
||
|
|
* MacOS 8.5 and later. Passing NULL as those parameters when
|
||
|
|
* running Mac OS 8.1 and earlier systems will corrupt low-memory.
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: in CFragManager 1.0 and later
|
||
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
||
|
|
* Mac OS X: in version 10.0 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
GetSharedLibrary(
|
||
|
|
ConstStr63Param libName,
|
||
|
|
CFragArchitecture archType,
|
||
|
|
CFragLoadOptions options,
|
||
|
|
CFragConnectionID * connID,
|
||
|
|
Ptr * mainAddr,
|
||
|
|
Str255 errMessage) THREEWORDINLINE(0x3F3C, 0x0001, 0xAA5A);
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* GetDiskFragment()
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: in CFragManager 1.0 and later
|
||
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
||
|
|
* Mac OS X: in version 10.0 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
GetDiskFragment(
|
||
|
|
const FSSpec * fileSpec,
|
||
|
|
UInt32 offset,
|
||
|
|
UInt32 length,
|
||
|
|
ConstStr63Param fragName, /* can be NULL */
|
||
|
|
CFragLoadOptions options,
|
||
|
|
CFragConnectionID * connID, /* can be NULL */
|
||
|
|
Ptr * mainAddr, /* can be NULL */
|
||
|
|
Str255 errMessage) /* can be NULL */ THREEWORDINLINE(0x3F3C, 0x0002, 0xAA5A);
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* GetMemFragment()
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: in CFragManager 1.0 and later
|
||
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
||
|
|
* Mac OS X: in version 10.0 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
GetMemFragment(
|
||
|
|
void * memAddr,
|
||
|
|
UInt32 length,
|
||
|
|
ConstStr63Param fragName, /* can be NULL */
|
||
|
|
CFragLoadOptions options,
|
||
|
|
CFragConnectionID * connID, /* can be NULL */
|
||
|
|
Ptr * mainAddr, /* can be NULL */
|
||
|
|
Str255 errMessage) /* can be NULL */ THREEWORDINLINE(0x3F3C, 0x0003, 0xAA5A);
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* CloseConnection()
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: in CFragManager 1.0 and later
|
||
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
||
|
|
* Mac OS X: in version 10.0 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
CloseConnection(CFragConnectionID * connID) THREEWORDINLINE(0x3F3C, 0x0004, 0xAA5A);
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* FindSymbol()
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: in CFragManager 1.0 and later
|
||
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
||
|
|
* Mac OS X: in version 10.0 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
FindSymbol(
|
||
|
|
CFragConnectionID connID,
|
||
|
|
ConstStr255Param symName,
|
||
|
|
Ptr * symAddr, /* can be NULL */
|
||
|
|
CFragSymbolClass * symClass) /* can be NULL */ THREEWORDINLINE(0x3F3C, 0x0005, 0xAA5A);
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* CountSymbols()
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: in CFragManager 1.0 and later
|
||
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
||
|
|
* Mac OS X: in version 10.0 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
CountSymbols(
|
||
|
|
CFragConnectionID connID,
|
||
|
|
long * symCount) THREEWORDINLINE(0x3F3C, 0x0006, 0xAA5A);
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* GetIndSymbol()
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: in CFragManager 1.0 and later
|
||
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
||
|
|
* Mac OS X: in version 10.0 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
GetIndSymbol(
|
||
|
|
CFragConnectionID connID,
|
||
|
|
long symIndex,
|
||
|
|
Str255 symName, /* can be NULL */
|
||
|
|
Ptr * symAddr, /* can be NULL */
|
||
|
|
CFragSymbolClass * symClass) /* can be NULL */ THREEWORDINLINE(0x3F3C, 0x0007, 0xAA5A);
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
.
|
||
|
|
===========================================================================================
|
||
|
|
Initialization & Termination Routines
|
||
|
|
=====================================
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
-----------------------------------------------------------------------------------------
|
||
|
|
A fragment's initialization and termination routines are called when a new incarnation of
|
||
|
|
the fragment is created or destroyed, respectively. Exactly when this occurs depends on
|
||
|
|
what kinds of section sharing the fragment has and how the fragment is prepared. Import
|
||
|
|
libraries have at most one incarnation per process. Fragments prepared with option
|
||
|
|
kPrivateCFragCopy may have many incarnations per process.
|
||
|
|
The initialization function is passed a pointer to an initialization information structure
|
||
|
|
and returns an OSErr. If an initialization function returns a non-zero value the entire
|
||
|
|
closure of which it is a part fails. The C prototype for an initialization function is:
|
||
|
|
OSErr CFragInitFunction ( const CFragInitBlock * initBlock );
|
||
|
|
The termination procedure takes no parameters and returns nothing. The C prototype for a
|
||
|
|
termination procedure is:
|
||
|
|
void CFragTermProcedure ( void );
|
||
|
|
Note that since the initialization and termination routines are themselves "CFM"-style
|
||
|
|
routines whether or not they have the "pascal" keyword is irrelevant.
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
-----------------------------------------------------------------------------------------
|
||
|
|
! Note:
|
||
|
|
! The "System7" portion of these type names was introduced during the evolution towards
|
||
|
|
! the now defunct Copland version of Mac OS. Copland was to be called System 8 and there
|
||
|
|
! were slightly different types for System 7 and System 8. The "generic" type names were
|
||
|
|
! conditionally defined for the desired target system.
|
||
|
|
! Always use the generic types, e.g. CFragInitBlock! The "System7" names have been kept
|
||
|
|
! only to avoid perturbing code that (improperly) used the target specific type.
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
struct CFragSystem7MemoryLocator {
|
||
|
|
LogicalAddress address;
|
||
|
|
UInt32 length;
|
||
|
|
Boolean inPlace;
|
||
|
|
UInt8 reservedA; /* ! Must be zero!*/
|
||
|
|
UInt16 reservedB; /* ! Must be zero!*/
|
||
|
|
};
|
||
|
|
typedef struct CFragSystem7MemoryLocator CFragSystem7MemoryLocator;
|
||
|
|
struct CFragSystem7DiskFlatLocator {
|
||
|
|
FSSpec * fileSpec;
|
||
|
|
UInt32 offset;
|
||
|
|
UInt32 length;
|
||
|
|
};
|
||
|
|
typedef struct CFragSystem7DiskFlatLocator CFragSystem7DiskFlatLocator;
|
||
|
|
/* ! This must have a file specification at the same offset as a disk flat locator!*/
|
||
|
|
struct CFragSystem7SegmentedLocator {
|
||
|
|
FSSpec * fileSpec;
|
||
|
|
OSType rsrcType;
|
||
|
|
SInt16 rsrcID;
|
||
|
|
UInt16 reservedA; /* ! Must be zero!*/
|
||
|
|
};
|
||
|
|
typedef struct CFragSystem7SegmentedLocator CFragSystem7SegmentedLocator;
|
||
|
|
/*
|
||
|
|
The offset and length for a "Bundle" locator refers to the offset in
|
||
|
|
the CFM executable contained by the bundle.
|
||
|
|
*/
|
||
|
|
struct CFragCFBundleLocator {
|
||
|
|
CFBundleRef fragmentBundle; /* Do not call CFRelease on this bundle!*/
|
||
|
|
UInt32 offset;
|
||
|
|
UInt32 length;
|
||
|
|
};
|
||
|
|
typedef struct CFragCFBundleLocator CFragCFBundleLocator;
|
||
|
|
struct CFragSystem7Locator {
|
||
|
|
SInt32 where;
|
||
|
|
union {
|
||
|
|
CFragSystem7DiskFlatLocator onDisk;
|
||
|
|
CFragSystem7MemoryLocator inMem;
|
||
|
|
CFragSystem7SegmentedLocator inSegs;
|
||
|
|
CFragCFBundleLocator inBundle;
|
||
|
|
} u;
|
||
|
|
};
|
||
|
|
typedef struct CFragSystem7Locator CFragSystem7Locator;
|
||
|
|
typedef CFragSystem7Locator * CFragSystem7LocatorPtr;
|
||
|
|
struct CFragSystem7InitBlock {
|
||
|
|
CFragContextID contextID;
|
||
|
|
CFragClosureID closureID;
|
||
|
|
CFragConnectionID connectionID;
|
||
|
|
CFragSystem7Locator fragLocator;
|
||
|
|
StringPtr libName;
|
||
|
|
UInt32 reservedA; /* ! Must be zero!*/
|
||
|
|
};
|
||
|
|
typedef struct CFragSystem7InitBlock CFragSystem7InitBlock;
|
||
|
|
typedef CFragSystem7InitBlock * CFragSystem7InitBlockPtr;
|
||
|
|
typedef CFragSystem7InitBlock CFragInitBlock;
|
||
|
|
typedef CFragSystem7InitBlockPtr CFragInitBlockPtr;
|
||
|
|
/* These init/term routine types are only of value to CFM itself.*/
|
||
|
|
typedef CALLBACK_API_C( OSErr , CFragInitFunction )(const CFragInitBlock * initBlock);
|
||
|
|
typedef CALLBACK_API_C( void , CFragTermProcedure )(void);
|
||
|
|
/* For use by init routines. If you get a BundlePreLocator, convert it to a CFBundleLocator with this*/
|
||
|
|
/*
|
||
|
|
* ConvertBundlePreLocator()
|
||
|
|
*
|
||
|
|
* Availability:
|
||
|
|
* Non-Carbon CFM: not available
|
||
|
|
* CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.1 and later
|
||
|
|
* Mac OS X: in version 10.1 and later
|
||
|
|
*/
|
||
|
|
EXTERN_API( OSErr )
|
||
|
|
ConvertBundlePreLocator(CFragSystem7LocatorPtr initBlockLocator);
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
.
|
||
|
|
===========================================================================================
|
||
|
|
Old Name Spellings
|
||
|
|
==================
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
-------------------------------------------------------------------------------------------
|
||
|
|
We've tried to reduce the risk of name collisions in the future by introducing the phrase
|
||
|
|
"CFrag" into constant and type names. The old names are defined below in terms of the new.
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
enum {
|
||
|
|
kLoadCFrag = kReferenceCFrag
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
#if OLDROUTINENAMES
|
||
|
|
#define IsFileLocation CFragHasFileLocation
|
||
|
|
typedef CFragConnectionID ConnectionID;
|
||
|
|
typedef CFragLoadOptions LoadFlags;
|
||
|
|
typedef CFragSymbolClass SymClass;
|
||
|
|
typedef CFragInitBlock InitBlock;
|
||
|
|
typedef CFragInitBlockPtr InitBlockPtr;
|
||
|
|
typedef CFragSystem7MemoryLocator MemFragment;
|
||
|
|
typedef CFragSystem7DiskFlatLocator DiskFragment;
|
||
|
|
typedef CFragSystem7SegmentedLocator SegmentedFragment;
|
||
|
|
typedef CFragSystem7Locator FragmentLocator;
|
||
|
|
typedef CFragSystem7LocatorPtr FragmentLocatorPtr;
|
||
|
|
typedef CFragSystem7MemoryLocator CFragHFSMemoryLocator;
|
||
|
|
typedef CFragSystem7DiskFlatLocator CFragHFSDiskFlatLocator;
|
||
|
|
typedef CFragSystem7SegmentedLocator CFragHFSSegmentedLocator;
|
||
|
|
typedef CFragSystem7Locator CFragHFSLocator;
|
||
|
|
typedef CFragSystem7LocatorPtr CFragHFSLocatorPtr;
|
||
|
|
enum {
|
||
|
|
kPowerPCArch = kPowerPCCFragArch,
|
||
|
|
kMotorola68KArch = kMotorola68KCFragArch,
|
||
|
|
kAnyArchType = kAnyCFragArch,
|
||
|
|
kNoLibName = 0,
|
||
|
|
kNoConnectionID = 0,
|
||
|
|
kLoadLib = kLoadCFrag,
|
||
|
|
kFindLib = kFindCFrag,
|
||
|
|
kNewCFragCopy = kPrivateCFragCopy,
|
||
|
|
kLoadNewCopy = kPrivateCFragCopy,
|
||
|
|
kUseInPlace = 0x80,
|
||
|
|
kCodeSym = kCodeCFragSymbol,
|
||
|
|
kDataSym = kDataCFragSymbol,
|
||
|
|
kTVectSym = kTVectorCFragSymbol,
|
||
|
|
kTOCSym = kTOCCFragSymbol,
|
||
|
|
kGlueSym = kGlueCFragSymbol,
|
||
|
|
kInMem = kMemoryCFragLocator,
|
||
|
|
kOnDiskFlat = kDataForkCFragLocator,
|
||
|
|
kOnDiskSegmented = kResourceCFragLocator,
|
||
|
|
kIsLib = kImportLibraryCFrag,
|
||
|
|
kIsApp = kApplicationCFrag,
|
||
|
|
kIsDropIn = kDropInAdditionCFrag,
|
||
|
|
kFullLib = kIsCompleteCFrag,
|
||
|
|
kUpdateLib = kFirstCFragUpdate,
|
||
|
|
kWholeFork = kCFragGoesToEOF,
|
||
|
|
kCFMRsrcType = kCFragResourceType,
|
||
|
|
kCFMRsrcID = kCFragResourceID,
|
||
|
|
kSHLBFileType = kCFragLibraryFileType,
|
||
|
|
kUnresolvedSymbolAddress = kUnresolvedCFragSymbolAddress
|
||
|
|
};
|
||
|
|
|
||
|
|
enum {
|
||
|
|
kPowerPC = kPowerPCCFragArch,
|
||
|
|
kMotorola68K = kMotorola68KCFragArch
|
||
|
|
};
|
||
|
|
|
||
|
|
#endif /* OLDROUTINENAMES */
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
#if PRAGMA_STRUCT_ALIGN
|
||
|
|
#pragma options align=reset
|
||
|
|
#elif PRAGMA_STRUCT_PACKPUSH
|
||
|
|
#pragma pack(pop)
|
||
|
|
#elif PRAGMA_STRUCT_PACK
|
||
|
|
#pragma pack()
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef PRAGMA_IMPORT_OFF
|
||
|
|
#pragma import off
|
||
|
|
#elif PRAGMA_IMPORT
|
||
|
|
#pragma import reset
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* __CODEFRAGMENTS__ */
|
||
|
|
|