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

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.