TweetFollow Us on Twitter

Boot Disk Icon
Volume Number:5
Issue Number:5
Column Tag:Programmer's Forum

Related Info: Finder Interface Device Manager

Change the Boot Disk Icon

By David Dunham, Goleta, CA

I’ve been asked several times how my bootDiskIcon INIT works. I told the questioners that I’d answer in MacTutor.

Also, this is a short article. MacTutor needs more of them -- I know how to initialize Managers and handle events, and I certainly don’t need to see pictures in hexadecimal. (This isn’t just a snide remark directed at the editor, it’s a plea to those with nifty ideas that don’t need an entire application to show them off. Write a one or two page article!)

bootDiskIcon is a hack that came about because I don’t own an HD20. Apple insists on portraying their internal hard disk as an HD 20 on my desktop. I got so disgusted with this that I wrote an INIT to show something else, anything but an HD 20. ICN# 256, in fact. bootDiskIcon is inferior to programs like Façade-- it’s less flexible, and may not work with all hard disks -- but it was better than nothing, and it’s easy to understand.

The key to bootDiskIcon is the way the Finder handles disk icons. A pedantic digression: how does one find out how Finder handles icons? It’s not in Inside Macintosh. Therefore, it must be in a Technical Note. But Finder isn’t a category in the table of contents. So it’s off to the index but it’s not listed under “icon.” Luckily, it was one of the “Finder” Tech Notes, number 28. How did I know to keep looking? Because I’d seen it years ago when it came out, and knew it was there somewhere. Always skim every Tech Note -- not to memorize them, but to remember that they’re there.

When the Finder wants a disk icon, it gives the disk driver a Control call with csCode = 21. The driver returns a pointer to an ICN#. My first inclination was, why write code when you can change data? The ICN# must be part of the disk driver. The disk driver is part of Apple HD SC Setup. I found it there (it’s not a resource), changed it, and reinstalled the driver. This failed utterly -- there’s apparently a checksum.

If I couldn’t change the ICN# on disk, how about changing it in memory? I can get its address in memory by giving the driver a csCode = 21 call, then simply change the data. This is what bootDiskIcon does.

Before I get to what you’re all waiting for, the source code, I’ll mention the difference between patches and INITs. A patch is a change to a piece of code, almost always one of the traps. An INIT resource is any piece of code that runs at startup time (typically in a file of type INIT, cdev, or rdev). An INIT frequently installs a patch, but it could do anything at all, like playing a tune or subverting a disk driver’s icon.

More ideological baggage: INITs should announce their presence. Paul Mercer has a good way to do this, called ShowINIT. I’m told the source code’s available on AppleLink. I’ve modified it to handle color icons, and compiled the whole thing as a separate resource, SHOW 0. bootDiskIcon calls this code. You’re welcome to use it in any non-commercial (free or shareware) programs -- just use ResEdit to paste SHOW 0 into your own INIT file. You may not use it in public domain programs. These are those without a copyright holder, and I don’t want my code in the public domain. Don’t make the mistake of calling your free program “public domain.” Once you do, you can’t get it back (despite what Adobe thinks).

We can almost get to the code, but you might be wondering how to test it. It’s real inconvenient to reboot, just to see if a change worked. Luckily, you don’t have to. Remember that an INIT is just a piece of code that happens to get executed at boot time. You can often execute the same code at any time, and instruct your development system to make an INIT resource when you’re finished debugging. In bootDiskIcon’s case, I simply executed it, juggled into the Finder layer, and verified that I’d chant the code. It starts out by calling my SHOW resource -- the parameters are reversed from the way they’re defined because my ShowICON is defined as a Pascal procedure. My sloppiness in not defining it as such in this C program probably works only because this is an INIT -- if I trash the stack, it doesn’t much matter, since I’ll be returning to INIT 31 very soon.

The real work begins with finding out the driver refNum and drive of the first mounted disk (now you know why it’s called bootDiskIcon -- I told you it was a quick hack). I then find the address of the driver’s ICN#, get an ICN# of my own choice, and overwrite the driver’s using BlockMove.

#include <deviceMgr.h>
#include <hfs.h>

#define NIL 0L

void  main(void);/* Always use prototypes! */

void main() {
 Ptr    icn;
 int    error;   /* Shouldn’t really be write-only  */
 HParamBlockRec  pb;
 cntrlParam cpb;
 Handle handle;

 /* Show icon on the bottom of the screen */
 handle = GetResource(‘SHOW’,0); /* Get handle to the PROC */
 if (handle == 0L) { /* Something’s wrong (couldn’t load) */
 SysBeep(32);    /* Let somebody know */
 return;/* Don’t try to call it! */
 }
 HLock(handle);  /* Hold down the PROC */
 (**(ProcPtr *)handle)(-1,128);  
 /* ShowICON() -- note reversed parameters */
 HUnlock(handle);/* Let it float in the heap again */

 /* Change the icon */
 pb.volumeParam.ioNamePtr = NIL;
 pb.volumeParam.ioVolIndex = 1;  /* First mounted volume */
 error = PBHGetVInfo(&pb,FALSE);
 cpb.ioRefNum = pb.volumeParam.ioVDRefNum;
 cpb.ioVRefNum = pb.volumeParam.ioVDrvInfo;  
 /* drive (ioDrvNum) */
 cpb.csCode = 21;
 error = PBControl(&cpb,FALSE);
 icn = *(Ptr *)(&cpb.csParam[0]);
 handle = GetResource(‘ICN#’,256);
 BlockMove(*handle,icn,256L);
}

Known Bugs

Actually, these are rumored bugs, because it works for me! I’m told it doesn’t work with Jasmine disks where the driver puts the SCSI ID inside the flower. It probably doesn’t work with a boot floppy, because the Finder normally special cases the disk icon. (Furthermore, Finder probably doesn’t consider floppies to be “foreign drives.”)

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

How to build a successful civilisation i...
GodFinger 2 grants you godlike powers, leaving you to raise a civilization of followers. In the spirit of games like Black & White, the GodFinger games will see you building bigger and better villages, developing more advanced technology and... | Read more »
How to get all the crabs in Mr Crab 2
Mr. Crab 2 may look like a cutesy platformer for kids, but if you're the kind of person who likes to complete a game 100%, you'll soon realise that it's a tougher than a crustacean's shell. [Read more] | Read more »
How to be a star in Britney Spears: Amer...
If you've ever wanted to be a star, baby, then you've probably already checked out Britney Spears: American Dream and are happily making your way up the charts. But fame doesn't come easy, and everyone needs a helping hand sometimes. So we've got... | Read more »
AppSpy is hiring a part time Staff Write...
| Read more »
How to save lives in ER Surgery Simulato...
A serious earthquake has struck a nearby town in ER Surgery Simulator - Emergency Doctor, and it’s up to you to save the victims. [Read more] | Read more »
Tips and tricks to get a high score in G...
Ketchapp Games loves the endless runner genre. And its newest game, Gravity Switch, is no exception. Gravity Switch takes a fresh approach, though, as you move a block, suspended in zero gravity, safely through a maze of shifting pillars. If the... | Read more »
Tips and tricks to get a high score in S...
Smash Fu is a high-paced tile-tapping game that requires quick reflexes and some practice. You’ll have to smash bricks with the skill of a seasoned black belt to get a high score. To raise the stakes a bit, you’ll also have to avoid tapping any... | Read more »
How to keep the ball rolling in Dropple
If you're new to the minimalist puzzler Dropple, you may find yourself struggling to make it beyond the first couple of steps before your ball falls into the endless abyss below. [Read more] | Read more »
Game Craft releases new Legend of War ti...
Set for release at the end of this month, real time strategy title Legend of War seems sure to delight with a veritable feast of sweet features to get stuck into. Developed by Game Craft, the game is due for release through both the App Store and... | Read more »
How not to die in Traffic Rider
Traffic Rider, an Out Run-esque game in which your ride a motorcycle recklessly into trffic, might not seem particularly complicated. [Read more] | Read more »

Price Scanner via MacPrices.net

Apple refurbished iMacs available for up to $...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... Read more
Textkraft Professional Becomes A Mobile Produ...
The new update 4.1 of Textkraft Professional for the iPad comes with many new and updated features that will be particularly of interest to self-publishers of e-books. Highlights include import and... Read more
SnipNotes 2.0 – Intelligent note-taking for i...
Indie software developer Felix Lisczyk has announced the release and immediate availability of SnipNotes 2.0, the next major version of his productivity app for iOS devices and Apple Watch.... Read more
Pitch Clock – The Entrepreneur’s Wingman Laun...
Grand Rapids, Michigan based Skunk Tank has announced the release and immediate availability of Pitch Clock – The Entrepreneur’s Wingman 1.1, the company’s new business app available exclusively on... Read more
13-inch 2.9GHz Retina MacBook Pro on sale for...
B&H Photo has the 13″ 2.9GHz Retina MacBook Pro (model #MF841LL/A) on sale for $1599 including free shipping plus NY tax only. Their price is $200 off MSRP. Amazon also has the 13″ 3.9GHz Retina... Read more
Apple price trackers, updated continuously
Scan our Apple Price Trackers for the latest information on sales, bundles, and availability on systems from Apple’s authorized internet/catalog resellers. We update the trackers continuously: - 15″... Read more
Clearance 12-inch Retina MacBooks available s...
B&H Photo has dropped prices on leftover 2015 12″ Retina MacBooks with models now available starting at $999. Shipping is free, and B&H charges NY tax only: - 12″ 1.1GHz Gray Retina MacBook... Read more
Check Apple prices on any device with the iTr...
MacPrices is proud to offer readers a free iOS app (iPhones, iPads, & iPod touch) and Android app (Google Play and Amazon App Store) called iTracx, which allows you to glance at today’s lowest... Read more
New 2016 13-inch 256GB MacBook Air on sale fo...
B&H Photo has the new 13″ 1.6GHz/256GB MacBook Air (model MMGG2LL/A) on sale for $1149 including free shipping plus NY sales tax only. Their price is $50 off MSRP. Amazon has the 13″ 1.6GHz/256GB... Read more
Apple refurbished iPad Air 2s available start...
Apple has Certified Refurbished iPad Air 2 available starting at $339. Apple’s one-year warranty is included with each model, and shipping is free: - 128GB Wi-Fi iPad Air 2: $499 - 64GB Wi-Fi iPad... Read more

Jobs Board

*Apple* Nissan Service Technicians - Apple A...
Apple Automotive is one of the fastest growing dealer...and it shows. Consider making the switch to the Apple Automotive Group today! At Apple Automotive , Read more
ISCS *Apple* ID Site Support Engineer - APP...
…position, we are looking for an individual who has experience supporting customers with Apple ID issues and enjoys this area of support. This person should be Read more
Automotive Sales Consultant - Apple Ford Linc...
…you. The best candidates are smart, technologically savvy and are customer focused. Apple Ford Lincoln Apple Valley is different, because: $30,000 annual salary Read more
*Apple* Support Technician II - Worldventure...
…global, fast growing member based travel company, is currently sourcing for an Apple Support Technician II to be based in our Plano headquarters. WorldVentures is Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.