TweetFollow Us on Twitter

May 95 Top 10
Volume Number:11
Issue Number:5
Column Tag:Symantec Top 10

Symantec Top 10

This monthly column, written by Symantec’s Technical Support Engineers, aims to provide you with technical information based on the use of Symantec products.

By Colen Garoutte-Carson, Quality Assurance & Technical Support, Symantec Corp.

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Q: How do I build a fat application with Symantec C++ v8.0?

A: We’ve touched on this before, and here’s a more detailed look. When an application is launched on a 68K Macintosh, the operating system (OS) loads and executes a 68K ‘CODE’ resource ID 1. When an application is launched on a PowerMac, the OS first looks for a ‘cfrg’ resource describing a PowerPC code fragment stored in the application’s data fork, and if found, prepares and executes the PowerPC code fragment. If the OS is unable to launch the application this way, it tries to loads and execute a 68K ‘CODE’ resource ID 1.

A fat (fat-binary) application has both a PowerPC code fragment and 68K ‘CODE’ resources, and can be launched on either platform.

To create a fat binary app, enable the option to merge an existing 680x0 application into your final application, in the project Options dialog, in the Project Type settings for an application. This copies all resources from the 68K application that do not already exist in your PowerPC application. Most importantly, this copies all 68K ‘CODE’ resources to your PowerPC application.

Resources in your 68K application with the same type and ID as those in your PowerPC application will not be copied.

You can also build a fat application by including a 68K application’s ‘CODE’ resources in a resource (.rsrc) file, and adding that resource file to your PowerPC project.

Q: How do I create an accelerated code resource?

A: Although the linker in Symantec C++ v8.0 does not yet support the creation of code resources, there is a way to create a code resource from a PowerPC application using Symantec Rez. Symantec C++ v8.0 includes a Code Resource project model which does this.

The Code Resource project model consists of two projects. The first, Code Resource.Π, is similar to a Mac Application project, but doesn’t include InitToolbox() (it’s unnecessary in a code resource). It uses the rsrcMPWPPCRuntime.o runtime library instead of PPCRuntime.o, and PPCLink & MakePEF instead of the internal linker.

In PowerMac applications, constructors and destructors for global and static objects are called automatically by __cplusstart(), which the linker assigns as the main entry point to your application (not main()). This routine calls your constructors, initializes your QuickDraw globals, calls your main() function, and then calls your destructors.

In a shared library, constructors for global and static objects are called by __cplusinit, which the linker assigns as an initialization routine. The Code Fragment Manager will automatically call this initialization routine when your shared library is loaded. The __cplusinit() routine will also hook your shared library’s QuickDraw globals into the QuickDraw globals of the calling application. Destructors for global and static objects are called by __cplusterm(), which the linker assigns as a termination routine. The Code Fragment Manager will automatically call this termination routine when your shared library is unloaded.

In code resources, there is no way to automatically call constructors or destructors for global and static objects, or hook QuickDraw globals, and still preserve the arguments passed to main(). Instead, you must call routines to do this for you. In C, you use __rsrcinit() and __rsrcterm(), declared in stdlib.h. In C++, you use __cplusrsrcinit() and __cplusrsrcterm(), declared in new.h. The C++ initialization and termination routines call the C initialization and termination routines. Use only the C++ or C initialization routines. Do not use both. These routines are defined in the rsrcMPWPPCRuntime.o library.

If your code resource is called only once to perform its function, call __rsrcinit() or __cplusrsrcinit() at the start of your program, and __rsrcterm() or __cplusrsrcterm() at the end.

If your code resource is reentrant, call __rsrcinit() or __cplusrsrcinit() only the first time your code resource is called, and __rsrcterm() or __cplusrsrcterm() the last time your code resource is called.

Do not use any QuickDraw globals, or any global or static objects that rely on their constructor, before calling __rsrcinit() or __cplusrsrcinit().

The second project in the Code Resource project model will copy the data fork of the target built by Code Resource.Π into a resource and prepend a routine descriptor to it. Code Resource.Π is included as a sub-project to the second project. Debugging is disabled for the sub-project to ensure that the sub-project’s target is built instead of a temporary instant-run PEF when the parent project is brought up to date.

Code Resource.Π includes two resource (.r) files, _CopyToResource.r and __AppendRoutineDescriptor.r.

_CopyToResource.r reads the data fork of the sub-project’s target and stores it into a temporary resource.

__AppendRoutineDescriptor.r prepends a routine descriptor to the temporary resource and stores it in your final resource. Before you build your code resource, you will need to modify a number of #define’s in this file. The file contains comments that describe the necessary changes.

The Always check file dates option is enabled in the second project to ensure that the resource description files’ dependency on the sub-project’s target is properly tracked.

__AppendRoutineDescriptor.r is dependant on _CopyToResource.r. These files have been named to compile in the right order.

Once the parent project has been brought up to date, your accelerated code resource will be stored in the project’s resource file (<projectname>.rsrc).

Q: How do I create a fat or safe fat code resource?

A: You can build a fat or safe fat code resource in much the same way that you would create an accelerated code resource, discussed above. The Code Resource project model includes support for these fat code resource types, as well as a few others. See the comments within the project model for details.

Q: Why are my structs a different size in my PowerPC project than they are in my 68K project?

A: The MC68000 chip must reference word or long values from even addresses. More recent chips in the 680x0 family do not have this limitation, but perform faster when referencing word or long values from even addresses. The 68040 and PowerPC chips perform even faster with structures aligned on 4-byte boundaries.

If you need to share data structures in memory between 68K and PowerPC code (e.g. when passing data to the Macintosh Toolbox’s pre-existing 68K-based interfaces), or need to read or write data structures from/to disk with both 68K and PowerPC code, you will need to ensure that your alignment settings match in both your 68K and PowerPC projects.

By default, the PowerPC compilers align fields within structs on 4-byte boundaries. By default, the 68K C++ compiler aligns fields within structs on 2-byte boundaries. Think C always aligns fields within structs on 2-byte boundaries.

The PowerPC compiler supports the following #pragma directive to enable 68K (2-byte) structure alignment in a given structure declaration :

#pragma options align=mac68K
/* Your struct declaration */
#pragma options align=reset

Q: My 68K application, created with the Visual Architect in v7.0(.x), works fine. Why does a fat version of the same application not run on a 68K Mac?

A: Because of changes in the TCL, you will need to re-compile the 68K application with the 68K environment and TCL included in version 8, and re-merge it into your fat application.

Q: When I run my program with the debugger, it launches “Power Mac DebugServices”. This program remains running invisibly. How can I quit this application when I am done debugging?

A: You can write an AppleScript that contains the following :

 tell application "Power Mac DebugServices" to quit

Never run this script while debugging. To ensure that DebugServices has quit when no longer needed, name the script ShutDown, and put it in your (Scripts) folder. The script will be run when you quit the Symantec Project Manager.

Q: Can I use Apple’s new Toolbox Assistant with the Symantec Project Manager?

A: Yes. The Symantec Project Manager supports both The THINK Reference and QuickViewer. It is capable of using both simultaneously.

As with the Think Project Manager, the Symantec Project Manager will allow you to reference the Think Reference or QuickViewer directly if an alias to it, named exactly “THINK Reference” or “Primary Doc Server”, is located in your “(Tools)” folder. The Symantec Project Manager considers these names synonymous. The Symantec Project Manager will search a second documentation server if it’s unsuccessful in finding a match in the first. The second documentation server’s alias must also be located in the “(Tools)” folder and must be named “Secondary Doc Server”.

Q: When I convert my Think Project Manager project, the Symantec Project Manager preserves the segmentation in groups. Is there a way around this?

A: Yes, hold down the shift key when opening the Think Project Manager project.

Q: How do I Check In files to my SourceServer database for the first time? And how do I Check Out files from a SourceServer database that I’ve never checked out before?

A: To do these actions, you must send the command to SourceServer manually. The Symantec Project Manager includes a Worksheet window, available under the Windows menu, that you can use to send commands to SourceServer or ToolServer.

Example of a CheckIn command :

CheckIn -new "filename.cp"

Q: Can I use Check In on the Revision menu to check in header files to a SourceServer database?

A: Yes. In the project Options dialog, on the “Extension” settings page, add .h to the list of supported filename extensions, but do not specify a translator. You will be able to add files with names ending in .h to your project, but they will not be compiled. You can then check these files into your SourceServer database by selecting them in the project window, and then selecting Check In from the Revision menu.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

MacCleanse 9.0 - $29.95
MacCleanse is the product of thousands of hours of intense research and development. It meticulously scans all of the nooks and crannies of a computer for unnecessary junk that can take up huge... Read more
MacPilot 12.0 - $15.96
MacPilot gives you the power of UNIX and the simplicity of Macintosh, which means a phenomenal amount of untapped power in your hands! Use MacPilot to unlock over 1,200 features, and access them all... Read more
NetNewsWire 5.1 - RSS and Atom news read...
NetNewsWire is the best way to keep up with the sites and authors you read most regularly. Let NetNewsWire pull down the latest articles, and read them in a distraction-free and Mac-like way. Native... Read more
FontExplorer X Pro 7.1.3 - Font manageme...
FontExplorer X Pro is optimized for professional use; it's the solution that gives you the power you need to manage all your fonts. Now you can more easily manage, activate and organize your... Read more
DiskCatalogMaker 8.2.5 - Catalog your di...
DiskCatalogMaker is a simple disk management tool which catalogs disks. Simple, light-weight, and fast Finder-like intuitive look and feel Super-fast search algorithm Can compress catalog data for... Read more
Skim 1.5.12 - PDF reader and note-taker...
Skim is a PDF reader and note-taker for OS X. It is designed to help you read and annotate scientific papers in PDF, but is also great for viewing any PDF file. Skim includes many features and has a... Read more
rekordbox 6.1.0.0030 - Professional DJ m...
rekordbox is the best way of preparing and managing your tracks, be it at home, in the studio, or even on the plane! It allows you to import music from other music-management software using the... Read more
iExplorer 4.4.0 - View and transfer file...
iExplorer is an iPhone browser for Mac lets you view the files on your iOS device. By using a drag and drop interface, you can quickly copy files and folders between your Mac and your iPhone or... Read more
OmniGraffle 7.17.5 - Create diagrams, fl...
OmniGraffle helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use Graffle to... Read more
Apple Configurator 2.13.1 - Configure an...
Apple Configurator makes it easy to deploy iPad, iPhone, iPod touch, and Apple TV devices in your school or business. Use Apple Configurator to quickly configure large numbers of devices connected to... Read more

Latest Forum Discussions

See All

Raziel: Dungeon Arena is a hack 'n...
Raziel: Dungeon Arena is available now on mobile and will appeal to fans of both comic books and old school dungeon crawlers. Not only will you hack 'n' slash your way through mobs of enemies but there's also fully-narrated animated comic to enjoy... | Read more »
Steam Link Spotlight - Hades
Steam Link Spotlight is a feature where we look at PC games that play exceptionally well using the Steam Link app. Our last entry was on Disco Elysium. Read about how it plays using Steam Link over here. | Read more »
Microsoft has acquired ZeniMax Media and...
In the latest of a series of blockbuster moves, Microsoft has now acquired Zenimax Media and its subsidiary, Bethesda Softworks, for $7.5 billion. [Read more] | Read more »
Infinity Mechs is an upcoming idle game...
Indie developer SkullStar studio has announced an upcoming idle mech game called Infinity Mechs. It draws inspiration from the mobile game Iron Saga and has been officially licensed by Game Duchy. It's set to launch for both iOS and Android on... | Read more »
PUBG Mobile Lite's latest update se...
PUBG Mobile Lite, the streamlined version of the popular battle royale that's designed to work on less powerful devices, sees the return of a popular game variant today, Survive Till Dawn mode. It arrives as part of the 0.19.0 content update. [... | Read more »
Matchy Catch, Jyamma Games’ new hyper-ca...
Matchy Catch is a new hyper-casual puzzler from Jyamma Games, the Italian studio behind the Pong-inspired puzzle-adventure Hi-Ball Rush. It’s only the developer’s second game for iOS and Android devices, but it promises to be every bit as fun and... | Read more »
Among Us! Imposter Guide - How to be a s...
Among Us! continues to be getting a lot of play in these parts, and since our first guide we've learned a thing or two about the game. This is especially true regarding the imposter role, as its a relatively rare opportunity that we've now put... | Read more »
Paladin's Story is an upcoming fant...
Paladin's Story is an upcoming fantasy RPG with an off-kilter sense of humour that's heading for iOS and Android. It will officially launch for both on September 16th though the game is already available on Google Play in Early Access. [Read more... | Read more »
Among Us! Guide - Tips for the uninitiat...
| Read more »
A Pretty Odd Bunny is a stealth-platform...
A Pretty Odd Bunny is a stealth-platformer from two-man team AJ Ordaz and René Rivera. It follows the story of a red-eyed rabbit who is allergic to carrots and instead has a penchant for devouring pigs. It's available now for Android devices. [... | Read more »

Price Scanner via MacPrices.net

The cheapest Macs are back in stock today at...
Apple has restocked clearance, previous-generation, Certified Refurbished Mac minis starting at only $599. Each mini comes with free shipping plus Apple’s standard one-year warranty. These are the... Read more
Sale! Amazon has 2020 13″ 2.0GHz MacBook Pros...
Amazon has 2020 13″ MacBook Pros with 10th generation Intel CPUs back in stock on sale again today for $150-$200 off Apple’s MSRP. Shipping is free. Be sure to purchase the MacBook Pro from Amazon,... Read more
Base 13″ 1.4GHz Apple MacBook Pros on sale fo...
Apple reseller Expercom is offering a $65-$75 discount on new 2020 13″ 1.4GHz MacBook Pros, depending on configuration. Shipping is free. Expercom estimates shipping in 3-5 days, as stock of Apple’s... Read more
Price drop! Get a 44mm Apple Watch Series 5 G...
Amazon has dropped their price on the 44mm Apple Watch Series 5 GPS + Cellular by $100 to $429 shipped. That’s $100 off Apple’s original MSRP for this model. For the latest prices and sales, see our... Read more
Verizon offers $200 discount on new Apple Wat...
Verizon will take up to $200 off the purchase of a new GPS + Cellular Apple Watch Series 6 or Apple Watch SE with select trade-in and the purchase of a new iPhone with service. The fine print: “Get... Read more
Verizon offers $250 discount on new 8th gener...
Verizon will take up to $250 off the price of an 8th generation 2020 Apple Cellular iPad with select trade-ins and a new iPhone purchase. Plus get Apple News+ free for 6 months. The fine print: “Save... Read more
Apple’s Implementation Of COVID-19 Exposure...
NEWS: 09.18.20 – The latest effort by Apple to embed exposure notifications for COVID-19 contact tracing right into its mobile operating system has some iPhone users weary of being exposed to... Read more
Here’s how to get a 16″ MacBook Pro for $300...
B&H Photo has new 16″ MacBook Pros on sale today for $250-$300 off Apple’s MSRP, starting at $2099. Expedited shipping is free to many addresses in the US: – 2019 16″ 2.6GHz 6-Core MacBook Pro... Read more
Apple has Certified Refurbished 16″ MacBook P...
Apple has Certified Refurbished 2019 16″ MacBook Pros available for up to $420 off the cost of new models, starting at $2039. Each model features a new outer case, shipping is free, and an Apple 1-... Read more
Price drops! Apple reseller B&H drops App...
B&H Photo has dropped prices on Apple Watch Series 5 models by $50-$70 off Apple’s original MSRP. Shipping is free. These are the same Apple Watch models sold by Apple in their retail and online... Read more

Jobs Board

Security Officer ($23.00/Hourly) - *Apple*...
**Security Officer \($23\.00/Hourly\) \- Apple Store** **Description** About NMS Built on a culture of safety and integrity, NMSdelivers award\-winning, integrated Read more
Security Officer ($23.00/Hourly) - *Apple*...
**Security Officer \($23\.00/Hourly\) \- Apple Store** **Description** About NMS Built on a culture of safety and integrity, NMSdelivers award\-winning, integrated Read more
Platform - Workplace Eng - *Apple* Enterpri...
MORE ABOUT THIS JOB We are looking for an Apple Platform Engineer who will bring a unique engineering skill set, support, clarity, organization and above all else, Read more
*Apple* Certified Repair Technician - Utah S...
…selected candidate will work in the USU Campus Store Tech Department as an Apple Certified Repair Technician and floor associate. This position is for both summer Read more
Senior Data Engineer - *Apple* - Theorem, L...
Job Summary Apple is seeking an experienced, detail-minded data engineeringconsultant to join our worldwide business development and strategy team. If you are Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.