TweetFollow Us on Twitter

Nov 99 Factory Floor

Volume Number: 15 (1999)
Issue Number: 11
Column Tag: Factory Floor

CodeWarrior in a Carbonized World

by Richard Atwell and Dave Mark

Back in August, our good buddy Richard Atwell gave us a glimpse of life with a Carbon-based CodeWarrior debugger. This month, Richard parts the curtains a bit more and talks about life with Mac OS 9 out the door and Mac OS X right behind.

Richard Alexander David Atwell, aka ratwell, is the Mac OS Debugger Engineer at Metrowerks. Richard collects vintage CodeWarrior CDs in his spare time. You can contact him about the DR/3.5 CD you'd like to send him at

Dave: This past summer, you told us all about Metrowerks' debugger plans. Can you tell us what has happened since then?

Richard: Since the August interview, we've made tremendous progress on the Carbonized IDE. Now that Mac OS 9 has gone final, you can look forward to an update that has been built for Apple's latest OS release. The Mac OS X version is right behind it and we'll have a better idea of the release date once the next IDE update comes out and after Apple delivers another Mac OS X developer preview CD. Keep reading the Factory Floor to find out.

Dave: Given all the operating system compatibility issues that developers have to consider how many versions of the IDE are there going to be?

Richard: Just one. We've put a huge amount of effort into maximizing the experience and minimizing the adjustments that developers will have to make. To that end we're planning to deliver a single IDE binary that runs on Mac OS 8 through X. The IDE 4.0 from Pro5 supported the last version of System 7, Mac OS 7.6.1, mainly because of the MRJ minimum runtime requirements.

We're not sure how much longer we can continue to support pre-8 releases of the operating system. Our tools are no longer hosted on 68k and there will no doubt be compelling reasons to move the IDE forwards that will make backward compatibility difficult.

If you are familiar with Carbon development, you'll know that even if you decide to only target Carbon there are several development issues that crop up depending on how far back you want to support older operating systems. We believe that most of our developers keep up with OS updates but we also understand that being able to debug and develop on older systems is sometimes an important necessity. We'll support System 7 as long as we can.

Dave: What are the latest Factory Updates that have been released?

Richard: Before we delivered Pro 5 we announced that we were going to release annually instead of semi-annually. In between releases we promised to release updates to tools and libraries to address bugs and feature requests. We've done that recently with two Factory Updates: 5.1 and 5.2.

The first update contained a new IDE 4.0.1 and was released to address some outstanding IDE 4.0 bugs that we weren't able to fix before the Pro5 release. The 5.2 update contained updated compilers, MSL and an IDE 4.0.2.

We are excited about this approach because it returns us closer to our original release cycle. Up until CW11 we released every 4 months in an almost clockwerk like fashion but it became harder to maintain this release schedule as the IDE became larger and larger. So you can see we are going to be updating the tools just as often; we're just not pressing CDs as often.

Dave: I noticed that Pro 5 MetroNub isn't compatible with previous releases. What happened?

Richard: That was unfortunate. In order to add Mac OS X and AltiVec debugging support at the same time we were constrained to release a version of MetroNub that couldn't be installed and used with previous releases. This meant you couldn't install a single MetroNub extension and use Pro4-Pro1 debuggers or older Pro-based releases like our CodeWarrior tools for the Palm Computing Platform.

Dave: What good are the older releases?

Richard: Well, it depends. You may have older projects that you can't update because they are works in progress or you might be on a tight development schedule and unable to upgrade. You might prefer to debug your program on an older version of the system software using the standalone debugger, MW Debug, that last shipped with Pro 2.

In any case, Pro5 forced you to switch MetroNubs and reboot in order to switch tools. I've rewritten parts of MetroNub to bring backward compability so you can continue to mix the new tools with the older ones. This MetroNub has been beta tested by some brave individuals from the comp.sys.mac.programmer.codewarrior newsgroup and we will release this version in the next factory update.

Dave: There's more to CodeWarrior than just the IDE. Can you give us a rundown on the progress that has been made with the rest of the tool suite?

Richard: PowerPlant is the premier Macintosh framework. PowerPlant has been shipping on CodeWarrior since the DR/1 days thanks to the brilliant work of Greg Dow.

Lately, Greg has been carbonizing PowerPlant for use with the Universal Interfaces 3.3. Greg released a preliminary version to our beta testers and we are planning on releasing PowerPlant 2.1 in an upcoming Factory Update. Hopefully Greg will appear in a future column to explain all the goodies packed into the latest PowerPlant.

We write our tools using PowerPlant as the underlying framework. If you still haven't looked into PowerPlant you're missing out. Check it out.

Dave: What's happening with ZoneRanger?

Richard: ZoneRanger has been with us for a long time. Joshua originally wrote it as a shareware tool and we brought him on board to improve it for our Mac users. In fact you can still find an older version that we give away on the website.

You can use ZoneRanger 2.2 in order to help you understand how your program manages memory. Look inside the "Other Metrowerks Tools" folder for ZoneRanger and alongside it you'll also find a sample program called LeakyApp. It's very instructional to watch LeakyApp trigger events in ZoneRanger based on actions you select from the menus in LeakyApp.

LeakyApp was built with a file called ZoneRanger.c that you'll need to add to your project. This C file works it's magic by replacing memory allocators in MSL that register the blocks of memory in a way that the ZoneRanger application can record. In order to do this you must alter the link order of your project so ZoneRanger.c links before any of the MSL C libraries in your project. Look for linker warnings telling you that some of the allocators were previously defined in ZoneRanger.c and you'll know you are on the right track.

In previous releases ZoneRanger's recording mechanism was built in the MSL libraries and turned on by default in Pro 4. This slowed down release versions of programs a little that didn't even care about memory management so we moved it outside of MSL.

You can learn more about ZoneRanger by reading the manual located on the CodeWarrior Reference CD.

Dave: I've used the Profiler before to speed up my programs. What's changed?

Richard: The MW Profiler 1.7 that Steve and Neal wrote is essentially the same one we've shipped for several releases. Users complained that because the icon was the same as the IDE it was difficult to select the right application from the tear off application menu that appears in Mac OS 8.5 when neither the IDE nor the Profiler were the foreground application. We changed the icon with Pro 5 so they won't get confused.

We've also added two features to the Pro5 version. The first is the ability to accurately profile the time that threads are using. Previous versions miscalculated the time threads were asleep so you couldn't really profile your threads. Now this is fixed you'll be able to fine-tune your application even further.

The second thing we did was to add capability into the Profiler to analyze the data that the profiler libraries generate and feed this information back into the linker. Why would you want to do this? One good reason is VM. Without going into a lengthy discussion about operating systems, when virtual memory is on, your program is residing on disk and parts of it are swapped into memory as the OS deems necessary. It does this in order to execute it and maximize the use of memory between multi-tasking programs. Functions in memory that call functions that are not in memory have to be loaded first and this is time consuming because disk drives are so much slower than memory. All this happens in the background without any control by the running program so you probably didn't realize that you could do anything about it.

Between the CPU and the disk t RAM and fast cache memories exist and as a general rule the more you can execute within the context of the cache the faster your programs will run.

Towards this end the Profiler can now write out one of two kinds of .arr files. These are called arrange files and they contain lists of functions that are given to the linker in order to instruct the linker to organize the functions so the ones that call each other frequently are proximally close to each other. This can reduce the time that the OS wastes going to disk to retrieve functions to be called. Because programs don't call all programs with the same frequency you can see how optimizing the layout of the binary can speed up the program.

To set up your project this way, go to the PPC PEF preference panel, set the code sorting popup to read "Use .arr file" and add your arrange file to the project. You've been able to manually create this file yourself with the last few compiler releases but now we have a tool that can generate it for you based on the way your program actually behaves.

Dave: Is the Find Library new?

Richard: The Find Library is a set of text files that MWRon produces. MWRon is our ombudsman in the newsgroups. Ron got tired of answering questions that explained which libraries contained what API call so he disassembled all the libraries and stripped them off all the "junk" leaving only the name tables.

You can open CodeWarrior's Find Dialog, drop all Find Libary files on it, and search for the library that contains the function you are looking for. Then you just add the library that matches the name of the disassembled file MWRon created to your project to remove any linker errors.

MWRon updates this set of files each release to match the latest Universal Interfaces from Apple.

Dave: We talked about MetroNub Remote in our last chat (The Factory Floor, August 1999).

Richard: That hasn't changed since Pro 5. We'll update it for a future release. Many networking improvements will come from the MetroNub plugin and extension release that I said was forthcoming.

MetroNub will continue to evolve as the OS evolves. As long as we can continue to make MetroNub and MetroNub Remote run on older system you'll be able to debug anywhere the IDE can't run.

There's a hidden treat in the Metrowerks CodeWarrior folder. Look inside the (Debugger Extras) folder and you'll find a folder called MetroNub Utilities. This folder contains a C file and instructions to allow your project to determine if it is being debugged by the IDE. You may want to know this in order to call DebugStr or take some action to help you debug your program when you know it's under the control of the debugger.

We used to have a co-existing file called MWDebugUtils on the reference CD but it became obsolete when the debugger became integrated into the IDE.

Dave: DebugNew is a hidden treasure. Why is it hiding in the Mac OS Support folder?

Richard: DebugNew used to be hidden inside the Libraries sub-folder of Mac OS Support so we moved it up so users could find it easier.

DebugNew is a another memory tool like ZoneRanger but it is designed to be used only in debug versions of your program. If you are writing programs in C++ you can add DebugNew to your project and use it to track memory leaks, memory overwrites that occur when you use new, delete, new[] and delete[].

You can find instructions on how to use it in the manuals on the Reference CD.

Dave: What can you tell me about the ways in which I can customize CodeWarrior with third-party tools?

Richard: Several ways: you can replace a CodeWarrior plugin with a third-party compiler but there are other options as well.

Locate these three folders in the Metrowerks CodeWarrior folder:

(Editor Extensions)
(ToolServer Tools)

The first one is for BBEdit[TM] Extensions. BBEdit[TM] is a full featured editor that comes with several plugins called extensions to automate editing. You can use these from CodeWarrior by placing the extensions in the shielded folder and turn on the "Use BBEdit[TM] Extensions" option in the IDE Extras preference panel. When you do, an extra menu will appear in the menubar that displays the names of the extensions that are in the folder. The menu shows up as an icon so it's easy to recognize.

The Scripts folder allows you to access AppleScripts and execute them from within the context of the IDE. You can write scripts that drive the project engine or modify the text of your source code. Take a look at some of the example scripts we're already written and placed in that folder. You will need to turn this feature on from the IDE Extras preference panel also.

The last folder contains a text file with instructions for enabling the ToolServer window from within the IDE. ToolServer is part of MPW and is located within the CodeWarrior MPW folder. When properly installed, you can execute MPW tools from a CodeWarrior window. If there's a feature you've been looking for us to implement you'll probably be able to find it in the form of an MPW tool.


Community Search:
MacTech Search:

Software Updates via MacUpdate

DEVONthink Pro 2.9.6 - Knowledge base, i...
DEVONthink Pro is your essential assistant for today's world, where almost everything is digital. From shopping receipts to important research papers, your life often fills your hard drive in the... Read more
Safari Technology Preview 10.1 - The new...
Safari Technology Preview contains the most recent additions and improvements to WebKit and the latest advances in Safari web technologies. And once installed, you will receive notifications of... Read more
VueScan 9.5.60 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
Civilization VI 1.0.0 - Next iteration o...
Sid Meier’s Civilization VI is the next entry in the popular Civilization franchise. Originally created by legendary game designer Sid Meier, Civilization is a strategy game in which you attempt to... Read more
Adobe Flash Player - Plug-in...
Adobe Flash Player is a cross-platform, browser-based application runtime that provides uncompromised viewing of expressive applications, content, and videos across browsers and operating systems.... Read more
RestoreMeNot 2.0.4 - Disable window rest...
RestoreMeNot provides a simple way to disable the window restoration for individual applications so that you can fine-tune this behavior to suit your needs. Please note that RestoreMeNot is designed... Read more
Persecond 1.0.7 - Timelapse video made e...
Persecond is the easy, fun way to create a beautiful timelapse video. Import an image sequence from any camera, trim the length of your video, adjust the speed and playback direction, and you’re done... Read more
iShowU Instant 1.1.0 - Full-featured scr...
iShowU Instant gives you real-time screen recording like you've never seen before! It is the fastest, most feature-filled real-time screen capture tool from shinywhitebox yet. All of the features you... Read more
Spotify - Stream music, creat...
Spotify is a streaming music service that gives you on-demand access to millions of songs. Whether you like driving rock, silky R&B, or grandiose classical music, Spotify's massive catalogue puts... Read more
HoudahSpot 4.2.6 - Advanced file-search...
HoudahSpot is a powerful file search tool. Use HoudahSpot to locate hard-to-find files and keep frequently used files within reach. HoudahSpot will immediately feel familiar. It works just the way... Read more

Latest Forum Discussions

See All

5 Halloween mobile games for wimps
If you're anything like me, horror games are a great way to have nightly nightmares for the next decade or three. They're off limits, but perhaps you want to get in on the Halloween celebrations in some way. Fortunately not all Halloween themed... | Read more »
The 5 scariest mobile games
It's the most wonderful time of the year for people who enjoy scaring themselves silly with haunted houses, movies, video games, and what have you. Mobile might not be the first platform you'd turn to for quality scares, but rest assured there are... | Read more »
Lifeline: Flatline (Games)
Lifeline: Flatline 1.0.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.0 (iTunes) Description: The Lifeline series takes a terrifying turn in this interactive horror experience. Every decision you make could help... | Read more »
Game of Dice is now available on Faceboo...
After celebrating its anniversary in style with a brand new update, there’s even more excitement in store for Game of Dice has after just being launched on Facebook Gameroom. A relatively new platform, Facebook Gameroom has been designed for PC... | Read more »
4 addictive clicker games like Best Fien...
Clickers are passive games that take advantage of basic human psychology to suck you in, and they're totally unashamed of that. As long as you're aware that this game has been created to take hold of your brain and leave you perfectly content to... | Read more »
Smile Inc. Guide: How not to die on the...
As if Mondays weren't bad enough, at Smile Inc. you have to deal with giant killer donuts, massive hungry staplers, and blasting zones. It's not exactly a happy, thriving work environment. In fact, you'll be lucky to survive the nine to five.... | Read more »
Oh...Sir! The Insult Simulator (Games)
Oh...Sir! The Insult Simulator 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: | Read more »
WitchSpring2 (Games)
WitchSpring2 1.27 Device: iOS Universal Category: Games Price: $3.99, Version: 1.27 (iTunes) Description: This is the story of Luna, the Moonlight Witch as she sets out into the world. This is a sequel to Witch Spring. Witch Spring 2... | Read more »
4 popular apps getting a Halloween makeo...
'Tis the season for all things spooky. So much, so, in fact, that even apps are getting into the spirt of things, dressing up in costume and spreading jack o' lanterns all about the place. These updates bring frightening new character skins, scary... | Read more »
Pokémon GO celebrates Halloween with can...
The folks behind Pokémon GO have some exciting things planned for their Halloween celebration, the first in-game event since it launched back in July. Starting October 26 and ending on November 1, trainers will be running into large numbers of... | Read more »

Price Scanner via

Worldwide Smartphone Shipments Up 1.0% Year o...
According to preliminary results from the International Data Corporation (IDC) Worldwide Quarterly Mobile Phone Tracker, vendors shipped a total of 362.9 million smartphones worldwide in the third... Read more
TuneBand Arm Band For iPhone 7 and 7 Plus Rel...
Grantwood Technology has added the TuneBand for iPhone 7 and 7 Plus to its smartphone armband series. The TuneBand provides a lightweight and comfortable way to wear the iPhone while running,... Read more
1.4GHz Mac mini on sale for $449, save $50
Adorama has the 1.4GHz Mac mini on sale for $50 off MSRP including free shipping plus NY & NJ sales tax only: - 1.4GHz Mac mini (Apple sku# MGEM2LL/A): $449 $50 off MSRP To purchase a mini at... Read more
21-inch 1.6GHz iMac on sale for $999, save $1...
B&H has the 21″ 1.6GHz Apple iMac on sale for $999 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more
Macs’ Superior Enterprise Deployment Cost Eco...
IBM’s debunking of conventional wisdom and popular mythology about the relative cost of using Apple Mac computers as opposed to PCs running Microsoft Windows at the sixth annual Jamf Nation User... Read more
12-inch WiFi Apple iPad Pros on sale for $50-...
B&H Photo has 12″ WiFi Apple iPad Pros on sale for $50-$70 off MSRP, each including free shipping. B&H charges sales tax in NY only: - 12″ Space Gray 32GB WiFi iPad Pro: $749 $50 off MSRP -... Read more
Apple refurbished 12-inch 128GB iPad Pros ava...
Apple has Certified Refurbished 12″ Apple iPad Pros available for up to $160 off the cost of new iPads. An Apple one-year warranty is included with each model, and shipping is free: - 32GB 12″ iPad... Read more
Apple refurbished iPad minis and iPad Air 2s...
Apple recently dropped prices on several Certified Refurbished iPad mini 4s and 2s as well as iPad Air 2s. An Apple one-year warranty is included with each model, and shipping is free: - 16GB iPad... Read more
MacHTTP-js Preview Full-featured Web Server f...
MacHTTP.Org has released MacHTTP-js Preview for macOS, a full-featured Web server for 21st Century desktops and servers. MacHTTP-js is a modern take on the classic stand-alone, desktop computer Web... Read more
Samsung Galaxy Tab A 10.1 with S Pen Makes US...
Samsung Electronics America, Inc. has announced the release of the Galaxy Tab A 10.1 with S Pen in a highly mobile, lightweight tablet. “With an embedded S Pen, consumers can discover more ways to... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Software Engineering Intern: UI Applications...
Job Summary Apple is currently seeking enthusiastic interns who can work full-time for a minimum of 12-weeks between Fall 2015 and Summer 2016. Our software Read more
Security Data Analyst - *Apple* Information...
…data sources need to be collected to allow Information Security to better protect Apple employees and customers from a wide range of threats.Act as the subject Read more
*Apple* Retail - Multiple Positions - Apple,...
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* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 52812872 Houston, Texas, United States Posted: Oct. 18, 2016 Weekly Hours: 40.00 **Job Summary** As an Apple Solutions Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.