/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* The contents of this file are subject to the Netscape Public License * Version 1.1 (the "License"); you may not use this file except in * compliance with the License. You may obtain a copy of the License at * http://www.mozilla.org/NPL/ * * Software distributed under the License is distributed on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License * for the specific language governing rights and limitations under the * License. * * The Original Code is Mozilla Communicator client code, released March * 31, 1998. * * The Initial Developer of the Original Code is Netscape Communications * Corporation. Portions created by Netscape are Copyright (C) 1999 * Netscape Communications Corporation. All Rights Reserved. * * Contributors: * Samir Gehani */ /*----------------------------------------------------------------------* * Implements a simple AppleSingle decoder, as described in RFC1740 * http://andrew2.andrew.cmu.edu/rfc/rfc1740.html *----------------------------------------------------------------------*/ #ifndef macintosh #error Sorry! This is Mac only functionality! #endif #pragma options align=mac68k #ifndef _NS_APPLESINGLEDECODER_H_ #define _NS_APPLESINGLEDECODER_H_ #include #include #include #include /*----------------------------------------------------------------------* * Struct definitions from RFC1740 *----------------------------------------------------------------------*/ typedef struct ASHeader /* header portion of AppleSingle */ { /* AppleSingle = 0x00051600; AppleDouble = 0x00051607 */ UInt32 magicNum; /* internal file type tag */ UInt32 versionNum; /* format version: 2 = 0x00020000 */ UInt8 filler[16]; /* filler, currently all bits 0 */ UInt16 numEntries; /* number of entries which follow */ } ASHeader ; /* ASHeader */ typedef struct ASEntry /* one AppleSingle entry descriptor */ { UInt32 entryID; /* entry type: see list, 0 invalid */ UInt32 entryOffset; /* offset, in octets, from beginning */ /* of file to this entry's data */ UInt32 entryLength; /* length of data in octets */ } ASEntry; /* ASEntry */ typedef struct ASFinderInfo { FInfo ioFlFndrInfo; /* PBGetFileInfo() or PBGetCatInfo() */ FXInfo ioFlXFndrInfo; /* PBGetCatInfo() (HFS only) */ } ASFinderInfo; /* ASFinderInfo */ typedef struct ASMacInfo /* entry ID 10, Macintosh file information */ { UInt8 filler[3]; /* filler, currently all bits 0 */ UInt8 ioFlAttrib; /* PBGetFileInfo() or PBGetCatInfo() */ } ASMacInfo; typedef struct ASFileDates /* entry ID 8, file dates info */ { SInt32 create; /* file creation date/time */ SInt32 modify; /* last modification date/time */ SInt32 backup; /* last backup date/time */ SInt32 access; /* last access date/time */ } ASFileDates; /* ASFileDates */ /* entryID list */ #define AS_DATA 1 /* data fork */ #define AS_RESOURCE 2 /* resource fork */ #define AS_REALNAME 3 /* File's name on home file system */ #define AS_COMMENT 4 /* standard Mac comment */ #define AS_ICONBW 5 /* Mac black & white icon */ #define AS_ICONCOLOR 6 /* Mac color icon */ /* 7 /* not used */ #define AS_FILEDATES 8 /* file dates; create, modify, etc */ #define AS_FINDERINFO 9 /* Mac Finder info & extended info */ #define AS_MACINFO 10 /* Mac file info, attributes, etc */ #define AS_PRODOSINFO 11 /* Pro-DOS file info, attrib., etc */ #define AS_MSDOSINFO 12 /* MS-DOS file info, attributes, etc */ #define AS_AFPNAME 13 /* Short name on AFP server */ #define AS_AFPINFO 14 /* AFP file info, attrib., etc */ #define AS_AFPDIRID 15 /* AFP directory ID */ /*----------------------------------------------------------------------* * Macros *----------------------------------------------------------------------*/ #define MAC_ERR_CHECK(_funcCall) \ err = _funcCall; \ if (err!=noErr) \ return err; class nsAppleSingleDecoder { public: nsAppleSingleDecoder(FSSpec *inSpec, FSSpec *outSpec); nsAppleSingleDecoder(); ~nsAppleSingleDecoder(); /** * Decode * * Takes an "in" FSSpec for the source file in AppleSingle * format to decode and write out to an "out" FSSpec. * This form is used when the Decode(void) method has already * been invoked once and this object is reused to decode * another AppleSingled file: useful in iteration to avoid * nsAppleSingleDecoder object instantiation per file. * * @param inSpec the AppleSingled file to decode * @param outSpec the destination file in which the decoded * data was written out (empty when passed in * and filled on return) * @return err a standard MacOS OSErr where noErr means OK */ OSErr Decode(FSSpec *inSpec, FSSpec *outSpec); /** * Decode * * Decodes the AppleSingled file passed in to the constructor * and writes out the decoded data to the outSpec passed to the * constructor. * * @return err a standard MacOS OSErr where noErr = OK */ OSErr Decode(); /** * DecodeFolder * * Traverses arbitrarily nested subdirs decoding any files * in AppleSingle format and leaving other files alone. * * @param aFolder the folder whose contents to decode * @return err a standard MacOS err (dirNFErr if invalid dir, noErr = OK) */ OSErr DecodeFolder(FSSpec *aFolder); /** * IsAppleSingleFile * * Checks the file header to see whether this is an AppleSingle * version 2 file by matching the magicNum field in the header. * * @param inSpec the file to check * @return bAppleSingle a Boolean where true indicates this is * in fact an AppleSingle file */ static Boolean IsAppleSingleFile(FSSpec *inSpec); /** * String utilities to ensure building standalone * since Mozilla doesn't use PLStringFuncs. */ static StringPtr PLstrncpy(StringPtr dst, ConstStr255Param src, short max); static StringPtr PLstrncat(StringPtr dst, ConstStr255Param src, short max); static Boolean PLstrcmp(StringPtr str1, StringPtr str2); /** * ltoa -- long to ascii * * Converts a long to a C string. We allocate * a string of the appropriate size and the caller * should assume ownership of the returned pointer. */ static char *ltoa(long n); private: FSSpec *mInSpec; FSSpec *mOutSpec; short mInRefNum; // cache since it's used through the life of one Decode cycle Boolean mRenameReqd; OSErr ProcessASEntry(ASEntry inEntry); OSErr ProcessDataFork(ASEntry inEntry); OSErr ProcessResourceFork(ASEntry inEntry); OSErr ProcessRealName(ASEntry inEntry); OSErr ProcessFileDates(ASEntry inEntry); OSErr ProcessFinderInfo(ASEntry inEntry); OSErr ProcessMacInfo(ASEntry inEntry); OSErr EntryToMacFile(ASEntry inEntry, UInt16 inTargetSpecRefNum); OSErr FSMakeUnique(FSSpec *ioSpec); }; #ifdef __cplusplus extern "C" { #endif OSErr DTSetAPPL(Str255 volName,short vRefNum,OSType creator,long applParID,Str255 applName); pascal void DecodeDirIterateFilter(const CInfoPBRec * const cpbPtr, Boolean *quitFlag, void *yourDataPtr); #ifdef __cplusplus } #endif #pragma options align=reset #endif /* _NS_APPLESINGLEDECODER_H_ */