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 

Control 
 
 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. 

ControlTable:
   
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)  

;--------------------------------------------   
CtlDone:  
 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 

;----------------------------------------------------   
DoGoodBye:
 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

VOX 2.8.24 - Music player that supports...
VOX just sounds better! The beauty is in its simplicity, yet behind the minimal exterior lies a powerful music player with a ton of features and support for all audio formats you should ever need.... Read more
OmniPlan 3.7.1 - Robust project manageme...
With OmniPlan, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success,... Read more
Dropbox 24.4.17 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
WhatsApp 0.2.4238 - Desktop client for W...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more
SteerMouse 5.1 - Powerful third-party mo...
SteerMouse is an advanced driver for USB and Bluetooth mice. It also supports Apple Mighty Mouse very well. SteerMouse can assign various functions to buttons that Apple's software does not allow,... Read more
OmniPlan Pro 3.7.1 - Professional-grade...
With OmniPlan Pro, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success... Read more
1Password 6.7 - Powerful password manage...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
Adium 1.5.10.4 - Popular instant messagi...
Adium is a fast and free instant messaging client which supports AIM, ICQ, Jabber, MSN, Yahoo!, Google Talk, Yahoo! Japan, Bonjour, Gadu-Gadu, Novell Groupwise, SIP/SIMPLE (Text), and Lotus Sametime... Read more
File Juicer 4.57 - $18.00
File Juicer is a drag-and-drop can opener and data archaeologist. Its specialty is to find and extract images, video, audio, or text from files which are hard to open in other ways. In computer... Read more
WhatsApp 0.2.4238 - Desktop client for W...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more

Latest Forum Discussions

See All

Olli by Tinrocket (Photography)
Olli by Tinrocket 1.0 Device: iOS iPhone Category: Photography Price: $2.99, Version: 1.0 (iTunes) Description: Get drawn in with Olli by TinrocketOlli instantly turns your everyday moments into hand-drawn art and animations. • Watch... | Read more »
Penarium (Games)
Penarium 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: | Read more »
Fire Emblem Heroes is way more profitabl...
Profits for Nintendo's mobile game Fire Emblem Heroes are apparently impressive enough to beat out other Nintendo titles likeSuper Mario Run, despite having 10 times fewer downloads. [Read more] | Read more »
Classic series Robot Unicorn Attack 3 no...
The classic Adult Swim browser game, Robot Unicorn Attack, branched off into a series of popular mobile games. Now, the latest entry into the series, Robot Unicorn Attack 3, is available for iOS and Android mobile devices. [Read more] | Read more »
Sudoku Sweeper (Games)
Sudoku Sweeper 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: A minimalist mashup of Minesweeper and Sudoku. Logic puzzle perfection. Every row, column and zone contains a bomb and one of... | Read more »
Under Leaves (Games)
Under Leaves 1.0.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.0 (iTunes) Description: Journey into the forest, the jungle or the depths of the deep blue sea. Find chestnuts for the pigs, a caterpillar for the... | Read more »
Ninja Pizza Girl (Games)
Ninja Pizza Girl 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: In the not-so-distant future, rampart traffic congestion has resulted in only one way to deliver pizzas across town in thirty... | Read more »
SCRAP (Games)
SCRAP 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: That day, for no apparent reason, SCRAP decided to wake up and run. He had to, because his activation was a mistake the "Factory" could... | Read more »
The Bunker (Games)
The Bunker 1.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.1 (iTunes) Description: The critically acclaimed console hit "The Bunker" comes to iOS, The groundbreaking live-action thriller adventure set in a real... | Read more »
Die With Glory (Games)
Die With Glory 1.2.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.2.0 (iTunes) Description: Die with Glory is an epic adventure game where your goal is to die in glorious fashion. You must help Sigurd, a brave old... | Read more »

Price Scanner via MacPrices.net

New System Clock for macOS by B-Eng Now Avail...
Fehraltorf, Switzerland based B-Eng has announced the release and immediate availability of System Clock, the company’s new system monitor and information app developed exclusively for macOS. System... Read more
DEVONtechnologies Celebrates 15th Anniversary...
DEVONtechnologies celebrates its 15th company anniversary with a 30% discount on all its software products from May 1st through 5th, 2017. In spring 2002, DEVONtechnologies opened its website and... Read more
WaterField Designs Invites Customers to Help...
San Francisco based WaterField Designs invites customers and air travelers to participate in developing the next generation in-flight travel case, the Air Porter. Frustrated with limited legroom,... Read more
Save up to $260 with Apple refurbished 12-inc...
Apple has Certified Refurbished 2016 12″ Retina MacBooks available for $200-$260 off MSRP. Apple will include a standard one-year warranty with each MacBook, and shipping is free. The following... Read more
Digital Paper Tablet Offers Distraction Free...
I typically spend 8-10 hours a day gazing at the screens in my laptops and iPad, as tools of my livelihood, I don’t as a rule use electronic devices for pleasure reading. I subscribe to a daily... Read more
“Today at Apple” Bringing New Educational Ses...
Apple has announced plans to launch dozens of new educational sessions next month in all 495 Apple Stores ranging in topics from photo and video to music, coding, art and design, and more. The hands-... Read more
Smart Finance Free Comprehensive Personal Fin...
Moscow-based indie developer, Alexander Survillo has announced the release and immediate availability of Smart Finance: Personal Finance, Budget & Money 1.1.4, an update to his comprehensive... Read more
12-inch 1.1GHz Retina MacBooks on sale for $1...
B&H has 12″ 1.1GHz Retina MacBooks on sale for $100 off MSRP. Shipping is free, and B&H charges NY & NJ sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1199.99 $100 off MSRP - 12... Read more
13-inch 2.7GHz Retina MacBook Pro on sale for...
B&H Photo has the 13″ 2.7GHz Retina MacBook Pro on sale for $130 off MSRP. Shipping is free, and B&H charges NY & NJ tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro (MF839LL/A): $1169 $... Read more
15-inch 2.2GHz Retina MacBook Pros available...
B&H Photo has the 15″ 2.2GHz Retina MacBook Pro available for $200 off MSRP including free shipping plus NY & NJ sales tax only: - 15″ 2.2GHz Retina MacBook Pro (MJLQ2LL/A): $1799.99 $200 off... Read more

Jobs Board

*Apple* Mac Computer Technician - GeekHampto...
…complex computer issues over the phone and in person? GeekHampton, Long Island's Apple Premium Service Provider, is looking for you! Come work with our crew Read more
*Apple* Retail - Multiple Positions- Chicago...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Systems Engineer - California Polyte...
Cal Poly, San Luis Obispo Apple Systems Engineer Department: ITS - Customer & Tech Support (134900) College/Division: Academic Affairs Salary Range: Position Read more
*Apple* Mobile Master - Best Buy (United Sta...
**501042BR** **Job Title:** Apple Mobile Master **Location Number:** 000416-East Lansing-Store **Job Description:** **What does a Best Buy Apple Mobile Master Read more
Best Buy *Apple* Computing Master - Best Bu...
**501195BR** **Job Title:** Best Buy Apple Computing Master **Location Number:** 000211-Colorado Blvd-Store **Job Description:** **What does a Best Buy Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.