Programming Macintosh Applications In Assembly Language Feb84

MACINTOSH USEREDUCATION Programming Macintosh Applications See Also: Modification in Assembly Language /lNTl.0/ASSEM Macintosh Memory Management: An Overview The MemoryManager: A Programmer's Guide The Segment Loader: A Programmer'• Guide The Operating System Utilities: A Prograamer'a Guide Putting Together a Macintosh Application History: First Draft s. Chernicoff 2/27/84 ABSTRACT This manual tells you what you need to know to write all or part of your Macintosh application program in assembly language. The emphasis here is on general principles and methods; details on specific OS and Toolbox routines are given elsewhere. 2 Progra1111ingMacintosh Applications in Assembly Language TABLEOF CONTENTS 3 3 4 8 10 10 12 12 12 14 17 18 19 23 About This Manual Definition Files Memory Organization The Dispatch Table The Trap Mechanism Format of Trap Words Trap Macros Calling Conventions Register-Based Calls Stack-Based Calla Register-Saving Conventions Pascal Interface to the OS and Toolbox Mixing Pascal and Assembly Language Glossary Copyright (c) 1984 Apple Computer, Inc. All rights reserved. Distribution of this draft in limited quantities does not constitute publication. ABOUT THIS MANUAL 3 ABOUT THIS MANUAL This manual tells you what you need to know to write all or part of your Macintosh application program in assembly language. The emphasis here is on general principles and methods; details on specific OS and Toolbox routines are given elsewhere. The manual assumes you already know how to write assembly language for the Motorola MC6B001.l (or just "68001.l" for short). the microprocessor used in the Macintosh. It also assumes you're familiar With Lisa Pascal and its associated software development tools. particularly the Assembler, the Pascal Compiler. and the Linker. ***(Currently.all software for the Macintosh must be developed on a Lisa computer and written on a Macintosh-formatted disk for execution on the Macintosh. Eventually development tools Will be available on the Macintosh itself.) *** The manual begins by discussing the various files of definitions pertaining to the OS and Toolbox, and what they contain. Then it describes the Macintosh's memory layout and organization. This is followed by a description·of the dispatch table and the trap mechanism, which allow your program to use the OS and Toolbox while remaining independent of specific addresses in the Macintosh ROM. Next is a discussion of the calling conventions for using the OS and Toolbox from assembly language and for mixing Pascal and assembly language in your own programs. Finally, there's a glossary of terms used in this manual. DEFINITIONFILES The primary aids to assembly-language programmers are a set of definition files that define various symbolic names for use in assemblylanguage programs. By naming the definition files in an .INCLUDE directive, you make the definitions available to your program. The most important of the definition files are the equat…