mirror of
https://github.com/elliotnunn/mac-rom.git
synced 2024-06-12 19:38:59 +00:00
4325cdcc78
Resource forks are included only for .rsrc files. These are DeRezzed into their data fork. 'ckid' resources, from the Projector VCS, are not included. The Tools directory, containing mostly junk, is also excluded.
104 lines
3.5 KiB
C
104 lines
3.5 KiB
C
/************************************************************
|
|
|
|
Created: Thursday, September 7, 1989 at 9:15 PM
|
|
Perf.h
|
|
C Interface to the Macintosh Libraries
|
|
|
|
|
|
Copyright Apple Computer, Inc. 1986-1991
|
|
All rights reserved
|
|
This file is used in these builds: ROM System
|
|
|
|
|
|
Change History (most recent first):
|
|
|
|
<3> 8/8/91 JL Update copyright
|
|
|
|
To Do:
|
|
|
|
DESCRIPTION
|
|
Provides for PC-sampling of User code resources, ROM code, and RAM (misses).
|
|
Produces output text file suitable for input to PerformReport.
|
|
|
|
Design objectives:
|
|
Language independent, i.e. works with Pascal, C, and Assembly.
|
|
Covers user resources as well as ROM code.
|
|
Memory model independent, i.e. works for Desk Accessories and drivers.
|
|
Uses TimeManager on new ROMs, Vertical Blanking interrupt on 64 K ROMs.
|
|
|
|
|
|
************************************************************/
|
|
|
|
|
|
#ifndef __PERF__
|
|
#define __PERF__
|
|
|
|
#ifndef __TYPES__
|
|
#include <Types.h>
|
|
#endif
|
|
|
|
struct TPerfGlobals {
|
|
long startROM; /*ROM Base*/
|
|
long romHits; /*used if MeasureROM is false*/
|
|
long misses; /*count of PC values outside measured memory*/
|
|
long (*segArray)[1]; /*array of segment handles*/
|
|
long (*sizeArray)[1]; /*array of segment sizes*/
|
|
short (**idArray)[1]; /*array of segment rsrc IDs*/
|
|
long (*baseArray)[1]; /*array of offsets to counters for each segment*/
|
|
long (*samples)[1]; /*samples buffer*/
|
|
long buffSize; /*size of samples buffer in bytes*/
|
|
short timeInterval; /*number of clock intervals between interrupts*/
|
|
short bucketSize; /*size of buckets power of 2*/
|
|
short log2buckSize; /*used in CvtPC*/
|
|
short pcOffset; /*offset to the user PC at interrupt time.*/
|
|
short numMeasure; /*# Code segments (w/o jump table)- ROM etc.*/
|
|
short firstCode; /*index of first Code segment*/
|
|
Boolean takingSamples; /*true if sampling is enabled.*/
|
|
Boolean measureROM;
|
|
Boolean measureCode;
|
|
short ramSeg; /*index of "segment" record to cover RAM > 0 if RAM (misses) are to be bucketed.*/
|
|
long ramBase; /*beginning of RAM being measured.*/
|
|
short measureRAMbucketSize;
|
|
short measureRAMlog2buckSize;
|
|
short romVersion;
|
|
short vRefNum; /*Volume where the report file is to be created*/
|
|
Boolean volumeSelected; /*True if user selects the report file name*/
|
|
Str255 rptFileName; /*Report file name*/
|
|
Str255 rptFileCreator; /*Report File Creator*/
|
|
Str255 rptFileType; /*Report File type*/
|
|
ResType getResType; /*Resource type*/
|
|
};
|
|
|
|
typedef struct TPerfGlobals TPerfGlobals;
|
|
typedef TPerfGlobals *TP2PerfGlobals;
|
|
|
|
/* PerfGlobals are declared as a record, so main program can allocate
|
|
as globals, desk accessory can add to globals allocated via pointer,
|
|
print driver can allocate via low memory, etc. */
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
pascal Boolean InitPerf(TP2PerfGlobals *thePerfGlobals,short timerCount,
|
|
short codeAndROMBucketSize,Boolean doROM,Boolean doAppCode,const Str255 appCodeType,
|
|
short romID,const Str255 romName,Boolean doRAM,long ramLow,long ramHigh,
|
|
short ramBucketSize); /* called once to setup Performance monitoring
|
|
*/
|
|
pascal void TermPerf(TP2PerfGlobals thePerfGlobals); /* if InitPerf succeeds then TermPerf must be called before terminating program.
|
|
*/
|
|
pascal Boolean PerfControl(TP2PerfGlobals thePerfGlobals,Boolean turnOn);
|
|
/*
|
|
Call this to turn off/on measuring.
|
|
Returns previous state.
|
|
*/
|
|
|
|
pascal short PerfDump(TP2PerfGlobals thePerfGlobals,const Str255 reportFile,
|
|
Boolean doHistogram,short rptFileColumns); /* Call this to dump the statistics into a file. */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|