Question

An XCode project on OSX 10.6 fails building due to exit code 3 when trying to run Rez. What does this mean? I’m sure the files exist and all paths are set correctly, and have valid content. Google and AltaVista turn up nothing but others with the same question.

More generally, since I have a talent for creating errors on OSX, is there a list of all possible exit codes for Rez and what they mean? Are these standard among all of Apples command line programs?

UPDATE:
Here’s the first .r file that Rez tries to compile, but stops with exit code 3:

// The About box and resources are created in PIUtilities.r.
// You can easily override them, if you like.

#define plugInName          "HackFormat"
#define plugInCopyrightYear "1957"
#define plugInDescription \
    "Hackup of sample plugin SimpleFormat to test plugin making procedures (DSW)"




// Dictionary (aete) resources:

#define vendorName          "DarenTheMonkey"
#define plugInAETEComment   "simpleformat example file format module"

#define plugInSuiteID       'sdK4'
#define plugInClassID       'simP'
#define plugInEventID       typeNull // must be this


#include "PIDefines.h"
#include "Types.r"
#include "SysTypes.r"
#include "PIGeneral.r"
#include "PIUtilities.r"
#include "PITerminology.h"
#include "PIActions.h"
#include "HackFormatTerminology.h"  // Terminology for plug-in.

//-------------------------------------------------------------------------------
//  PiPL resource
//-------------------------------------------------------------------------------

resource 'PiPL' (ResourceID, plugInName " PiPL", purgeable)
{
    {
        Kind { ImageFormat },
        Name { plugInName },
        Version { (latestFormatVersion ",                            /* must be exactly this */
                keyInherits,                                /* must be keyInherits */
                classFormat,                                /* parent: Format, Import, Export */
                "parent class format",                      /* optional description */
                flagsSingleProperty,                        /* if properties, list below */

                "foo",
                keyMyFoo,
                typeBoolean,
                "foobar",
                flagsSingleProperty,

                "bar",
                keyMyBar,
                typeBoolean,
                "foobar",
                flagsSingleProperty
                /* no properties */
            },
            {}, /* elements (not supported) */
            /* class descriptions */
        },
        {}, /* comparison ops (not supported) */
        {}  /* any enumerations */
    }
};


resource StringResource (kHistoryEntry, "History", purgeable)
{
    plugInName ": ref num=^0."
};


// end file

and, from the xcode Build Results window, (just for this first .r file; rest are same)

Build HackFormat of project hackformat with configuration Debug

Check dependencies

[WARN]Warning: The Copy Bundle Resources build phase contains this target's Info.plist file 'Info.plist'.

Rez tmp/hackformat.build/Debug/HackFormat.build/ResourceManagerResources/Objects/HackFormat-A69F02213383561.rsrc HackFormat.r
cd /home/dwilson/proj/PSPlug/hackformat
/Developer/Tools/Rez -o /home/dwilson/proj/PSPlug/hackformat/tmp/hackformat.build/Debug/HackFormat.build/ResourceManagerResources/Objects/HackFormat-A69F02213383561.rsrc -d SystemSevenOrLater=1 -useDF -script Roman -arch x86_64 -i /home/dwilson/proj/PSPlug/hackformat/Debug -i /home/dwilson/proj/PSPlug/hackformat/sampcomm -i sampcomm -i /home/dwilson/proj/PSPlug/hackformat -i /home/dwilson/proj/PSPlug/hackformat/sampcomm -i /home/dwilson/SW/SDK/AdobePS/adobe_photoshop_cs5_sdk_mac/photoshopapi/photoshop -i /home/dwilson/SW/SDK/AdobePS/adobe_photoshop_cs5_sdk_mac/photoshopapi/pica_sp -i /Developer/Headers/FlatCarbon -i /home/dwilson/SW/SDK/AdobePS/adobe_photoshop_cs5_sdk_mac/photoshopapi/resources -i /home/dwilson/proj/PSPlug/hackformat/Debug -i /home/dwilson/proj/PSPlug/hackformat/Debug/include -i sampcomm /home/dwilson/proj/PSPlug/hackformat/../../../common/includes/MachOMacrezXcode.h -isysroot /Developer/SDKs/MacOSX10.5.sdk /home/dwilson/proj/PSPlug/hackformat/HackFormat.r

### /Developer/Tools/Rez - SysError 0 during open of "/home/dwilson/proj/PSPlug/hackformat/../../../common/includes/MachOMacrezXcode.h".
Fatal Error!
### /Developer/Tools/Rez - Fatal Error, can't recover.
/home/dwilson/proj/PSPlug/hackformat/../../../common/includes/MachOMacrezXcode.h: ### /Developer/Tools/Rez - Since errors occurred, /home/dwilson/proj/PSPlug/hackformat/tmp/hackformat.build/Debug/HackFormat.build/ResourceManagerResources/Objects/HackFormat-A69F02213383561.rsrc's resource fork was not written.
Command /Developer/Tools/Rez failed with exit code 3

Answer 1

I have found the problem! In Project Setting, there was a bad path in Rez Prefix File. It’s supposed to be a path to a file MachOMacrezXcode.h. Now it is obvious that this file wasn’t being found when I look at the Build Results. I have copied this file into my project source (since I want no dependencies on the original sample code I’m taking source from) and fixed the path.