The principle is as follows: after selecting a file, the application displays in the RSRC FILE WINDOW, the first resource available which type is the last specified (the default is CODE), and in dump or dissasemblage mode (the default is dump). If some symbols are available you can find them in the SYMBOLS WINDOW.
Then you can view the other resources by specifying their IDs (see Resource Table item in the Rsrc menu for the list of the available resources).
Each resource is shown by block of 512 bytes in dump mode, and by block of roughly 128 bytes otherwise. The vertical scrolling bar allows you to view the hidden part of the current block (the screen is generaly too short to display the entire block), whereas the horizontal scrolling bar allows you to view the other blocks of the current resource.
To patch into a resource, use the Pach Mode item in the Rsrc menu, and valid your modifications with the Write Block item. If you have made a mistake, the Restore Block item may be used.
Note: If you have modified the current block and you decide to quit the application or change the current block (there are many way to do this, see menu descriptions), all the modifications are lost. However if you have saved them, a dialog box appears asking you if you really want the changes to be permanent.
You can also save or print disassembled or dumped resources. This process can be cancelled at any time.
The other capabilities of this application are described menu by menu, in the next pages.
ÑÑ THE ASSEMBLER
================
In order to simplify the lines acquisition to be assembled, some useful features are provided:
Ñ When you are in the mnemo zone, and you press the tab key, the cursor is moved at the beginning of the operands zone, and the characters between the old cursor location and the new one are replaced with white spaces.
Ñ When you are in the operands zone, and you press the return key, the cursor is moved at the beginning of the mnemo zone of the next line, and the end of the previous line is filled with white spaces.
The symbol zone can be filled with the following symbols:
:w start write-assembly at the corresponding address.
:c start check-assembly mode.
: end assembly (either mode).
=w write-assembly mode, one line.
=c check-assembly mode, one line.
@i label definition.
If you mix:w and:c symbols, the last one will determine the mode (check or write).
There are a maximum of 10 labels available: @1, @2, ╔, @9.
The DC instruction can be used with the .B, .W or .L suffix. When .B is used, If the number of characters is odd, the assembler adds a 0 at the end of the sequence, to be word boundary.
The operands zone contains the standard MC680xx operands. BE CAREFUL: no white space are authorized between the operands. If you insert even one, the parser will fail.
Note: complex expressions with a combination of +, -, * and / signs are not implemented yet.
Available instructions are:
Inst B W L Operands
--------------------------------
ABCD x Dy,Dx
-(Ay),-(Ax)
ADDA x x ea,An
ADDI x x x #expr4,ea
ADDQ x x x #[1..8],ea
ADD x x x ea <-> Dn
ADDX x x x Dy,Dx
-(Ay),-(Ax)
ANDI x x x #expr4,ea
AND x x x ea <-> Dn
ASd x x x Dx,Dy
#expr4,Dy
ea
Bcc x S x *expr3
BCHG x x Dn,ea
#data,ea
BCLR x x Dn,ea
#data,ea
BFCHG ea,{#offset or Dn1:#width or Dn2}
BFCLR ea,{#offset or Dn1:#width or Dn2}
BFEXTS ea,{#offset or Dn1:#width or Dn2},Dn3
BFEXTU ea,{#offset or Dn1:#width or Dn2},Dn3
BFFFO ea,{#offset or Dn1:#width or Dn2},Dn3
BFINS ea,{#offset or Dn1:#width or Dn2}
BFSET ea,{#offset or Dn1:#width or Dn2}
BFTST ea,{#offset or Dn1:#width or Dn2}
BKPT #vector
BRA x S x *expr3
BSR x S x *expr3
BSET x x Dn,ea
#data,ea
BTST x x Dn,ea
#data,ea
CAS2 x x Dc1:Dc2,Du1:Du2,Rn1:Rn2
CAS x Dc,Du,ea
CALLM #data,ea
CHK2 x x x ea,Rn
CHK x x ea,Rn
CLR x x x ea
CMP2 x x x ea,Rn
CMPA x x ea,An
CMPI x x x #expr4,ea
CMP x x x ea,Dn
CMPM x x x (Ay)+,(Ax)+
DBcc2 x Dn,*expr3
DIVx x x ea,Dn
ea,Dr:Dq
DIVxL3 x ea,Dr:Dq
EORI x x x #expr3,ea
EOR x x x Dn,ea
EXG x Dx,Dy
Ax,Ay
Dx,Ay
EXT x x
EXTB x
ILLEGAL
JMP *expr3
JSR *expr3
LEA x ea,An
LINK x x An,#expr4
LSd1 x x x Dx,Dy
#expr4,Dy
ea
MOVE x x x ea,ea
MOVEA x x ea,An
MOVEM x x <D0-D7/A0-A7> <-> ea
MOVEQ x #data,Dn
MOVES x x x ea <-> Dn
MULx3 x x ea,Dn
ea,Dh:Dl
NBCD x ea
NEG x x x ea
NEGX x x x ea
NOP
NOT x x x ea
OR x x x ea <-> Dn
ORI x x x #expr4,ea
PACK -(Ax),-(Ay),#adjust
Dx,Dy,#adjust
PEA x ea
RESET
ROd1 x x x Dx,Dy
#data,Dy
ea
ROXd1 x x x Dx,Dy
#data,Dy
ea
RTD #displacement
RTE
RTM
RTR
RTS
SBCD x Dx,Dy
-(Ax),-(Ay)
Scc2 x ea
STOP #data
SUBA x x ea,An
SUB x x x ea <-> Dn
SUBI x x x #expr4,ea
SUBQ x x x #data,ea
SUBX x x x Dx,Dy
-(Ax),-(Ay)
SWAP x Dn
TAS x ea
TRAP #vector
TRAPcc2 x x #data
TRAPV
TST x x x ea
UNLK An
UNPK -(Ax),-(Ay),#adjust
Dx,Dy,#adjust
(1) 'd' = R or L
(2) 'cc' = [CCCSEQGEGTHILELSLTMINEPLVCVS]
(3) 'x' = S or U
If the assembly process fails, on each line where an error was detected, a rather obscur message is displayed. We give their meaning in the following lines:
BAD mnemo : The mnemonic you enter is not a valid one.
BAD operand: One or more operands is (are) wrong.
BAD lab val: If not in the range 0..9, or is a name.
LAB exists : Once defined, a label can╒t redeclare it.
BAD lab ref: Try to reference a label not defined yet.
BAD pc rel : rsrc ID is wrong, or disp. is out of range.
BAD address: The address you give is not valid.
BAD asm sym: The symbol you enter is not valid.
ADD not set: You try to define a label out of a :: pairs.
BAD trap : Obvious.
BAD assoc : No match between the mnemonic and the operands.
INS ignored: For instructions are thar not implemented.
OPE is out : For an operand out of range.
ÑÑ WARRANTY
===========
No warranty, expressed or implied, is provided with RSC_Viewer. If you find a bug, let me know and I╒ll fix it.
Since this application manipulates resources, you can easily corrupt them. Thus, when using it, be careful to work on files copy. Otherwise, I am not responsible for any incidental or consequential losses resulting from its use or misuse.
ÑÑ BUG REPORTS
==============
Any questions or bug reports can be sent to the author at the following network address:
iron@imag.fr
ÑÑ FILE MENU DESCRIPTION
========================
Ñ Open file
-----------
Presents a Standard File package box. The files which are listed have all a Type and a Creator specified in the filter dialog box (see Filter item). The default is APPL for Type and nothing for Creator.
The Filter╔ button presents a dialog box, in which you can specify a "File Type" and a "File Creator" for the filter procedure used by the Standard File Package. If you want any kind of "File Type", or "File Creator", put a blank or ???? value. In addition, you can choose the type of the resource you want to study.
Ñ Close
-------
Closes the front window (which can belong to the application or to a Desk Accesory).
Ñ Get File Rsrc List
--------------------
Presents a Standard File Package dialog box (with the same filter procedure as in Open item). Once you have chosen a file, a dialog box appears, displaying the list of all the resources available in that file.
You can choose a specific resource by selecting it and double-clicking in the list-window or by writing its name directly in the edit box (don't forget a resource type is four bytes long). The selected resource becomes the current File resource (see Filter dialog box).
Then the application opens the file and loads the required resources.
Ñ Get File Info
---------------
Shows the main attributes (file creator, file type, etc) about the file you study. You are allowed to modify them. These attributs are System 7 compatible.
Ñ Get Rsrc List for this File
-----------------------------
Same as Get File Rsrc List item.
Ñ Get Info For This File
------------------------
Same as Get File Info item. However you cannot modify them (the save button is disabled).
Ñ Save Block
------------
Saves the current dumped or disassembled block. The first time you use this item, a standard file package box proposes a file name (<file name>.RSRC.Samp). Then, each time you save an other block, it is appended to that file. This item may be very useful if you need only to retrieve some pieces of resource(s).
Ñ Save resource
---------------
Saves the dumped or disassembled resource. The default mode is save current resource. You can change this mode by selecting the Option item in the Misc menu.
Each time you use this item, a standard file package box asks for a file name, which will contain the dumped or disassembled resource(s) specified by the Option item.
The name of the save file is the concatenation of the current file and a suffix which characterize the set of resources saved:
<file name>.<ResType>.<id> for an unique resource. <file name>.<ResType>.List for a list of rsrcs of the given type. <file name>.<ResType>.All if all the rsrcs of the given type are saved.
Ñ Save Resource As Text
-----------------------
Saves the resource without formatting it. You can only save resources that do not belong to the ╘FSYM╒ resource i.e. resources that do not contain instructions. This item is really useful if you want to save the entire content of a ╘STR#╒ resources for example. It is an extension of the Copy As Text item in the menu Edit (see Edit Menu description for more information).
Ñ Preferences
-------------
This item allows the user to save:
Ñ The application╒s different windows current locations,
Ñ The default File Type and File Creator
Ñ The default resource type to load and its default mode.
Ñ Must the Standard File Package dialog box be open at startup ?
This setting will be take into account the next time you launch the RSC Viewer application.
Depending on what you set or unset the effects are very different:
Ñ If you activate the checkbox of a window (see dialog box below), its current location is saved when you choose OK. Otherwise its default location is saved. Of course, when you open again RSC_Viewer, each window is displayed (if visible) at its saved location.
Ñ The Default button restores the default position for all the windows (very useful when you switch from a Mac II to a Mac SE screen for exemple), the default File Type i.e. APPL, the default file Creator (none), the default resource type i.e. CODE, and the default mode i.e. dump.
Ñ Background Setting
---------------------
As you can open up to nine windows, it is sometimes desirable to close those cumbersome windows that hide your screen, when you switch from RSC Viewer to an other application (under Multifinder).
However, it is also a good idea to keep at least one window visible, to quickly return to the RSC Viewer application.
This item allows you to configure the way your different windows will react to a context switch.
You can choose to hide all the windows on suspend event or all but the main one (the RSRC FILE WINDOW). The default setting is ╥save all but the main one╙. If you do not want to hide the windows, click into the corresponding check box.
Ñ Print
-------
by default, prints the entire current resource. You can change this default mode by using the Option item which allows you to specify which resource(s) and within which addresses range you want to print. It is possible to cancel a printing operation (default is the Cmd - ╒;╒ sequence, see the USEFUL FEATURES chapter if you want to change it).
Ñ Page set up
-------------
Classic╔
Ñ Quit
------
Leaves the application.
ÑÑ EDIT MENU DESCRIPTION
========================
Only copy operations are possible in RSC_Viewer i.e. Cut and Paste operation won╒t work.
However the Cmd-C/V/X mechanism is fully available in dialogs (thus, for example, you can copy a trap name from the OS TRAPS WINDOW, and paste it in the find dialog box).
Ñ Undo
------
Not implemented yet ! (in fact will never be implemented╔).
Ñ Cut
-----
You are not allowed to cut any pieces of resources.
Ñ Copy
------
Nothing special to say.
Ñ Paste
-------
You are not allowed to paste anything into a resource. It is mostly for safety purpose (patching a resource is sufficiently dangerous not to introduce anymore problems) and data consistency purpose (for example it is difficult to prevent pasting some ASCII text fragments into the hexadecimal zone of a dumped resource).
Ñ Select All
------------
Selects the content of the entire window. For the RSRC FILE WINDOW only the content of the current block is selected.
Ñ Copy As Text
--------------
As in dump mode, you get both hexadecimal and ASCII values, it is sometimes preferable to retrieve only the ASCII part (think about ╘STR#╒, or ╘STR ╒ resources for example).
The only restriction is that, whatever you select, the minimum you can copy is 16 bytes (i.e. the ASCII part of a line). Thus, in short, selecting even any one byte of a line, selects in fact the whole ASCII part of that line.
Ñ Switch Zone
-------------
If the cursor is in the hexadecimal part of a dumped line, then it goes to its corresponding position in the ASCII part (and vice versa in the ASCII part). Seems very useful╔
ÑÑ RSRC MENU DESCRIPTION
========================
Ñ Resource Table
----------------
Shows the list of all resources of a given type present in the file. For each resource its ID, its SIZE (in decimal) and its NAME (if available) is displayed. There is also a summary which gives the total number of available resources and their total sizes. If you want to view a particular resource, you can select it directly by simply double-clicking the corresponding line. In addition you can choose in which mode you want to see it (dumped or disassembled).
When the resource is of type CODE, this option shows the main entry point of the application. Unfortunately, some jump tables are not standard, and in which case it is impossible to give the correct entry point. You can however find it, by disassembling the jump table at address $00000010.
Ñ Show Current Rsrc
-------------------
Allows the window which contains the current resource (FILE RSRC WINDOW) to become the front window.
Ñ Symbol Table
--------------
Allows the window which contains the list of symbol names (SYMBOLS WINDOW) to become the front window. If the window is not visible, then it is first displayed.
Ñ Get Attributes
----------------
Displays the attributes of the current resource. It is possible to modify all items but the resChanged and resInHeap attributes (for obvious reasons). If you set the resProtected bit on and if you have modified the current block, you won╒t be authorized to save it. In addition, if you are in Pach Mode, this mode becomes disabled.
Ñ Change Resource
-----------------
Changes the current resource ID. You can enter the resource ID in hexadecimal (HexVal checkbox active), or in decimal (HexVal checkbox inactive). In addition, you can choose to disassemble the resource (Dump checkbox inactive) or to dump it (Dump checkbox active).
For more convenience, it is also possible to change the default address where the application jumps for a new resource.
If the current block has been modified and saved, the following dialog box is displayed:
If you choose OK, you change the current resource (so the modifications are permanent, and the Restore Block item is disabled), otherwise you remain in the same resource, and you still have the possibility to use the Restore Block item.
This dialog box will appear as soon as you decide to leave a block that is modified and saved. The actions that can trigger this dialog are: changing the current address (menu com-mands, click in the horizontal scroll bar), changing the current resource (id), switching from dump mode to disassemblage mode, and leaving the application.
Ñ Change Address
----------------
Use it, when you want to select a new address within the current resource.
The behaviour of this dialog is the same as in change resource item.
Ñ Dump mode
-----------
Allows you to switch between dump and disassemblage mode within the current resource.
Ñ Patch mode
------------
Enters/leaves the patch mode, which allows you to write into resources. Be careful...
If patching is allowed, a ** Patch ** menu appears (it is an empty one and it is only for information purpose).
Ñ Write block
-------------
Writes the current block into the current resource.
Note: if you change the current block or the current resource before saving it, all the modifications are lost i.e. the resource is not changed.
Ñ Restore Block
---------------
Restores the old values (those before the write operation).
ÑÑ MISC MENU DESCRIPTION
========================
Ñ Options
---------
Allows you to change the default mode for finding strings and printring or saving resour-ces. You can select the addresses range, and the resource IDs range (of course, resource IDs must be valid ones).
The Default button restores the default values i.e. actions occur within the current resource, from its beginning to its end. Note: Each time you select a new resource, the options are set to their default values.
Ñ Magic Return
--------------
Each time you call Change resource, Change address or each time you select an address or a symbol by double-clicking, the previous address (offset[rsrc number]) is recorded in a LIFO stack.
This stack is able to store ten different addresses. Thus choosing Magic Return allow you to return to previous addresses within the limit of the ten stored adresses in the stack.
This item is very useful when there is a JSR instruction somewhere in a resource and you want to see the corresponding code, but you don't want to loose the address where the JSR was.
Ñ Mini Calc
-----------
Emulates a mini calculator in hexadecimal and/or decimal mode. This calculator is word or long-word oriented (a byte is interpreted as a word). The available operators are:
The = operator is useful to convert number (decimal to hexadecimal or hexadecimal to decimal conversion).
Ñ Show Global Variables
-----------------------
Allows the window which contains the list of global variables (GLOBAL VARIABLES WINDOW) to become the front window. If the window is not visible, then it is first displayed.
If you want to view a low memory address, you can do it simply by pressing the command key and double-clicking on the address part ($xxx:size).
Ñ Show Toolbox Traps
--------------------
Allows the window which contains the list of toolbox traps (TOOLBOX TRAPS WINDOW) to become the front window. If the window is not visible, then it is first displayed.
Ñ Show OS Traps
---------------
Allows the window which contains the list of OS traps (OS TRAPS WINDOW) to become the front window. If the window is not visible, then it is first displayed.
Ñ Available Memory
------------------
Allows the window which contains the value (in Kbytes) of the free memory (AVAI-LABLE MEMORY WINDOW) to become the front window. If the window is not visible, then it is first displayed.
ÑÑ SEARCH MENU DESCRIPTION
==========================
Ñ String
--------
If you choose the ASCII checkbox, the string is interpreted as an ASCII one, otherwise it is interpreted as an hexadecimal value, and in that case, you can find a word (two bytes) or a long (four bytes).
Ñ Trap
------
Trap name search (always in ASCII mode). It is possible to search for a trap with some bits set (bit 9 and 10 for OS-traps and bit 10 for TB-traps, see examples).
As soon as a search string or a trap string is defined, this item becomes available. But if you change the current window, it is disabled since the search parameters are no longer valid.
ÑÑ MC680XX MENU DESCRIPTION
===========================
Ñ Show Format
-------------
Allows the window which contains the 680xx format to become the front window. If the window is not visible, then it is first displayed.
This panel is very useful, if you want to build an instruction on the fly (good luck!). Assuming you know its internal representation, see Codeop window for some examples.
Ñ Show Operation
----------------
Allows the window which contains the 680xx operation to become the front window. If the window is not visible, then it is first displayed.
Ñ Show Codeop
-------------
Allows the window which contains some 68000 instructions to become the front window. If the window is not visible, then it is first displayed. Update it if you need.
