TweetFollow Us on Twitter

GoodbyE Kiss
Volume Number:3
Issue Number:2
Column Tag:Tech Notes

GoodbyE Kiss

by Dan Weston

I'd like to inform the Mac community of a bug in the generic desk accessories that appear in my book, The Complete Book of Macintosh Assembly Language Programming, Vol I. Kirk Austin pointed out to me that the desk accessories crashed when receiving a goodbye kiss. The goodbye kiss is supposed to let your desk accessory clean up after itself if the application over which the accessory is running is terminated. For example, if your DA maintained open disk files or messed with low memory globals, you would normally close the files and reset the globals when a user closed the desk accessory. The goodbye kiss is provided by the Mac system software for those cases where the user quits an application without first closing the desk accessories. The underlying application doesn't need to be concerned with the goodbye kiss; it is handled totally by the Mac system software as it reinitializes the heap for the next program.

If you want your desk accessory to receive the goodbye kiss you must set bit #12 of the first word in the DA header. When an application terminates, the system software looks at each open desk accessory and sends a goodbye kiss if the appropriate bit is set in the DA header.

The goodbye kiss is a good idea. It prevents your desk accessory from being blown away without warning. The problem is that Inside Macintosh doesn't document how the goodbye kiss is implemented. In my book, I said that the goodbye kiss invoked the desk accessory's close routine. Now, after investigating a little further as a result of Kirk's letter, I find that the goodbye kiss doesn't invoke the close routine. Instead, the goodbye kiss is a control call with CSCode = -1. This causes big problems for my DA code because I use a jump table based on the belief that CSCode will ALWAYS be between 64 and 73. When the -1 CSCode hits the jump table it heads for ozone city; reach for the reset button.

The solution is to put a special case at the beginning of the control routine to watch for the goodbye control call and route it around the jump table (or just disable the goodbye call in the header, as Kirk did).

The modified code section follows:

; Control handles the control messages, which are the heart
; of the driver. Code values range from 64-73 (*** and -1
; for goodbye kiss ***) enter with pointer to DCE in A1 
; and pointer to Paramblock in A0 

 MOVEM.LA3-A4,-(SP); preserve A3 - A4  
 MOVE.L A1,A4    ; keep DCE ptr in A4 
 MOVE.L A0,A3    ; keep Pblock ptr in A3
 MOVE.W CSCode(A3),D0; get control opCode Pblock 
 CMP.W  #-1,D0   ; is this the goodbye kiss? 
 BEQ    DoGoodbye; goodbye routine 
 SUB.W  #64,D0   ; adjust range to 0-9 
 ADD.W  D0,D0    ; multiply by 2 for table 
 MOVE.W ControlTable(D0),D0 ; offset to routine 
 JMP    ControlTable(D0)  ; jump to it  

;---------- Offset table for Control routines --------- 
; **almost** all possible control messages that can be sent to
; a DA are here. All the routines mentioned here should 
; return by branching to CtlDone. 

DC.W  DoEvent-ControlTable; an event (64) 
DC.W  DoPeriodic-ControlTable ; a periodic interupt (65) 
DC.W  DoCursor-ControlTable ; adjust cursor on DA wind (66) DC.W
 DoMenu-ControlTable ; menu selection (67) 
DC.W  DoUndo-ControlTable ; undo (68)  
DC.W  CtlDone-ControlTable; *** code 69 is not used *** DC.W   DoCut-ControlTable
 ; cut (70)
DC.W  DoCopy-ControlTable ; copy (71) 
DC.W  DoPaste-ControlTable; paste (72) 
DC.W  DoClear-ControlTable; clear (73)  

 MOVE.L A4,A1    ; return DCE ptr to A1
 MOVE.L A3,A0    ; return PBlock ptr to A0
 MOVEM.L(SP)+,A3-A4; A3 - A4 restored 

 MOVE.W #0,D0    ; no error 
 RTS    ; go back to calling program 

 MOVE.L A4,A1    ; return DCE ptr to A1
 MOVE.L A3,A0    ; return PBlock ptr to A0
 MOVEM.L(SP)+,A3-A4; A3 - A4 restored  
 MOVE.W #0,D0    ; no error
 MOVE.L JIODone,-(SP); return vector for asynch calls 
 RTS    ; go back to calling program 
 BRA.S  CtlDone  

One other detail that is important to note is that the goodbye kiss is an asynchronous control call. All other calls to desk accessories are synchronous, which means that they can return with a simple RTS. Asynchronous calls, on the other hand, must return via the JIODone routine. The low memery global JIODone, holds a pointer to this system routine, which clears the request from the I/O queue. We move this pointer onto the stack and then RTS. This routes our return through the JIODone routine.

Thanks to Kirk for bringing this to my attention. If anyone else has bugs to report from the book I'd love to hear about them. As best I can, I'll fix the bugs and post the information here in Mactutor.


Community Search:
MacTech Search:

Software Updates via MacUpdate

Bookends 12.6.0 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Access the power of Bookends directly from Mellel, Nisus Writer Pro, or MS Word (... Read more
Apple iBooks Author 2.4 - Create and pub...
Apple iBooks Author helps you create and publish amazing Multi-Touch books for iPad. Now anyone can create stunning iBooks textbooks, cookbooks, history books, picture books, and more for iPad. All... Read more
Web Snapper 3.3.9 - Capture entire Web p...
Web Snapper lets you capture Web pages exactly as they appear in your browser. You can send them to a file as images or vector-based, multi-page PDFs. It captures the whole Web page - eliminating the... Read more
Tunnelblick 3.6beta10 - GUI for OpenVPN...
Tunnelblick is a free, open source graphic user interface for OpenVPN on OS X. It provides easy control of OpenVPN client and/or server connections. It comes as a ready-to-use application with all... Read more
EtreCheck 2.5.1 - For troubleshooting yo...
EtreCheck is a simple little app to display the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support... Read more
Paragraphs 1.0.4 - Writing tool just for...
Paragraphs is an app just for writers. It was built for one thing and one thing only: writing. It gives you everything you need to create brilliant prose and does away with the rest. Everything in... Read more
Things 2.8 - Elegant personal task manag...
Things is a task management solution that helps to organize your tasks in an elegant and intuitive way. Things combines powerful features with simplicity through the use of tags and its intelligent... Read more
Coda 2.5.12 - One-window Web development...
Coda is a powerful Web editor that puts everything in one place. An editor. Terminal. CSS. Files. With Coda 2, we went beyond expectations. With loads of new, much-requested features, a few surprises... Read more
PCalc 4.3 - Full-featured scientific cal...
PCalc is a full-featured, scriptable scientific calculator with support for hexadecimal, octal, and binary calculations, as well as an RPN mode, programmable functions, and an extensive set of unit... Read more
DiskMaker X 5.0 - Make a bootable OS X i...
DiskMaker X (was Lion DiskMaker) helps you to build a bootable drive from the official OS X installer app (the one you download from the Mac App Store). It detects the OS X Install program with... Read more

Camel Up (Games)
Camel Up 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: | Read more »
The Martian: Bring Him Home (Games)
The Martian: Bring Him Home 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Based on the best selling novel and critically acclaimed film, THE MARTIAN tells the story of Astronaut Mark... | Read more »
This Week at 148Apps: September 21-30, 2...
Leap Into Fall With 148Apps How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you're looking for. The ones we love become Editor’s Choice, standing out above... | Read more »
Tweetbot 4 for Twitter (Social Networki...
Tweetbot 4 for Twitter 4.0 Device: iOS Universal Category: Social Networking Price: $4.99, Version: 4.0 (iTunes) Description: *** 50% off for a limited time. *** | Read more »
Mori (Games)
Mori 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Stop, rewind and unwind with Mori. Time is always running, take a moment to take control. Mori is an action puzzle game about infinitely... | Read more »
100 Years' War (Games)
100 Years' War 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: | Read more »
Tower in the Sky (Games)
Tower in the Sky 0.0.60 Device: iOS Universal Category: Games Price: $1.99, Version: 0.0.60 (iTunes) Description: | Read more »
hocus. (Games)
hocus. 1.0.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0.0 (iTunes) Description: New, polished, mind-bending, minimal puzzle game with dozens of levels and extra-ordinary design Features:- Beautifully crafted... | Read more »
Mos Speedrun 2 (Games)
Mos Speedrun 2 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Mos is back, in her biggest and most exciting adventure ever! Wall-jump to victory through 30 mysterious, action packed levels... | Read more »
3D Touch could be a game-changer, but it...
Were you one of the lucky/financially secure enough ones to buy a new iPhone 6s or iPhone 6s Plus over the weekend? Yup, me too (I’m not convinced I was either of those two things, but let’s go with lucky for now), so I thought I’d delve into just... | Read more »

Price Scanner via

12-inch MacBooks in stock for up to $120 off,...
Adorama has 12″ Retina MacBooks in stock for up to $120 off MSRP including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB Adapter,... Read more
15-inch 2.2GHz Retina MacBook Pro on sale for... has the 15″ 2.2GHz Retina MacBook Pro on sale for $1799 including free shipping. Their price is $200 off MSRP, and it’s the lowest price available for this model (except for Apple’s $1699... Read more
iPhone 6s and 6s Plus Feature Improved Durabi...
Upgraded components in the new iPhone 6s Plus cost $16 more than the components in the earlier iPhone 6 Plus according to a preliminary estimate from IHS Inc. The bill of materials (BOM) for an... Read more
13-inch Retina MacBook Pros on sale for up to...
Adorama has 13″ Retina MacBook Pros on sale for up to $130 off MSRP. Shipping is free, and Adorama charges sales tax for NY & NJ residents only: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1199.99 $... Read more
Apple refurbished 2014 13-inch Retina MacBook...
Apple has Certified Refurbished 2014 13″ 2.6GHz/128GB SSD Retina MacBook Pros available $979, $320 off original MSRP. An Apple one-year warranty is included, and shipping is free: - 13″ 2.6GHz/128GB... Read more
iOS 9 Reflections Ten Days In – The ‘Book Mys...
I’ve never been much of an early adopter by philosophy or temperament, although I did buy the iPad Air 2 I’m typing this column on last fall only about a month after Apple unveiled it. However, my... Read more
Apple refurbished Time Capsules available for...
Apple has certified refurbished Time Capsules available for $120 off MSRP. Apple’s one-year warranty is included with each Time Capsule, and shipping is free: - 2TB Time Capsule: $179, $120 off - 3TB... Read more
OS X El Capitan Available as a Free Update To...
OS X El Capitan, the latest major release of Apple’s desktop operating system, is available today, September 30 as a free update for Mac users. “People love using their Macs, and one of the biggest... Read more
15-inch Retina MacBook Pros on sale for $150-...
B&H Photo has 2015 15″ Retina MacBook Pros on sale for up to $200 off MSRP including free shipping plus NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1815 $184 off - 15″ 2.5GHz Retina... Read more
Updated For iOS 9, InterConneX Lets You Store...
InterConneX version 1.2 is now a 64-bit app that’s completely compatible with iOS 9. InterConneX is a file storage, file management, and file sharing app for the iPhone or iPad that now takes... Read more

Jobs Board

*Apple* Systems Engineer (Mclean, VA and NYC...
Title: Apple Systems Engineer (Mclean, VA and NYC)Location: United States-New York-New York-NYC 200 Park Avenue (22005)Other Locations: United Read more
*Apple* Retail - Multiple Positions (US) - A...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, you're Read more
*Apple* Retail - Multiple Customer Support P...
Job Description:Customer SupportSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
SW QA Engineer - *Apple* TV - Apple (United...
**Job Summary** The Apple TV team is looking for experienced Quality Assurance Engineers with a passion for delivering first in class home entertainment solutions. **Key Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.