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

BBEdit 11.6.4 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
beaTunes 4.6.12 - Organize your music co...
beaTunes is a full-featured music player and organizational tool for music collections. How well organized is your music Library? Are your artists always spelled the same way? Any R.E.M. vs REM?... Read more
Tinderbox 7.0.1 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
FotoMagico 5.4 - Powerful slideshow crea...
FotoMagico lets you create professional slideshows from your photos and music with just a few, simple mouse clicks. It sports a very clean and intuitive yet powerful user interface. High image... Read more
Direct Mail 4.3.9 - Create and send grea...
Direct Mail is an easy-to-use, fully-featured email marketing app purpose-built for OS X. It lets you create and send great looking email campaigns. Start your newsletter by selecting from a gallery... Read more
Tinderbox 7.0.1 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
Direct Mail 4.3.9 - Create and send grea...
Direct Mail is an easy-to-use, fully-featured email marketing app purpose-built for OS X. It lets you create and send great looking email campaigns. Start your newsletter by selecting from a gallery... Read more
FotoMagico 5.4 - Powerful slideshow crea...
FotoMagico lets you create professional slideshows from your photos and music with just a few, simple mouse clicks. It sports a very clean and intuitive yet powerful user interface. High image... Read more
beaTunes 4.6.12 - Organize your music co...
beaTunes is a full-featured music player and organizational tool for music collections. How well organized is your music Library? Are your artists always spelled the same way? Any R.E.M. vs REM?... Read more
Spotify 1.0.49.125. - Stream music, crea...
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

The best sales on the App Store this wee...
The App Store has quite an exciting lineup of discount games this week that range across a variety of genres. It's a great opportunity to catch up on some of the premium games you may have been holding off on -- and some you can even grab for free... | Read more »
The best new games we played this week
Ah, here we are again at the close of another busy week. Don't rest too easy, though. We had a lot of great new releases in mobile games this week, and now you're going to have to spend all weekend playing them. That shouldn't be too much of a... | Read more »
Rollercoaster Tycoon Touch Guide: How to...
| Read more »
Rabbids Crazy Rush Guide: How to unlock...
The Rabbids are back in a new endless running adventure, Rabbids Crazy Rush. It's more ridiculous cartoon craziness as you help the little furballs gather enough fuel (soda) to get to the moon. Sure, it's a silly idea, but everyone has dreams --... | Read more »
Tavern Guardians (Games)
Tavern Guardians 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Tavern Guardians is a Hack-and-Slash action game played in the style of a match-three. You can experience high pace action... | Read more »
Slay your way to glory in idle RPG Endle...
It’s a golden age for idle games on the mobile market, and those addictive little clickers have a new best friend. South Korean developer Ekkorr released Endless Frontier last year, and players have been idling away the hours in the company of its... | Read more »
Tiny Striker: World Football Guide - How...
| Read more »
Good news everyone! Futurama: Worlds of...
Futurama is finding a new home on mobile in TinyCo and Fox Interactive's new game, Futurama: Worlds of Tomorrow. They're really doing it up, bringing on board Futurama creator Matt Groening along with the original cast and writers. TinyCo wants... | Read more »
MUL.MASH.TAB.BA.GAL.GAL (Games)
MUL.MASH.TAB.BA.GAL.GAL 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: ENDLESS UPGRADES. CONSTANT DANGER. ANCIENT WISDOM. BOUNCY BALLS. Launch Sale, 40% OFF for a very limited time!!! MUL.... | Read more »
Dungeon Rushers (Games)
Dungeon Rushers 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Dungeon Rushers is a 2D tactical RPG combining dungeon crawler’s gameplay and turn based fights. Manage your team, loot dusty... | Read more »

Price Scanner via MacPrices.net

13-inch 2.0GHz Apple MacBook Pros on sale for...
B&H has the non-Touch Bar 13″ 2.0GHz MacBook Pros in stock today and on sale for $100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.0GHz MacBook Pro Space Gray (... Read more
15-inch Touch Bar MacBook Pros on sale for up...
B&H Photo has the new 2016 15″ Apple Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.7GHz Touch Bar... Read more
12-inch Retina MacBooks on sale for $1150, $1...
B&H has 12″ 1.1GHz Retina MacBooks on sale for $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1149 $150 off MSRP - 12″ 1.1GHz... Read more
Apple restocks refurbished 11-inch MacBook Ai...
Apple has Certified Refurbished 11″ MacBook Airs (the latest models recently discontinued by Apple), available for up to $170 off original MSRP. An Apple one-year warranty is included with each... Read more
Apple Park Opens to Employees in April With T...
Apple has announced that Apple Park, the company’s new 175-acre campus, will be ready for employees to begin occupying in April. The process of moving more than 12,000 people will take over six... Read more
Manhattan Neighbors for Safer Telecommunicati...
A new education and advocacy group focused on cell phone and wireless risks, Manhattan Neighbors for Safer Telecommunications, launched today at http://www.ManhattanNeighbors.org. Manhattan... Read more
Portable Dual DisplayPort Monitor Dock Enable...
IOGEAR has announced the launch of its USB-C Dual DisplayPort Monitor Portable Dock (GUC3CMST). The dock enables users to easily connect two DisplayPort monitors to a USB-C or Thunderbolt 3 laptop to... Read more
13-inch 2.7GHz Retina MacBook Pro on sale for...
Amazon.com has restocked the 13″ 2.7GHz/128GB Retina MacBook Pro (MF839LL/A) for $200 off MSRP including free shipping: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1099 $200 off MSRP This model tends to... Read more
Apple’s New iPad Ads Don’t Address Pro Users’...
Apple launched a new tranche of iPad Pro TV ads last week addressing actual queries and challenges from the Twitterverse, albeit using actors for the visuals. That’s great. As an iPad fan and heavy... Read more
Free Verbum Catholic Bible Study App For iOS
The Verbum mobile app runs on Logos’ powerful Bible software and is an advanced resource for mobile Catholic study. The Verbum app surrounds the Bible with the Tradition. Verbum comes with 15 free... 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
*Apple* Retail - Multiple Positions- Chicago...
SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and 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
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.