home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progasm / sprcbnch.arj / USERMAN.TEX < prev   
LaTeX Document  |  1992-03-30  |  15.2 KB

open in: MacOS 8.1     |     Win98     |     DOS

view JSON data     |     view as text

This file was processed as: LaTeX Document (document/latex).

You can browse this item here: USERMAN.TEX

ConfidenceProgramDetectionMatch TypeSupport
100% dexvert LaTeX Document (document/latex) magic Supported
1% dexvert Corel 10 Texture (image/corel10Texture) ext Unsupported
1% dexvert Croteam texture file (image/croteamTextureFile) ext Unsupported
1% dexvert Text File (text/txt) fallback Supported
100% file LaTeX document text default
99% file assembler source, ASCII text, with CRLF line terminators default (weak)
100% checkBytes Printable ASCII default
100% perlTextCheck Likely Text (Perl) default
100% siegfried fmt/281 LaTeX (Subdocument) default
100% detectItEasy Format: plain text[CRLF] default (weak)



hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 64 6f 63 75 6d 65 6e | 74 73 74 79 6c 65 7b 72 |\documen|tstyle{r|
|00000010| 65 70 6f 72 74 7d 0d 0a | 5c 74 69 74 6c 65 7b 53 |eport}..|\title{S|
|00000020| 50 41 52 43 42 65 6e 63 | 68 20 55 73 65 72 27 73 |PARCBenc|h User's|
|00000030| 20 4d 61 6e 75 61 6c 7d | 0d 0a 5c 61 75 74 68 6f | Manual}|..\autho|
|00000040| 72 7b 5c 63 6f 70 79 72 | 69 67 68 74 20 45 6c 65 |r{\copyr|ight Ele|
|00000050| 63 74 72 6f 6e 65 74 69 | 63 73 2c 20 49 6e 63 2e |ctroneti|cs, Inc.|
|00000060| 20 31 39 39 32 7d 0d 0a | 5c 64 61 74 65 7b 31 20 | 1992}..|\date{1 |
|00000070| 46 65 62 72 75 61 72 79 | 20 31 39 39 32 7d 0d 0a |February| 1992}..|
|00000080| 5c 62 65 67 69 6e 7b 64 | 6f 63 75 6d 65 6e 74 7d |\begin{d|ocument}|
|00000090| 0d 0a 5c 6d 61 6b 65 74 | 69 74 6c 65 0d 0a 5c 73 |..\maket|itle..\s|
|000000a0| 65 63 74 69 6f 6e 2a 7b | 49 6e 74 72 6f 64 75 63 |ection*{|Introduc|
|000000b0| 74 69 6f 6e 7d 0d 0a 0d | 0a 54 68 65 20 53 50 41 |tion}...|.The SPA|
|000000c0| 52 43 42 65 6e 63 68 20 | 70 61 63 6b 61 67 65 20 |RCBench |package |
|000000d0| 63 6f 6e 73 69 73 74 73 | 20 6f 66 20 61 20 53 50 |consists| of a SP|
|000000e0| 41 52 43 24 5e 7b 54 4d | 7d 24 20 63 72 6f 73 73 |ARC$^{TM|}$ cross|
|000000f0| 2d 61 73 73 65 6d 62 6c | 65 72 0d 0a 28 73 61 73 |-assembl|er..(sas|
|00000100| 6d 29 2c 20 75 73 65 72 | 2d 63 6f 64 65 20 73 69 |m), user|-code si|
|00000110| 6d 75 6c 61 74 6f 72 20 | 28 73 73 69 6d 29 2c 20 |mulator |(ssim), |
|00000120| 61 6e 64 20 61 20 64 69 | 73 61 73 73 65 6d 62 6c |and a di|sassembl|
|00000130| 65 72 20 28 64 69 73 29 | 2c 20 61 6c 6c 20 6f 66 |er (dis)|, all of|
|00000140| 0d 0a 77 68 69 63 68 20 | 72 75 6e 20 75 6e 64 65 |..which |run unde|
|00000150| 72 20 4d 53 44 4f 53 2e | 20 20 54 68 65 73 65 20 |r MSDOS.| These |
|00000160| 74 6f 6f 6c 73 20 61 72 | 65 20 62 61 73 65 64 20 |tools ar|e based |
|00000170| 75 70 6f 6e 20 56 65 72 | 73 69 6f 6e 20 37 20 6f |upon Ver|sion 7 o|
|00000180| 66 20 74 68 65 0d 0a 53 | 50 41 52 43 20 41 72 63 |f the..S|PARC Arc|
|00000190| 68 69 74 65 63 74 75 72 | 65 20 4d 61 6e 75 61 6c |hitectur|e Manual|
|000001a0| 2e 0d 0a 0d 0a 53 73 69 | 6d 20 61 74 74 65 6d 70 |.....Ssi|m attemp|
|000001b0| 74 73 20 74 6f 20 73 69 | 6d 75 6c 61 74 65 20 74 |ts to si|mulate t|
|000001c0| 68 65 20 75 73 65 72 2d | 63 6f 64 65 20 69 6e 73 |he user-|code ins|
|000001d0| 74 72 75 63 74 69 6f 6e | 20 73 65 74 20 6f 66 20 |truction| set of |
|000001e0| 74 68 65 20 53 50 41 52 | 43 0d 0a 63 70 75 20 61 |the SPAR|C..cpu a|
|000001f0| 73 20 72 75 6e 20 75 6e | 64 65 72 20 53 75 6e 4f |s run un|der SunO|
|00000200| 53 2e 20 20 49 74 20 6d | 61 6b 65 73 20 6e 6f 20 |S. It m|akes no |
|00000210| 65 66 66 6f 72 74 20 74 | 6f 20 73 69 6d 75 6c 61 |effort t|o simula|
|00000220| 74 65 20 70 72 69 76 6c | 65 67 65 64 0d 0a 28 6b |te privl|eged..(k|
|00000230| 65 72 6e 65 6c 20 6d 6f | 64 65 29 20 69 6e 73 74 |ernel mo|de) inst|
|00000240| 72 75 63 74 69 6f 6e 73 | 2e 20 20 49 74 20 61 6c |ructions|. It al|
|00000250| 73 6f 20 66 75 6e 63 74 | 69 6f 6e 73 20 63 6f 6d |so funct|ions com|
|00000260| 70 6c 65 74 65 6c 79 20 | 77 69 74 68 69 6e 20 74 |pletely |within t|
|00000270| 68 65 0d 0a 6c 69 6d 69 | 74 73 20 6f 66 20 4d 53 |he..limi|ts of MS|
|00000280| 44 4f 53 2e 20 20 54 68 | 69 73 20 6d 65 61 6e 73 |DOS. Th|is means|
|00000290| 20 74 68 61 74 20 6d 61 | 6e 79 20 73 79 73 74 65 | that ma|ny syste|
|000002a0| 6d 20 63 61 6c 6c 73 20 | 28 70 61 72 74 69 63 75 |m calls |(particu|
|000002b0| 6c 61 72 6c 79 0d 0a 74 | 68 6f 73 65 20 64 65 61 |larly..t|hose dea|
|000002c0| 6c 69 6e 67 20 77 69 74 | 68 20 6d 75 6c 74 69 70 |ling wit|h multip|
|000002d0| 72 6f 63 65 73 73 69 6e | 67 20 61 6e 64 20 6e 65 |rocessin|g and ne|
|000002e0| 74 77 6f 72 6b 69 6e 67 | 29 20 65 69 74 68 65 72 |tworking|) either|
|000002f0| 20 72 65 74 75 72 6e 0d | 0a 45 4e 4f 53 59 53 20 | return.|.ENOSYS |
|00000300| 28 6e 6f 74 20 69 6d 70 | 6c 65 6d 65 6e 74 65 64 |(not imp|lemented|
|00000310| 29 20 6f 72 20 45 49 4e | 56 41 4c 20 28 69 6e 76 |) or EIN|VAL (inv|
|00000320| 61 6c 69 64 29 2e 0d 0a | 0d 0a 53 73 69 6d 20 69 |alid)...|..Ssim i|
|00000330| 73 20 7b 5c 62 66 20 6e | 6f 74 7d 20 69 6e 74 65 |s {\bf n|ot} inte|
|00000340| 6e 64 65 64 20 61 73 20 | 61 20 76 65 68 69 63 6c |nded as |a vehicl|
|00000350| 65 20 74 6f 20 73 69 6d | 75 6c 61 74 65 20 6c 61 |e to sim|ulate la|
|00000360| 72 67 65 20 53 50 41 52 | 43 20 62 69 6e 61 72 69 |rge SPAR|C binari|
|00000370| 65 73 2e 0d 0a 46 69 72 | 73 74 2c 20 74 68 65 20 |es...Fir|st, the |
|00000380| 70 65 72 66 6f 72 6d 61 | 6e 63 65 20 77 6f 75 6c |performa|nce woul|
|00000390| 64 20 62 65 20 6d 69 73 | 65 72 61 62 6c 65 2e 20 |d be mis|erable. |
|000003a0| 20 4f 6e 20 61 20 31 30 | 4d 68 7a 20 38 30 38 36 | On a 10|Mhz 8086|
|000003b0| 20 6c 61 70 74 6f 70 2c | 0d 0a 62 65 74 77 65 65 | laptop,|..betwee|
|000003c0| 6e 20 31 30 30 30 20 61 | 6e 64 20 32 30 30 30 20 |n 1000 a|nd 2000 |
|000003d0| 53 50 41 52 43 20 69 6e | 73 74 72 75 63 74 69 6f |SPARC in|structio|
|000003e0| 6e 73 20 70 65 72 20 73 | 65 63 6f 6e 64 20 61 72 |ns per s|econd ar|
|000003f0| 65 20 73 69 6d 75 6c 61 | 74 65 64 2e 0d 0a 53 65 |e simula|ted...Se|
|00000400| 63 6f 6e 64 6c 79 2c 20 | 74 68 65 20 6d 69 73 73 |condly, |the miss|
|00000410| 69 6e 67 20 73 79 73 74 | 65 6d 20 63 61 6c 6c 20 |ing syst|em call |
|00000420| 66 75 6e 63 74 69 6f 6e | 61 6c 69 74 79 20 6d 65 |function|ality me|
|00000430| 6e 74 69 6f 6e 65 64 20 | 70 72 65 76 69 6f 75 73 |ntioned |previous|
|00000440| 6c 79 0d 0a 70 72 65 63 | 6c 75 64 65 73 20 72 75 |ly..prec|ludes ru|
|00000450| 6e 6e 69 6e 67 20 6a 75 | 73 74 20 61 62 6f 75 74 |nning ju|st about|
|00000460| 20 61 6e 79 20 6c 61 72 | 67 65 20 28 61 6e 64 20 | any lar|ge (and |
|00000470| 6d 61 6e 79 20 73 6d 61 | 6c 6c 29 20 53 50 41 52 |many sma|ll) SPAR|
|00000480| 43 20 62 69 6e 61 72 69 | 65 73 2e 0d 0a 0d 0a 53 |C binari|es.....S|
|00000490| 6f 2c 20 77 68 61 74 20 | 67 6f 6f 64 20 69 73 20 |o, what |good is |
|000004a0| 73 73 69 6d 3f 20 20 49 | 74 20 69 73 20 6d 61 69 |ssim? I|t is mai|
|000004b0| 6e 6c 79 20 69 6e 74 65 | 6e 64 65 64 20 66 6f 72 |nly inte|nded for|
|000004c0| 20 74 68 6f 73 65 20 77 | 69 73 68 69 6e 67 20 74 | those w|ishing t|
|000004d0| 6f 0d 0a 6c 65 61 72 6e | 20 74 68 65 20 53 50 41 |o..learn| the SPA|
|000004e0| 52 43 20 69 6e 73 74 72 | 75 63 74 69 6f 6e 20 73 |RC instr|uction s|
|000004f0| 65 74 20 61 73 20 61 6e | 20 61 73 73 65 6d 62 6c |et as an| assembl|
|00000500| 79 20 6c 61 6e 67 75 61 | 67 65 2e 20 20 54 68 65 |y langua|ge. The|
|00000510| 20 53 50 41 52 43 0d 0a | 69 6e 73 74 72 75 63 74 | SPARC..|instruct|
|00000520| 69 6f 6e 20 73 65 74 20 | 69 73 20 73 6d 61 6c 6c |ion set |is small|
|00000530| 2c 20 72 65 67 75 6c 61 | 72 20 61 6e 64 20 68 61 |, regula|r and ha|
|00000540| 73 20 6f 74 68 65 72 20 | 52 49 53 43 2d 6c 69 6b |s other |RISC-lik|
|00000550| 65 20 70 72 6f 70 65 72 | 74 69 65 73 2e 0d 0a 53 |e proper|ties...S|
|00000560| 50 41 52 43 20 68 61 72 | 64 77 61 72 65 20 70 72 |PARC har|dware pr|
|00000570| 6f 76 69 64 65 73 20 74 | 68 65 20 62 65 73 74 20 |ovides t|he best |
|00000580| 6d 65 74 68 6f 64 20 66 | 6f 72 20 6c 65 61 72 6e |method f|or learn|
|00000590| 69 6e 67 20 74 68 65 20 | 69 6e 73 74 72 75 63 74 |ing the |instruct|
|000005a0| 69 6f 6e 0d 0a 73 65 74 | 2e 20 20 53 73 69 6d 20 |ion..set|. Ssim |
|000005b0| 61 6c 6c 6f 77 73 20 4d | 53 44 4f 53 20 68 61 72 |allows M|SDOS har|
|000005c0| 64 77 61 72 65 20 74 6f | 20 66 75 6e 63 74 69 6f |dware to| functio|
|000005d0| 6e 20 61 73 20 61 20 73 | 75 62 73 74 69 74 75 74 |n as a s|ubstitut|
|000005e0| 65 2e 20 20 49 74 20 61 | 6c 73 6f 0d 0a 68 61 73 |e. It a|lso..has|
|000005f0| 20 61 20 72 75 64 69 6d | 65 6e 74 61 72 79 20 74 | a rudim|entary t|
|00000600| 72 61 63 69 6e 67 20 63 | 61 70 61 62 69 6c 69 74 |racing c|apabilit|
|00000610| 79 20 74 6f 20 72 65 63 | 6f 72 64 20 61 64 64 72 |y to rec|ord addr|
|00000620| 65 73 73 65 73 20 6f 66 | 20 63 6f 64 65 0d 0a 65 |esses of| code..e|
|00000630| 78 65 63 75 74 69 6f 6e | 20 61 6e 64 20 64 61 74 |xecution| and dat|
|00000640| 61 20 72 65 61 64 2f 77 | 72 69 74 65 2e 0d 0a 0d |a read/w|rite....|
|00000650| 0a 41 20 63 72 6f 73 73 | 20 61 73 73 65 6d 62 6c |.A cross| assembl|
|00000660| 65 72 20 28 73 61 73 6d | 29 20 69 73 20 69 6e 63 |er (sasm|) is inc|
|00000670| 6c 75 64 65 64 20 73 6f | 20 79 6f 75 20 63 61 6e |luded so| you can|
|00000680| 20 77 72 69 74 65 20 79 | 6f 75 72 20 6f 77 6e 20 | write y|our own |
|00000690| 53 50 41 52 43 0d 0a 61 | 73 73 65 6d 62 6c 65 72 |SPARC..a|ssembler|
|000006a0| 20 70 72 6f 67 72 61 6d | 73 20 61 6e 64 20 65 78 | program|s and ex|
|000006b0| 65 63 75 74 65 20 74 68 | 65 6d 20 75 73 69 6e 67 |ecute th|em using|
|000006c0| 20 73 73 69 6d 2e 20 20 | 54 68 65 72 65 20 69 73 | ssim. |There is|
|000006d0| 20 6e 6f 20 6c 69 6e 6b | 65 72 2e 0d 0a 53 69 6e | no link|er...Sin|
|000006e0| 63 65 20 73 73 69 6d 20 | 69 73 20 74 61 72 67 65 |ce ssim |is targe|
|000006f0| 74 65 64 20 66 6f 72 20 | 73 6d 61 6c 6c 20 68 61 |ted for |small ha|
|00000700| 6e 64 2d 77 72 69 74 74 | 65 6e 20 70 72 6f 67 72 |nd-writt|en progr|
|00000710| 61 6d 73 2c 20 73 61 73 | 6d 20 61 73 73 65 6d 62 |ams, sas|m assemb|
|00000720| 6c 65 73 0d 0a 65 6e 74 | 69 72 65 20 63 6f 6d 70 |les..ent|ire comp|
|00000730| 6c 65 74 65 20 70 72 6f | 67 72 61 6d 73 20 64 69 |lete pro|grams di|
|00000740| 72 65 63 74 6c 79 20 69 | 6e 74 6f 20 4e 4d 41 47 |rectly i|nto NMAG|
|00000750| 49 43 20 28 74 6f 20 73 | 61 76 65 20 64 69 73 6b |IC (to s|ave disk|
|00000760| 20 73 70 61 63 65 29 0d | 0a 53 50 41 52 43 20 65 | space).|.SPARC e|
|00000770| 78 65 63 75 74 61 62 6c | 65 73 2e 20 20 53 73 69 |xecutabl|es. Ssi|
|00000780| 6d 20 63 61 6e 20 68 61 | 6e 64 6c 65 20 5a 4d 41 |m can ha|ndle ZMA|
|00000790| 47 49 43 20 66 6f 72 6d | 61 74 20 62 69 6e 61 72 |GIC form|at binar|
|000007a0| 69 65 73 20 61 6c 73 6f | 2c 20 61 73 0d 0a 6c 6f |ies also|, as..lo|
|000007b0| 6e 67 20 61 73 20 74 68 | 65 79 20 61 72 65 20 6c |ng as th|ey are l|
|000007c0| 65 73 73 20 74 68 61 6e | 20 36 34 6b 20 74 6f 74 |ess than| 64k tot|
|000007d0| 61 6c 20 74 65 78 74 20 | 61 6e 64 20 64 61 74 61 |al text |and data|
|000007e0| 20 73 69 7a 65 20 3a 2d | 29 2e 20 20 54 68 65 0d | size :-|). The.|
|000007f0| 0a 6f 75 74 70 75 74 20 | 6f 66 20 73 61 73 6d 20 |.output |of sasm |
|00000800| 77 69 6c 6c 20 69 6e 64 | 65 65 64 20 72 75 6e 20 |will ind|eed run |
|00000810| 6f 6e 20 61 63 74 75 61 | 6c 20 53 50 41 52 43 20 |on actua|l SPARC |
|00000820| 68 61 72 64 77 61 72 65 | 2e 0d 0a 0d 0a 53 73 69 |hardware|.....Ssi|
|00000830| 6d 20 63 6f 6e 74 61 69 | 6e 73 20 61 20 73 69 6d |m contai|ns a sim|
|00000840| 70 6c 65 20 69 6e 74 65 | 72 61 63 74 69 76 65 20 |ple inte|ractive |
|00000850| 64 65 62 75 67 20 65 6e | 76 69 72 6f 6e 6d 65 6e |debug en|vironmen|
|00000860| 74 20 66 6f 72 20 73 74 | 65 70 70 69 6e 67 0d 0a |t for st|epping..|
|00000870| 74 68 72 6f 75 67 68 20 | 53 50 41 52 43 20 63 6f |through |SPARC co|
|00000880| 64 65 20 65 78 65 63 75 | 74 69 6f 6e 2e 20 20 49 |de execu|tion. I|
|00000890| 74 73 20 75 73 65 72 20 | 69 6e 74 65 72 66 61 63 |ts user |interfac|
|000008a0| 65 20 69 73 20 6d 6f 64 | 65 6c 6c 65 64 20 61 66 |e is mod|elled af|
|000008b0| 74 65 72 20 61 0d 0a 73 | 75 62 73 65 74 20 6f 66 |ter a..s|ubset of|
|000008c0| 20 74 68 65 20 47 4e 55 | 20 64 65 62 75 67 67 65 | the GNU| debugge|
|000008d0| 72 20 67 64 62 2e 0d 0a | 0d 0a 5c 73 65 63 74 69 |r gdb...|..\secti|
|000008e0| 6f 6e 2a 7b 49 6e 73 74 | 61 6c 6c 61 74 69 6f 6e |on*{Inst|allation|
|000008f0| 7d 0d 0a 0d 0a 54 68 65 | 20 66 69 6c 65 73 20 69 |}....The| files i|
|00000900| 6e 63 6c 75 64 65 64 20 | 69 6e 20 74 68 69 73 20 |ncluded |in this |
|00000910| 76 65 72 73 69 6f 6e 20 | 6f 66 20 74 68 65 20 53 |version |of the S|
|00000920| 50 41 52 43 62 65 6e 63 | 68 20 74 6f 6f 6c 73 20 |PARCbenc|h tools |
|00000930| 61 72 65 20 6c 69 73 74 | 65 64 0d 0a 69 6e 20 74 |are list|ed..in t|
|00000940| 68 65 20 66 69 6c 65 20 | 46 49 4c 45 4c 49 53 54 |he file |FILELIST|
|00000950| 2e 44 4f 43 2e 20 20 59 | 6f 75 20 73 68 6f 75 6c |.DOC. Y|ou shoul|
|00000960| 64 20 76 65 72 69 66 79 | 20 74 68 61 74 20 79 6f |d verify| that yo|
|00000970| 75 20 68 61 76 65 20 74 | 68 65 20 66 69 6c 65 73 |u have t|he files|
|00000980| 0d 0a 6d 65 6e 74 69 6f | 6e 65 64 20 69 6e 20 74 |..mentio|ned in t|
|00000990| 68 69 73 20 6c 69 73 74 | 2e 0d 0a 0d 0a 41 20 73 |his list|.....A s|
|000009a0| 65 74 20 6f 66 20 63 6f | 6e 66 69 64 65 6e 63 65 |et of co|nfidence|
|000009b0| 20 74 65 73 74 73 20 69 | 73 20 70 72 6f 76 69 64 | tests i|s provid|
|000009c0| 65 64 20 74 6f 20 76 65 | 72 69 66 79 20 70 72 6f |ed to ve|rify pro|
|000009d0| 70 65 72 20 6f 70 65 72 | 61 74 69 6f 6e 20 6f 66 |per oper|ation of|
|000009e0| 0d 0a 73 61 73 6d 20 61 | 6e 64 20 73 73 69 6d 2e |..sasm a|nd ssim.|
|000009f0| 20 20 54 68 65 73 65 20 | 61 72 65 20 72 75 6e 20 | These |are run |
|00000a00| 61 73 20 72 65 67 72 65 | 73 73 69 6f 6e 20 74 65 |as regre|ssion te|
|00000a10| 73 74 73 20 77 68 65 6e | 20 6d 6f 64 69 66 79 69 |sts when| modifyi|
|00000a20| 6e 67 20 6f 72 0d 0a 61 | 64 64 69 6e 67 20 6e 65 |ng or..a|dding ne|
|00000a30| 77 20 63 6f 64 65 2e 20 | 20 59 6f 75 20 6d 61 79 |w code. | You may|
|00000a40| 20 77 69 73 68 20 74 6f | 20 72 75 6e 20 74 68 65 | wish to| run the|
|00000a50| 6d 20 77 68 65 6e 20 73 | 65 74 74 69 6e 67 20 75 |m when s|etting u|
|00000a60| 70 20 74 68 65 0d 0a 53 | 50 41 52 43 62 65 6e 63 |p the..S|PARCbenc|
|00000a70| 68 20 70 61 63 6b 61 67 | 65 2e 20 20 54 6f 20 64 |h packag|e. To d|
|00000a80| 6f 20 73 6f 2c 20 65 78 | 65 63 75 74 65 20 74 68 |o so, ex|ecute th|
|00000a90| 65 20 2e 42 41 54 20 66 | 69 6c 65 20 5c 76 65 72 |e .BAT f|ile \ver|
|00000aa0| 62 2b 43 54 45 53 54 2e | 42 41 54 2b 2e 0d 0a 54 |b+CTEST.|BAT+...T|
|00000ab0| 68 65 20 6f 75 74 70 75 | 74 20 73 68 6f 75 6c 64 |he outpu|t should|
|00000ac0| 20 6d 61 74 63 68 20 74 | 68 65 20 63 6f 6e 74 65 | match t|he conte|
|00000ad0| 6e 74 73 20 6f 66 20 74 | 68 65 20 66 69 6c 65 20 |nts of t|he file |
|00000ae0| 5c 76 65 72 62 2b 45 58 | 50 45 43 54 2e 4f 55 54 |\verb+EX|PECT.OUT|
|00000af0| 2b 2e 0d 0a 0d 0a 5c 73 | 65 63 74 69 6f 6e 2a 7b |+.....\s|ection*{|
|00000b00| 53 41 53 4d 20 43 72 6f | 73 73 2d 61 73 73 65 6d |SASM Cro|ss-assem|
|00000b10| 62 6c 65 72 7d 0d 0a 0d | 0a 53 61 73 6d 20 63 72 |bler}...|.Sasm cr|
|00000b20| 65 61 74 65 73 20 4e 4d | 41 47 49 43 20 53 50 41 |eates NM|AGIC SPA|
|00000b30| 52 43 20 65 78 65 63 75 | 74 61 62 6c 65 73 20 66 |RC execu|tables f|
|00000b40| 72 6f 6d 20 61 73 73 65 | 6d 62 6c 65 72 20 73 6f |rom asse|mbler so|
|00000b50| 75 72 63 65 20 63 6f 64 | 65 2e 20 20 49 74 0d 0a |urce cod|e. It..|
|00000b60| 77 69 6c 6c 20 61 73 73 | 65 6d 62 6c 65 20 6d 6f |will ass|emble mo|
|00000b70| 73 74 20 70 72 69 76 69 | 6c 65 67 65 64 20 69 6e |st privi|leged in|
|00000b80| 73 74 72 75 63 74 69 6f | 6e 73 20 61 73 20 77 65 |structio|ns as we|
|00000b90| 6c 6c 20 61 73 20 6e 6f | 6e 2d 70 72 69 76 69 6c |ll as no|n-privil|
|00000ba0| 65 67 65 64 2e 0d 0a 50 | 72 69 76 69 6c 65 67 65 |eged...P|rivilege|
|00000bb0| 64 20 63 6f 64 65 20 69 | 73 20 6e 6f 74 20 73 75 |d code i|s not su|
|00000bc0| 70 70 6f 72 74 65 64 20 | 69 6e 20 73 73 69 6d 20 |pported |in ssim |
|00000bd0| 61 6e 64 20 77 69 6c 6c | 20 63 61 75 73 65 20 74 |and will| cause t|
|00000be0| 68 65 20 70 72 6f 67 72 | 61 6d 0d 0a 62 65 69 6e |he progr|am..bein|
|00000bf0| 67 20 73 69 6d 75 6c 61 | 74 65 64 20 74 6f 20 72 |g simula|ted to r|
|00000c00| 65 63 65 69 76 65 20 61 | 6e 20 69 6c 6c 65 67 61 |eceive a|n illega|
|00000c10| 6c 20 69 6e 73 74 72 75 | 63 74 69 6f 6e 20 73 69 |l instru|ction si|
|00000c20| 67 6e 61 6c 2e 20 20 43 | 6f 6d 6d 65 6e 74 73 0d |gnal. C|omments.|
|00000c30| 0a 61 72 65 20 65 6e 63 | 6c 6f 73 65 64 20 77 69 |.are enc|losed wi|
|00000c40| 74 68 69 6e 20 2f 2a 20 | 2a 2f 20 64 65 6c 69 6d |thin /* |*/ delim|
|00000c50| 69 74 65 72 73 20 28 43 | 2d 73 74 79 6c 65 29 20 |iters (C|-style) |
|00000c60| 6f 72 20 65 78 74 65 6e | 64 20 66 72 6f 6d 20 61 |or exten|d from a|
|00000c70| 20 0d 0a 7b 5c 66 72 65 | 6e 63 68 73 70 61 63 69 | ..{\fre|nchspaci|
|00000c80| 6e 67 20 21 7d 20 74 6f | 0d 0a 65 6e 64 20 6f 66 |ng !} to|..end of|
|00000c90| 20 6c 69 6e 65 2e 20 20 | 53 69 6e 63 65 20 53 41 | line. |Since SA|
|00000ca0| 53 4d 20 68 61 73 20 6e | 6f 20 63 6f 6e 63 65 70 |SM has n|o concep|
|00000cb0| 74 20 6f 66 20 61 20 70 | 72 6f 67 72 61 6d 20 65 |t of a p|rogram e|
|00000cc0| 78 74 65 6e 64 69 6e 67 | 20 6f 76 65 72 0d 0a 6d |xtending| over..m|
|00000cd0| 75 6c 74 69 70 6c 65 20 | 73 6f 75 72 63 65 20 66 |ultiple |source f|
|00000ce0| 69 6c 65 73 2c 20 61 6c | 6c 20 72 65 66 65 72 65 |iles, al|l refere|
|00000cf0| 6e 63 65 73 20 6d 75 73 | 74 20 62 65 20 72 65 73 |nces mus|t be res|
|00000d00| 6f 6c 76 65 64 20 77 69 | 74 68 69 6e 20 74 68 65 |olved wi|thin the|
|00000d10| 20 66 69 6c 65 0d 0a 62 | 65 69 6e 67 20 61 73 73 | file..b|eing ass|
|00000d20| 65 6d 62 6c 65 64 2e 20 | 20 54 68 65 20 66 6f 6c |embled. | The fol|
|00000d30| 6c 6f 77 69 6e 67 20 70 | 73 65 75 64 6f 2d 6f 70 |lowing p|seudo-op|
|00000d40| 73 20 61 72 65 20 73 75 | 70 70 6f 72 74 65 64 20 |s are su|pported |
|00000d50| 69 6e 20 74 68 65 20 73 | 61 6d 65 0d 0a 66 61 73 |in the s|ame..fas|
|00000d60| 68 69 6f 6e 20 61 73 20 | 74 68 65 20 53 55 4e 34 |hion as |the SUN4|
|00000d70| 20 53 50 41 52 43 20 61 | 73 73 65 6d 62 6c 65 72 | SPARC a|ssembler|
|00000d80| 3a 0d 0a 0d 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |:....\be|gin{verb|
|00000d90| 61 74 69 6d 7d 0d 0a 2e | 61 6c 69 67 6e 20 2d 2d |atim}...|align --|
|00000da0| 20 61 6c 69 67 6e 20 6c | 6f 63 61 74 69 6f 6e 20 | align l|ocation |
|00000db0| 63 6f 75 6e 74 65 72 3b | 20 61 72 67 75 6d 65 6e |counter;| argumen|
|00000dc0| 74 20 69 73 20 32 2c 20 | 34 2c 20 6f 72 20 38 0d |t is 2, |4, or 8.|
|00000dd0| 0a 2e 61 73 63 69 69 20 | 2d 2d 20 47 65 6e 65 72 |..ascii |-- Gener|
|00000de0| 61 74 65 20 31 20 6f 72 | 20 6d 6f 72 65 20 63 6f |ate 1 or| more co|
|00000df0| 6d 6d 61 2d 73 65 70 61 | 72 61 74 65 64 20 73 74 |mma-sepa|rated st|
|00000e00| 72 69 6e 67 73 0d 0a 2e | 61 73 63 69 7a 20 2d 2d |rings...|asciz --|
|00000e10| 20 53 61 6d 65 20 61 73 | 20 2e 61 73 63 69 69 20 | Same as| .ascii |
|00000e20| 62 75 74 20 73 74 72 69 | 6e 67 73 20 61 72 65 20 |but stri|ngs are |
|00000e30| 6e 75 6c 6c 20 74 65 72 | 6d 69 6e 61 74 65 64 0d |null ter|minated.|
|00000e40| 0a 2e 62 79 74 65 20 20 | 2d 2d 20 47 65 6e 65 72 |..byte |-- Gener|
|00000e50| 61 74 65 20 69 6e 69 74 | 69 61 6c 69 7a 65 64 20 |ate init|ialized |
|00000e60| 62 79 74 65 73 2c 20 63 | 6f 6d 6d 61 20 73 65 70 |bytes, c|omma sep|
|00000e70| 61 72 61 74 65 64 0d 0a | 2e 68 61 6c 66 20 20 2d |arated..|.half -|
|00000e80| 2d 20 47 65 6e 65 72 61 | 74 65 20 69 6e 69 74 69 |- Genera|te initi|
|00000e90| 61 6c 69 7a 65 64 20 68 | 61 6c 66 77 6f 72 64 73 |alized h|alfwords|
|00000ea0| 2c 20 63 6f 6d 6d 61 20 | 73 65 70 61 72 61 74 65 |, comma |separate|
|00000eb0| 64 0d 0a 2e 73 65 67 20 | 20 20 2d 2d 20 53 65 74 |d...seg | -- Set|
|00000ec0| 20 63 75 72 72 65 6e 74 | 20 73 65 67 6d 65 6e 74 | current| segment|
|00000ed0| 20 74 6f 20 22 74 65 78 | 74 22 2c 20 22 64 61 74 | to "tex|t", "dat|
|00000ee0| 61 22 2c 20 6f 72 20 22 | 62 73 73 22 0d 0a 2e 73 |a", or "|bss"...s|
|00000ef0| 6b 69 70 20 20 2d 2d 20 | 41 6c 6c 6f 63 61 74 65 |kip -- |Allocate|
|00000f00| 20 65 6d 70 74 79 20 73 | 70 61 63 65 20 69 6e 20 | empty s|pace in |
|00000f10| 63 75 72 72 65 6e 74 20 | 73 65 67 6d 65 6e 74 0d |current |segment.|
|00000f20| 0a 2e 77 6f 72 64 20 20 | 2d 2d 20 47 65 6e 65 72 |..word |-- Gener|
|00000f30| 61 74 65 20 69 6e 69 74 | 69 61 6c 69 7a 65 64 20 |ate init|ialized |
|00000f40| 77 6f 72 64 73 2c 20 63 | 6f 6d 6d 61 20 73 65 70 |words, c|omma sep|
|00000f50| 61 72 61 74 65 64 0d 0a | 5c 65 6e 64 7b 76 65 72 |arated..|\end{ver|
|00000f60| 62 61 74 69 6d 7d 0d 0a | 0d 0a 49 64 65 6e 74 69 |batim}..|..Identi|
|00000f70| 66 69 65 72 73 20 6d 75 | 73 74 20 62 65 67 69 6e |fiers mu|st begin|
|00000f80| 20 77 69 74 68 20 61 6e | 20 75 70 70 65 72 20 6f | with an| upper o|
|00000f90| 72 20 6c 6f 77 65 72 20 | 63 61 73 65 20 6c 65 74 |r lower |case let|
|00000fa0| 74 65 72 2c 20 75 6e 64 | 65 72 73 63 6f 72 65 0d |ter, und|erscore.|
|00000fb0| 0a 28 27 5c 76 65 72 62 | 2b 5f 2b 27 29 2c 20 64 |.('\verb|+_+'), d|
|00000fc0| 6f 6c 6c 61 72 20 73 69 | 67 6e 20 28 27 5c 76 65 |ollar si|gn ('\ve|
|00000fd0| 72 62 2b 24 2b 27 29 20 | 6f 72 20 70 65 72 69 6f |rb+$+') |or perio|
|00000fe0| 64 20 28 27 5c 76 65 72 | 62 2b 2e 2b 27 29 2e 0d |d ('\ver|b+.+')..|
|00000ff0| 0a 41 64 64 69 74 69 6f | 6e 61 6c 20 63 68 61 72 |.Additio|nal char|
|00001000| 61 63 74 65 72 73 20 6d | 61 79 20 62 65 20 64 69 |acters m|ay be di|
|00001010| 67 69 74 73 20 61 73 20 | 77 65 6c 6c 2e 20 20 4e |gits as |well. N|
|00001020| 75 6d 65 72 69 63 20 6c | 61 62 65 6c 73 20 61 72 |umeric l|abels ar|
|00001030| 65 20 6e 6f 74 0d 0a 73 | 75 70 70 6f 72 74 65 64 |e not..s|upported|
|00001040| 20 62 79 20 73 61 73 6d | 2e 0d 0a 0d 0a 54 68 65 | by sasm|.....The|
|00001050| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 72 65 67 69 73 | followi|ng regis|
|00001060| 74 65 72 20 6e 61 6d 65 | 73 20 61 72 65 20 72 65 |ter name|s are re|
|00001070| 63 6f 67 6e 69 7a 65 64 | 20 62 79 20 73 61 73 6d |cognized| by sasm|
|00001080| 2e 0d 0a 54 68 65 20 6e | 75 6d 65 72 69 63 20 6e |...The n|umeric n|
|00001090| 6f 74 61 74 69 6f 6e 20 | 5c 76 65 72 62 2b 25 6e |otation |\verb+%n|
|000010a0| 2b 20 28 65 2e 67 2e 2c | 20 5c 76 65 72 62 2b 25 |+ (e.g.,| \verb+%|
|000010b0| 32 32 2b 29 20 69 73 20 | 6e 6f 74 20 73 75 70 70 |22+) is |not supp|
|000010c0| 6f 72 74 65 64 2e 0d 0a | 54 68 65 20 5c 76 65 72 |orted...|The \ver|
|000010d0| 62 2b 25 68 69 2b 20 61 | 6e 64 20 5c 76 65 72 62 |b+%hi+ a|nd \verb|
|000010e0| 2b 25 6c 6f 2b 20 6f 70 | 65 72 61 74 6f 72 73 20 |+%lo+ op|erators |
|000010f0| 61 72 65 20 6e 6f 74 20 | 73 75 70 70 6f 72 74 65 |are not |supporte|
|00001100| 64 20 65 69 74 68 65 72 | 2e 0d 0a 0d 0a 5c 62 65 |d either|.....\be|
|00001110| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0d 0a 25 |gin{verb|atim}..%|
|00001120| 67 30 20 20 25 6f 30 20 | 20 25 6c 30 20 20 25 69 |g0 %o0 | %l0 %i|
|00001130| 30 20 20 25 66 30 20 20 | 25 66 38 20 20 20 25 66 |0 %f0 |%f8 %f|
|00001140| 31 36 20 20 25 66 32 34 | 20 20 25 63 30 20 20 25 |16 %f24| %c0 %|
|00001150| 63 38 20 20 20 25 63 31 | 36 20 20 25 63 32 34 0d |c8 %c1|6 %c24.|
|00001160| 0a 25 67 31 20 20 25 6f | 31 20 20 25 6c 31 20 20 |.%g1 %o|1 %l1 |
|00001170| 25 69 31 20 20 25 66 31 | 20 20 25 66 39 20 20 20 |%i1 %f1| %f9 |
|00001180| 25 66 31 37 20 20 25 66 | 32 35 20 20 25 63 31 20 |%f17 %f|25 %c1 |
|00001190| 20 25 63 39 20 20 20 25 | 63 31 37 20 20 25 63 32 | %c9 %|c17 %c2|
|000011a0| 35 0d 0a 25 67 32 20 20 | 25 6f 32 20 20 25 6c 32 |5..%g2 |%o2 %l2|
|000011b0| 20 20 25 69 32 20 20 25 | 66 32 20 20 25 66 31 30 | %i2 %|f2 %f10|
|000011c0| 20 20 25 66 31 38 20 20 | 25 66 32 36 20 20 25 63 | %f18 |%f26 %c|
|000011d0| 32 20 20 25 63 31 30 20 | 20 25 63 31 38 20 20 25 |2 %c10 | %c18 %|
|000011e0| 63 32 36 0d 0a 25 67 33 | 20 20 25 6f 33 20 20 25 |c26..%g3| %o3 %|
|000011f0| 6c 33 20 20 25 69 33 20 | 20 25 66 33 20 20 25 66 |l3 %i3 | %f3 %f|
|00001200| 31 31 20 20 25 66 31 39 | 20 20 25 66 32 37 20 20 |11 %f19| %f27 |
|00001210| 25 63 33 20 20 25 63 31 | 31 20 20 25 63 31 39 20 |%c3 %c1|1 %c19 |
|00001220| 20 25 63 32 37 0d 0a 25 | 67 34 20 20 25 6f 34 20 | %c27..%|g4 %o4 |
|00001230| 20 25 6c 34 20 20 25 69 | 34 20 20 25 66 34 20 20 | %l4 %i|4 %f4 |
|00001240| 25 66 31 32 20 20 25 66 | 32 30 20 20 25 66 32 38 |%f12 %f|20 %f28|
|00001250| 20 20 25 63 34 20 20 25 | 63 31 32 20 20 25 63 32 | %c4 %|c12 %c2|
|00001260| 30 20 20 25 63 32 38 0d | 0a 25 67 35 20 20 25 6f |0 %c28.|.%g5 %o|
|00001270| 35 20 20 25 6c 35 20 20 | 25 69 35 20 20 25 66 35 |5 %l5 |%i5 %f5|
|00001280| 20 20 25 66 31 33 20 20 | 25 66 32 31 20 20 25 66 | %f13 |%f21 %f|
|00001290| 32 39 20 20 25 63 35 20 | 20 25 63 31 33 20 20 25 |29 %c5 | %c13 %|
|000012a0| 63 32 31 20 20 25 63 32 | 39 0d 0a 25 67 36 20 20 |c21 %c2|9..%g6 |
|000012b0| 25 6f 36 20 20 25 6c 36 | 20 20 25 69 36 20 20 25 |%o6 %l6| %i6 %|
|000012c0| 66 36 20 20 25 66 31 34 | 20 20 25 66 32 32 20 20 |f6 %f14| %f22 |
|000012d0| 25 66 33 30 20 20 25 63 | 36 20 20 25 63 31 34 20 |%f30 %c|6 %c14 |
|000012e0| 20 25 63 32 32 20 20 25 | 63 33 30 0d 0a 25 67 37 | %c22 %|c30..%g7|
|000012f0| 20 20 25 6f 37 20 20 25 | 6c 37 20 20 25 69 37 20 | %o7 %|l7 %i7 |
|00001300| 20 25 66 37 20 20 25 66 | 31 35 20 20 25 66 32 33 | %f7 %f|15 %f23|
|00001310| 20 20 25 66 33 31 20 20 | 25 63 37 20 20 25 63 31 | %f31 |%c7 %c1|
|00001320| 35 20 20 25 63 32 33 20 | 20 25 63 33 31 0d 0a 0d |5 %c23 | %c31...|
|00001330| 0a 25 66 70 20 20 25 73 | 70 20 20 25 66 71 20 20 |.%fp %s|p %fq |
|00001340| 25 63 71 20 20 25 79 20 | 20 20 25 66 73 72 20 20 |%cq %y | %fsr |
|00001350| 25 63 73 72 20 20 0d 0a | 5c 65 6e 64 7b 76 65 72 |%csr ..|\end{ver|
|00001360| 62 61 74 69 6d 7d 0d 0a | 0d 0a 54 68 65 20 66 6f |batim}..|..The fo|
|00001370| 6c 6c 6f 77 69 6e 67 20 | 69 6e 73 74 72 75 63 74 |llowing |instruct|
|00001380| 69 6f 6e 73 20 61 72 65 | 20 6e 6f 74 20 73 75 70 |ions are| not sup|
|00001390| 70 6f 72 74 65 64 20 62 | 79 20 73 61 73 6d 2e 20 |ported b|y sasm. |
|000013a0| 20 45 78 63 65 70 74 20 | 66 6f 72 0d 0a 74 68 65 | Except |for..the|
|000013b0| 73 65 2c 20 61 6c 6c 20 | 6f 70 63 6f 64 65 73 20 |se, all |opcodes |
|000013c0| 28 61 6e 64 20 74 68 65 | 69 72 20 73 79 6e 6f 6e |(and the|ir synon|
|000013d0| 79 6d 73 29 20 61 73 20 | 64 65 66 69 6e 65 64 20 |yms) as |defined |
|000013e0| 69 6e 20 74 68 65 20 56 | 65 72 73 69 6f 6e 20 37 |in the V|ersion 7|
|000013f0| 0d 0a 53 50 41 52 43 20 | 41 72 63 68 69 74 65 63 |..SPARC |Architec|
|00001400| 74 75 72 65 20 4d 61 6e | 75 61 6c 20 61 72 65 20 |ture Man|ual are |
|00001410| 73 75 70 70 6f 72 74 65 | 64 2e 20 41 64 64 69 74 |supporte|d. Addit|
|00001420| 69 6f 6e 61 6c 6c 79 2c | 20 60 60 62 22 20 69 73 |ionally,| ``b" is|
|00001430| 20 61 6c 6c 6f 77 65 64 | 0d 0a 61 73 20 61 20 73 | allowed|..as a s|
|00001440| 79 6e 6f 6e 79 6d 20 66 | 6f 72 20 60 60 62 61 22 |ynonym f|or ``ba"|
|00001450| 2e 0d 0a 0d 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |.....\be|gin{verb|
|00001460| 61 74 69 6d 7d 0d 0a 63 | 6f 70 72 6f 63 65 73 73 |atim}..c|oprocess|
|00001470| 6f 72 20 62 72 61 6e 63 | 68 20 69 6e 73 74 72 75 |or branc|h instru|
|00001480| 63 74 69 6f 6e 73 0d 0a | 63 6f 70 72 6f 63 65 73 |ctions..|coproces|
|00001490| 73 6f 72 20 6f 70 65 72 | 61 74 65 20 69 6e 73 74 |sor oper|ate inst|
|000014a0| 72 75 63 74 69 6f 6e 73 | 0d 0a 72 65 74 75 72 6e |ructions|..return|
|000014b0| 20 66 72 6f 6d 20 74 72 | 61 70 20 69 6e 73 74 72 | from tr|ap instr|
|000014c0| 75 63 74 69 6f 6e 20 28 | 22 72 65 74 74 22 29 0d |uction (|"rett").|
|000014d0| 0a 49 6e 73 74 72 75 63 | 74 69 6f 6e 73 20 75 73 |.Instruc|tions us|
|000014e0| 69 6e 67 20 74 68 65 20 | 25 70 73 72 2c 20 25 77 |ing the |%psr, %w|
|000014f0| 69 6d 20 61 6e 64 20 25 | 74 62 72 20 72 65 67 69 |im and %|tbr regi|
|00001500| 73 74 65 72 73 2e 0d 0a | 5c 65 6e 64 7b 76 65 72 |sters...|\end{ver|
|00001510| 62 61 74 69 6d 7d 0d 0a | 0d 0a 4f 6e 6c 79 20 74 |batim}..|..Only t|
|00001520| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 70 73 65 |he follo|wing pse|
|00001530| 75 64 6f 2d 69 6e 73 74 | 72 75 63 74 69 6f 6e 73 |udo-inst|ructions|
|00001540| 20 61 72 65 20 61 6c 6c | 6f 77 65 64 2e 0d 0a 0d | are all|owed....|
|00001550| 0a 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |.\begin{|verbatim|
|00001560| 7d 0d 0a 6e 6f 70 20 20 | 20 20 63 6d 70 20 20 20 |}..nop | cmp |
|00001570| 74 73 74 20 20 20 20 72 | 65 74 0d 0a 72 65 74 6c |tst r|et..retl|
|00001580| 20 20 20 73 65 74 20 20 | 20 69 6e 63 20 20 20 20 | set | inc |
|00001590| 69 6e 63 63 63 0d 0a 64 | 65 63 20 20 20 20 64 65 |inccc..d|ec de|
|000015a0| 63 63 63 20 63 6c 72 20 | 20 20 20 63 6c 72 62 0d |ccc clr | clrb.|
|000015b0| 0a 63 6c 72 68 20 20 20 | 6d 6f 76 0d 0a 5c 65 6e |.clrh |mov..\en|
|000015c0| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0d 0a 0d 0a 53 |d{verbat|im}....S|
|000015d0| 61 73 6d 20 72 65 71 75 | 69 72 65 73 20 74 68 65 |asm requ|ires the|
|000015e0| 20 6e 61 6d 65 20 6f 66 | 20 74 68 65 20 61 73 73 | name of| the ass|
|000015f0| 65 6d 62 6c 65 72 20 73 | 6f 75 72 63 65 20 66 69 |embler s|ource fi|
|00001600| 6c 65 20 6f 6e 20 69 74 | 73 0d 0a 63 6f 6d 6d 61 |le on it|s..comma|
|00001610| 6e 64 20 6c 69 6e 65 2e | 20 20 4f 74 68 65 72 20 |nd line.| Other |
|00001620| 61 63 63 65 70 74 65 64 | 20 6f 70 74 69 6f 6e 73 |accepted| options|
|00001630| 20 61 72 65 3a 0d 0a 0d | 0a 5c 62 65 67 69 6e 7b | are:...|.\begin{|
|00001640| 69 74 65 6d 69 7a 65 7d | 0d 0a 5c 69 74 65 6d 5b |itemize}|..\item[|
|00001650| 5c 76 65 72 62 2b 2d 67 | 2b 5d 20 43 61 75 73 65 |\verb+-g|+] Cause|
|00001660| 20 6c 69 6e 65 20 6e 75 | 6d 62 65 72 0d 0a 61 6e | line nu|mber..an|
|00001670| 64 20 73 79 6d 62 6f 6c | 20 76 61 6c 75 65 20 69 |d symbol| value i|
|00001680| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 74 6f 20 62 65 |nformati|on to be|
|00001690| 20 61 64 64 65 64 20 74 | 6f 20 74 68 65 20 65 78 | added t|o the ex|
|000016a0| 65 63 75 74 61 62 6c 65 | 2e 0d 0a 49 74 20 63 61 |ecutable|...It ca|
|000016b0| 6e 20 74 68 65 6e 20 62 | 65 20 64 65 62 75 67 67 |n then b|e debugg|
|000016c0| 65 64 20 77 69 74 68 20 | 61 20 64 65 62 75 67 67 |ed with |a debugg|
|000016d0| 65 72 20 73 75 63 68 20 | 61 73 20 67 64 62 20 6f |er such |as gdb o|
|000016e0| 72 0d 0a 74 68 65 20 69 | 6e 74 65 72 61 63 74 69 |r..the i|nteracti|
|000016f0| 76 65 20 6d 6f 64 65 20 | 6f 66 20 73 73 69 6d 2e |ve mode |of ssim.|
|00001700| 0d 0a 0d 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 2b |....\ite|m[\verb+|
|00001710| 2d 6e 2b 5d 20 44 6f 20 | 6e 6f 74 20 64 69 73 70 |-n+] Do |not disp|
|00001720| 6c 61 79 20 76 65 72 73 | 69 6f 6e 20 61 6e 64 20 |lay vers|ion and |
|00001730| 63 6f 70 79 72 69 67 68 | 74 20 62 61 6e 6e 65 72 |copyrigh|t banner|
|00001740| 2e 0d 0a 0d 0a 5c 69 74 | 65 6d 5b 5c 76 65 72 62 |.....\it|em[\verb|
|00001750| 2b 2d 6f 2b 5d 20 53 70 | 65 63 69 66 79 20 74 68 |+-o+] Sp|ecify th|
|00001760| 65 20 6e 61 6d 65 20 6f | 66 20 74 68 65 20 6f 75 |e name o|f the ou|
|00001770| 74 70 75 74 20 66 69 6c | 65 2e 0d 0a 54 68 65 20 |tput fil|e...The |
|00001780| 64 65 66 61 75 6c 74 20 | 69 73 20 5c 76 65 72 62 |default |is \verb|
|00001790| 2b 61 2e 6f 75 74 2b 2e | 0d 0a 0d 0a 5c 69 74 65 |+a.out+.|....\ite|
|000017a0| 6d 5b 5c 76 65 72 62 2b | 2d 6c 2b 5d 20 43 61 75 |m[\verb+|-l+] Cau|
|000017b0| 73 65 20 6c 69 6e 65 73 | 20 66 72 6f 6d 20 74 68 |se lines| from th|
|000017c0| 65 20 69 6e 70 75 74 20 | 66 69 6c 65 20 74 6f 0d |e input |file to.|
|000017d0| 0a 62 65 20 65 63 68 6f | 65 64 20 64 75 72 69 6e |.be echo|ed durin|
|000017e0| 67 20 74 68 65 20 66 69 | 72 73 74 20 70 61 73 73 |g the fi|rst pass|
|000017f0| 20 6f 66 20 61 73 73 65 | 6d 62 6c 79 2e 0d 0a 5c | of asse|mbly...\|
|00001800| 65 6e 64 7b 69 74 65 6d | 69 7a 65 7d 0d 0a 0d 0a |end{item|ize}....|
|00001810| 53 61 73 6d 20 73 69 6c | 65 6e 74 6c 79 20 61 6c |Sasm sil|ently al|
|00001820| 6c 6f 77 73 20 74 68 65 | 20 75 73 65 20 6f 66 20 |lows the| use of |
|00001830| 5c 76 65 72 62 2b 73 65 | 74 2b 20 69 6e 20 61 20 |\verb+se|t+ in a |
|00001840| 64 65 6c 61 79 20 73 6c | 6f 74 2e 0d 0a 49 74 20 |delay sl|ot...It |
|00001850| 64 6f 65 73 20 6e 6f 74 | 20 75 6e 64 65 72 73 74 |does not| underst|
|00001860| 61 6e 64 20 61 6e 79 20 | 6b 69 6e 64 20 6f 66 20 |and any |kind of |
|00001870| 6d 61 63 72 6f 73 2c 20 | 6e 6f 72 20 64 6f 65 73 |macros, |nor does|
|00001880| 0d 0a 69 74 20 75 6e 64 | 65 72 73 74 61 6e 64 20 |..it und|erstand |
|00001890| 74 68 65 20 5c 76 65 72 | 62 2b 6c 64 32 2b 20 70 |the \ver|b+ld2+ p|
|000018a0| 73 65 75 64 6f 2d 69 6e | 73 74 72 75 63 74 69 6f |seudo-in|structio|
|000018b0| 6e 20 73 6f 6d 65 74 69 | 6d 65 73 0d 0a 6f 75 74 |n someti|mes..out|
|000018c0| 70 75 74 20 62 79 20 74 | 68 65 20 53 75 6e 20 43 |put by t|he Sun C|
|000018d0| 20 63 6f 6d 70 69 6c 65 | 72 2e 0d 0a 0d 0a 0d 0a | compile|r.......|
|000018e0| 5c 73 65 63 74 69 6f 6e | 2a 7b 53 53 49 4d 20 53 |\section|*{SSIM S|
|000018f0| 69 6d 75 6c 61 74 6f 72 | 7d 0d 0a 0d 0a 53 73 69 |imulator|}....Ssi|
|00001900| 6d 20 68 61 73 20 73 65 | 76 65 72 61 6c 20 6c 69 |m has se|veral li|
|00001910| 6d 69 74 61 74 69 6f 6e | 73 20 74 68 61 74 20 61 |mitation|s that a|
|00001920| 72 65 20 66 6f 72 63 65 | 64 20 62 79 20 74 68 65 |re force|d by the|
|00001930| 20 6e 61 74 75 72 65 20 | 6f 66 20 74 68 65 20 31 | nature |of the 1|
|00001940| 0d 0a 4d 65 67 61 62 79 | 74 65 20 72 65 61 6c 2d |..Megaby|te real-|
|00001950| 61 64 64 72 65 73 73 20 | 73 70 61 63 65 20 61 76 |address |space av|
|00001960| 61 69 6c 61 62 6c 65 20 | 75 6e 64 65 72 20 4d 53 |ailable |under MS|
|00001970| 44 4f 53 2e 20 20 4e 6f | 20 73 77 61 70 70 69 6e |DOS. No| swappin|
|00001980| 67 20 6f 72 0d 0a 70 61 | 67 69 6e 67 20 6f 66 20 |g or..pa|ging of |
|00001990| 61 6e 79 20 6b 69 6e 64 | 20 69 73 20 61 74 74 65 |any kind| is atte|
|000019a0| 6d 70 74 65 64 20 62 79 | 20 73 73 69 6d 2e 20 20 |mpted by| ssim. |
|000019b0| 54 68 65 20 61 6d 6f 75 | 6e 74 20 6f 66 20 76 69 |The amou|nt of vi|
|000019c0| 72 74 75 61 6c 0d 0a 61 | 64 64 72 65 73 73 20 73 |rtual..a|ddress s|
|000019d0| 70 61 63 65 20 61 76 61 | 69 6c 61 62 6c 65 20 74 |pace ava|ilable t|
|000019e0| 6f 20 74 68 65 20 53 50 | 41 52 43 20 70 72 6f 67 |o the SP|ARC prog|
|000019f0| 72 61 6d 20 69 73 20 64 | 65 74 65 72 6d 69 6e 65 |ram is d|etermine|
|00001a00| 64 20 62 79 20 74 68 65 | 0d 0a 61 6d 6f 75 6e 74 |d by the|..amount|
|00001a10| 20 6f 66 20 66 72 65 65 | 20 70 68 79 73 69 63 61 | of free| physica|
|00001a20| 6c 20 6d 65 6d 6f 72 79 | 20 6f 6e 20 74 68 65 20 |l memory| on the |
|00001a30| 4d 53 44 4f 53 20 68 6f | 73 74 2e 20 20 54 68 69 |MSDOS ho|st. Thi|
|00001a40| 73 20 76 65 72 73 69 6f | 6e 20 6f 66 0d 0a 73 73 |s versio|n of..ss|
|00001a50| 69 6d 20 68 61 73 20 74 | 68 65 20 61 64 64 69 74 |im has t|he addit|
|00001a60| 69 6f 6e 61 6c 20 6c 69 | 6d 69 74 61 74 69 6f 6e |ional li|mitation|
|00001a70| 20 74 68 61 74 20 69 74 | 20 77 69 6c 6c 20 6e 6f | that it| will no|
|00001a80| 74 20 73 69 6d 75 6c 61 | 74 65 20 70 72 6f 67 72 |t simula|te progr|
|00001a90| 61 6d 73 0d 0a 72 65 71 | 75 69 72 69 6e 67 20 6d |ams..req|uiring m|
|00001aa0| 6f 72 65 20 74 68 61 6e | 20 36 34 6b 20 74 6f 74 |ore than| 64k tot|
|00001ab0| 61 6c 20 74 65 78 74 20 | 61 6e 64 20 64 61 74 61 |al text |and data|
|00001ac0| 20 73 70 61 63 65 2e 20 | 54 68 69 73 20 6c 69 6d | space. |This lim|
|00001ad0| 69 74 61 74 69 6f 6e 20 | 6d 61 79 0d 0a 62 65 20 |itation |may..be |
|00001ae0| 72 65 6c 61 78 65 64 20 | 69 6e 20 61 20 66 75 74 |relaxed |in a fut|
|00001af0| 75 72 65 20 76 65 72 73 | 69 6f 6e 2e 0d 0a 0d 0a |ure vers|ion.....|
|00001b00| 41 6c 6c 20 53 50 41 52 | 43 20 61 64 64 72 65 73 |All SPAR|C addres|
|00001b10| 73 65 73 20 61 72 65 20 | 72 65 6c 61 74 65 64 20 |ses are |related |
|00001b20| 74 6f 20 4d 53 44 4f 53 | 20 61 64 64 72 65 73 73 |to MSDOS| address|
|00001b30| 65 73 20 62 79 20 61 20 | 73 69 6e 67 6c 65 20 6f |es by a |single o|
|00001b40| 66 66 73 65 74 0d 0a 77 | 68 69 63 68 20 69 73 20 |ffset..w|hich is |
|00001b50| 65 69 74 68 65 72 20 61 | 64 64 65 64 20 6f 72 20 |either a|dded or |
|00001b60| 73 75 62 74 72 61 63 74 | 65 64 2e 20 20 54 68 69 |subtract|ed. Thi|
|00001b70| 73 20 6d 65 61 6e 73 20 | 74 68 61 74 20 74 68 65 |s means |that the|
|00001b80| 20 74 6f 70 20 6f 66 20 | 73 74 61 63 6b 0d 0a 69 | top of |stack..i|
|00001b90| 73 20 6e 6f 74 20 6e 65 | 61 72 6c 79 20 61 73 20 |s not ne|arly as |
|00001ba0| 68 69 67 68 20 69 6e 20 | 74 68 65 20 61 64 64 72 |high in |the addr|
|00001bb0| 65 73 73 20 73 70 61 63 | 65 20 61 73 20 6f 6e 20 |ess spac|e as on |
|00001bc0| 72 65 61 6c 20 53 50 41 | 52 43 20 68 61 72 64 77 |real SPA|RC hardw|
|00001bd0| 61 72 65 0d 0a 77 69 74 | 68 20 76 69 72 74 75 61 |are..wit|h virtua|
|00001be0| 6c 20 6d 65 6d 6f 72 79 | 2e 20 20 42 65 63 61 75 |l memory|. Becau|
|00001bf0| 73 65 20 6f 66 20 74 68 | 69 73 2c 20 28 53 50 41 |se of th|is, (SPA|
|00001c00| 52 43 29 20 73 74 61 63 | 6b 20 6f 76 65 72 66 6c |RC) stac|k overfl|
|00001c10| 6f 77 20 62 65 63 6f 6d | 65 73 0d 0a 61 20 72 65 |ow becom|es..a re|
|00001c20| 61 6c 20 70 6f 73 73 69 | 62 69 6c 69 74 79 2e 20 |al possi|bility. |
|00001c30| 20 53 73 69 6d 20 64 6f | 65 73 20 6e 6f 74 20 6d | Ssim do|es not m|
|00001c40| 61 6b 65 20 61 6e 79 20 | 6b 69 6e 64 20 6f 66 20 |ake any |kind of |
|00001c50| 63 68 65 63 6b 20 66 6f | 72 20 73 74 61 63 6b 0d |check fo|r stack.|
|00001c60| 0a 6f 76 65 72 66 6c 6f | 77 2e 20 20 57 68 65 6e |.overflo|w. When|
|00001c70| 20 73 73 69 6d 20 65 78 | 61 6d 69 6e 65 73 20 61 | ssim ex|amines a|
|00001c80| 20 53 50 41 52 43 20 61 | 64 64 72 65 73 73 20 66 | SPARC a|ddress f|
|00001c90| 6f 72 20 76 61 6c 69 64 | 69 74 79 2c 20 69 74 20 |or valid|ity, it |
|00001ca0| 6f 6e 6c 79 0d 0a 63 68 | 65 63 6b 73 20 74 6f 20 |only..ch|ecks to |
|00001cb0| 73 65 65 20 69 66 20 74 | 68 65 20 63 6f 72 72 65 |see if t|he corre|
|00001cc0| 73 70 6f 6e 64 69 6e 67 | 20 4d 53 44 4f 53 20 61 |sponding| MSDOS a|
|00001cd0| 64 64 72 65 73 73 20 69 | 73 20 6f 75 74 73 69 64 |ddress i|s outsid|
|00001ce0| 65 20 74 68 65 20 62 6c | 6f 63 6b 0d 0a 61 6c 6c |e the bl|ock..all|
|00001cf0| 6f 63 61 74 65 64 20 66 | 6f 72 20 53 50 41 52 43 |ocated f|or SPARC|
|00001d00| 20 6d 65 6d 6f 72 79 2e | 20 20 49 66 20 73 6f 2c | memory.| If so,|
|00001d10| 20 61 20 73 65 67 6d 65 | 6e 74 61 74 69 6f 6e 20 | a segme|ntation |
|00001d20| 66 61 75 6c 74 20 69 73 | 20 69 6e 63 75 72 72 65 |fault is| incurre|
|00001d30| 64 0d 0a 61 6e 64 20 74 | 68 65 20 70 72 6f 67 72 |d..and t|he progr|
|00001d40| 61 6d 20 74 65 72 6d 69 | 6e 61 74 65 73 20 28 75 |am termi|nates (u|
|00001d50| 6e 6c 65 73 73 20 69 74 | 20 68 61 6e 64 6c 65 73 |nless it| handles|
|00001d60| 20 53 49 47 53 45 47 56 | 29 2e 20 20 53 69 6e 63 | SIGSEGV|). Sinc|
|00001d70| 65 20 74 68 65 0d 0a 62 | 65 67 69 6e 6e 69 6e 67 |e the..b|eginning|
|00001d80| 20 6f 66 20 53 50 41 52 | 43 20 6d 65 6d 6f 72 79 | of SPAR|C memory|
|00001d90| 20 69 73 20 61 74 20 61 | 64 64 72 65 73 73 20 30 | is at a|ddress 0|
|00001da0| 78 32 30 30 30 2c 20 4e | 55 4c 4c 20 70 6f 69 6e |x2000, N|ULL poin|
|00001db0| 74 65 72 0d 0a 64 65 72 | 65 66 65 72 65 6e 63 69 |ter..der|eferenci|
|00001dc0| 6e 67 20 77 69 6c 6c 20 | 67 65 6e 65 72 61 74 65 |ng will |generate|
|00001dd0| 20 61 20 53 49 47 53 45 | 47 56 2e 20 20 41 6e 79 | a SIGSE|GV. Any|
|00001de0| 20 61 64 64 72 65 73 73 | 20 66 72 6f 6d 20 30 78 | address| from 0x|
|00001df0| 32 30 30 30 20 74 6f 20 | 74 68 65 0d 0a 74 6f 70 |2000 to |the..top|
|00001e00| 20 6f 66 20 73 74 61 63 | 6b 20 63 61 6e 20 62 65 | of stac|k can be|
|00001e10| 20 72 65 61 64 2c 20 77 | 72 69 74 74 65 6e 20 61 | read, w|ritten a|
|00001e20| 6e 64 20 65 78 65 63 75 | 74 65 64 2e 20 20 54 68 |nd execu|ted. Th|
|00001e30| 65 72 65 20 69 73 20 6e | 6f 20 75 6e 6d 61 70 70 |ere is n|o unmapp|
|00001e40| 65 64 0d 0a 67 61 70 20 | 62 65 74 77 65 65 6e 20 |ed..gap |between |
|00001e50| 74 68 65 20 74 6f 70 20 | 6f 66 20 74 68 65 20 68 |the top |of the h|
|00001e60| 65 61 70 20 61 6e 64 20 | 62 6f 74 74 6f 6d 20 6f |eap and |bottom o|
|00001e70| 66 20 74 68 65 20 73 74 | 61 63 6b 20 61 73 20 6f |f the st|ack as o|
|00001e80| 6e 20 72 65 61 6c 0d 0a | 68 61 72 64 77 61 72 65 |n real..|hardware|
|00001e90| 2e 20 20 41 6c 69 67 6e | 6d 65 6e 74 20 72 65 73 |. Align|ment res|
|00001ea0| 74 72 69 63 74 69 6f 6e | 73 20 66 6f 72 20 6c 6f |triction|s for lo|
|00001eb0| 61 64 20 61 6e 64 20 73 | 74 6f 72 65 20 69 6e 73 |ad and s|tore ins|
|00001ec0| 74 72 75 63 74 69 6f 6e | 73 20 61 72 65 0d 0a 65 |truction|s are..e|
|00001ed0| 6e 66 6f 72 63 65 64 20 | 62 79 20 73 73 69 6d 2e |nforced |by ssim.|
|00001ee0| 20 20 41 20 53 49 47 42 | 55 53 20 72 65 73 75 6c | A SIGB|US resul|
|00001ef0| 74 73 20 66 72 6f 6d 20 | 61 6e 20 75 6e 61 6c 69 |ts from |an unali|
|00001f00| 67 6e 65 64 20 61 63 63 | 65 73 73 2e 0d 0a 0d 0a |gned acc|ess.....|
|00001f10| 5c 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 4f 70 74 |\subsect|ion*{Opt|
|00001f20| 69 6f 6e 73 7d 0d 0a 49 | 66 20 6e 6f 20 66 69 6c |ions}..I|f no fil|
|00001f30| 65 6e 61 6d 65 20 69 73 | 20 67 69 76 65 6e 20 77 |ename is| given w|
|00001f40| 68 65 6e 20 69 6e 76 6f | 6b 69 6e 67 20 73 73 69 |hen invo|king ssi|
|00001f50| 6d 2c 20 74 68 65 20 64 | 65 66 61 75 6c 74 20 6e |m, the d|efault n|
|00001f60| 61 6d 65 0d 0a 5c 76 65 | 72 62 2b 61 2e 6f 75 74 |ame..\ve|rb+a.out|
|00001f70| 2b 20 69 73 20 61 73 73 | 75 6d 65 64 2e 20 20 53 |+ is ass|umed. S|
|00001f80| 65 76 65 72 61 6c 20 6f | 70 74 69 6f 6e 73 20 6d |everal o|ptions m|
|00001f90| 6f 64 69 66 79 20 74 68 | 65 20 73 69 6d 75 6c 61 |odify th|e simula|
|00001fa0| 74 6f 72 27 73 0d 0a 62 | 65 68 61 76 69 6f 72 2e |tor's..b|ehavior.|
|00001fb0| 20 41 6e 79 20 6f 66 20 | 74 68 65 73 65 20 6f 70 | Any of |these op|
|00001fc0| 74 69 6f 6e 73 20 28 65 | 78 63 65 70 74 20 5c 76 |tions (e|xcept \v|
|00001fd0| 65 72 62 2b 2d 64 2b 29 | 20 77 69 6c 6c 20 63 61 |erb+-d+)| will ca|
|00001fe0| 75 73 65 0d 0a 53 50 41 | 52 43 20 63 6f 64 65 20 |use..SPA|RC code |
|00001ff0| 74 6f 20 65 78 65 63 75 | 74 65 20 73 6c 6f 77 65 |to execu|te slowe|
|00002000| 72 20 64 75 65 20 74 6f | 20 61 64 64 69 74 69 6f |r due to| additio|
|00002010| 6e 61 6c 20 63 68 65 63 | 6b 69 6e 67 2e 0d 0a 0d |nal chec|king....|
|00002020| 0a 5c 62 65 67 69 6e 7b | 69 74 65 6d 69 7a 65 7d |.\begin{|itemize}|
|00002030| 20 5c 69 74 65 6d 5b 5c | 76 65 72 62 2b 2d 63 2b | \item[\|verb+-c+|
|00002040| 5d 20 57 72 69 74 65 20 | 61 6e 20 65 78 65 63 75 |] Write |an execu|
|00002050| 74 69 6f 6e 20 74 72 61 | 63 65 20 74 6f 20 74 68 |tion tra|ce to th|
|00002060| 65 20 66 69 6c 65 0d 0a | 60 60 63 6f 64 65 2e 74 |e file..|``code.t|
|00002070| 72 61 22 2e 20 20 54 68 | 65 20 63 6f 64 65 20 74 |ra". Th|e code t|
|00002080| 72 61 63 65 20 63 6f 6e | 73 69 73 74 73 20 6f 66 |race con|sists of|
|00002090| 20 61 20 73 65 71 75 65 | 6e 63 65 20 6f 66 20 33 | a seque|nce of 3|
|000020a0| 32 2d 62 69 74 20 77 6f | 72 64 73 0d 0a 67 69 76 |2-bit wo|rds..giv|
|000020b0| 69 6e 67 20 74 68 65 20 | 53 50 41 52 43 20 76 69 |ing the |SPARC vi|
|000020c0| 72 74 75 61 6c 20 61 64 | 64 72 65 73 73 20 6f 66 |rtual ad|dress of|
|000020d0| 20 65 61 63 68 20 69 6e | 73 74 72 75 63 74 69 6f | each in|structio|
|000020e0| 6e 20 65 78 65 63 75 74 | 65 64 2e 0d 0a 0d 0a 5c |n execut|ed.....\|
|000020f0| 69 74 65 6d 5b 5c 76 65 | 72 62 2b 2d 64 2b 5d 20 |item[\ve|rb+-d+] |
|00002100| 57 72 69 74 65 20 61 20 | 6c 6f 61 64 2f 73 74 6f |Write a |load/sto|
|00002110| 72 65 20 74 72 61 63 65 | 20 74 6f 20 74 68 65 20 |re trace| to the |
|00002120| 66 69 6c 65 20 60 60 64 | 61 74 61 2e 74 72 61 22 |file ``d|ata.tra"|
|00002130| 2e 20 20 54 68 65 0d 0a | 64 61 74 61 20 74 72 61 |. The..|data tra|
|00002140| 63 65 20 63 6f 6e 73 69 | 73 74 73 20 6f 66 20 61 |ce consi|sts of a|
|00002150| 20 73 65 72 69 65 73 20 | 6f 66 20 66 69 76 65 2d | series |of five-|
|00002160| 62 79 74 65 20 72 65 63 | 6f 72 64 73 2e 20 20 54 |byte rec|ords. T|
|00002170| 68 65 20 66 69 72 73 74 | 20 62 79 74 65 0d 0a 69 |he first| byte..i|
|00002180| 64 65 6e 74 69 66 69 65 | 73 20 74 68 65 20 74 79 |dentifie|s the ty|
|00002190| 70 65 20 6f 66 20 61 63 | 63 65 73 73 20 28 65 2e |pe of ac|cess (e.|
|000021a0| 67 2e 20 6c 6f 61 64 20 | 75 6e 73 69 67 6e 65 64 |g. load |unsigned|
|000021b0| 20 62 79 74 65 29 2e 20 | 20 54 68 65 0d 0a 66 6f | byte). | The..fo|
|000021c0| 6c 6c 6f 77 69 6e 67 20 | 66 6f 75 72 20 62 79 74 |llowing |four byt|
|000021d0| 65 73 20 61 72 65 20 74 | 68 65 20 53 50 41 52 43 |es are t|he SPARC|
|000021e0| 20 61 64 64 72 65 73 73 | 20 69 6e 76 6f 6c 76 65 | address| involve|
|000021f0| 64 2e 20 20 54 68 65 20 | 66 69 6c 65 0d 0a 5c 76 |d. The |file..\v|
|00002200| 65 72 62 2b 64 74 72 61 | 63 65 2e 63 2b 20 63 6f |erb+dtra|ce.c+ co|
|00002210| 6e 74 61 69 6e 73 20 61 | 6e 20 65 78 61 6d 70 6c |ntains a|n exampl|
|00002220| 65 20 70 72 6f 67 72 61 | 6d 20 66 6f 72 20 61 6e |e progra|m for an|
|00002230| 61 6c 79 7a 69 6e 67 20 | 74 68 69 73 20 74 79 70 |alyzing |this typ|
|00002240| 65 20 6f 66 0d 0a 74 72 | 61 63 65 2e 0d 0a 0d 0a |e of..tr|ace.....|
|00002250| 5c 69 74 65 6d 5b 5c 76 | 65 72 62 2b 2d 67 2b 5d |\item[\v|erb+-g+]|
|00002260| 20 49 6e 74 65 72 61 63 | 74 69 76 65 20 6d 6f 64 | Interac|tive mod|
|00002270| 65 2e 20 20 54 68 65 20 | 64 65 62 75 67 20 69 6e |e. The |debug in|
|00002280| 74 65 72 66 61 63 65 20 | 69 73 20 69 6e 76 6f 6b |terface |is invok|
|00002290| 65 64 0d 0a 70 72 69 6f | 72 20 74 6f 20 65 78 65 |ed..prio|r to exe|
|000022a0| 63 75 74 69 6f 6e 2e 20 | 20 53 74 61 72 74 75 70 |cution. | Startup|
|000022b0| 20 63 6f 6d 6d 61 6e 64 | 73 20 61 72 65 20 72 65 | command|s are re|
|000022c0| 61 64 20 66 72 6f 6d 20 | 74 68 65 20 66 69 6c 65 |ad from |the file|
|000022d0| 0d 0a 60 60 73 73 69 6d | 2e 69 6e 69 22 20 69 66 |..``ssim|.ini" if|
|000022e0| 20 69 74 20 65 78 69 73 | 74 73 2e 20 20 54 68 65 | it exis|ts. The|
|000022f0| 20 68 65 6c 70 20 63 6f | 6d 6d 61 6e 64 20 73 75 | help co|mmand su|
|00002300| 6d 6d 61 72 69 7a 65 73 | 20 74 68 65 20 6f 74 68 |mmarizes| the oth|
|00002310| 65 72 73 2e 0d 0a 0d 0a | 5c 69 74 65 6d 5b 5c 76 |ers.....|\item[\v|
|00002320| 65 72 62 2b 2d 69 2b 5d | 20 4b 65 65 70 20 61 20 |erb+-i+]| Keep a |
|00002330| 63 6f 75 6e 74 20 6f 66 | 20 69 6e 73 74 72 75 63 |count of| instruc|
|00002340| 74 69 6f 6e 73 20 28 6d | 6f 64 20 24 32 5e 7b 33 |tions (m|od $2^{3|
|00002350| 32 7d 24 29 20 65 78 65 | 63 75 74 65 64 2e 0d 0a |2}$) exe|cuted...|
|00002360| 0d 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 2b 2d 6e |..\item[|\verb+-n|
|00002370| 2b 5d 20 44 6f 20 6e 6f | 74 20 64 69 73 70 6c 61 |+] Do no|t displa|
|00002380| 79 20 76 65 72 73 69 6f | 6e 20 61 6e 64 20 63 6f |y versio|n and co|
|00002390| 70 79 72 69 67 68 74 20 | 62 61 6e 6e 65 72 2e 0d |pyright |banner..|
|000023a0| 0a 0d 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 2b 2d |...\item|[\verb+-|
|000023b0| 76 2b 5d 20 56 65 72 62 | 6f 73 65 2e 20 20 44 69 |v+] Verb|ose. Di|
|000023c0| 73 61 73 73 65 6d 62 6c | 65 20 65 61 63 68 20 69 |sassembl|e each i|
|000023d0| 6e 73 74 72 75 63 74 69 | 6f 6e 20 70 72 69 6f 72 |nstructi|on prior|
|000023e0| 20 74 6f 0d 0a 65 78 65 | 63 75 74 69 6f 6e 2e 0d | to..exe|cution..|
|000023f0| 0a 5c 65 6e 64 7b 69 74 | 65 6d 69 7a 65 7d 0d 0a |.\end{it|emize}..|
|00002400| 0d 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 44 |..\subse|ction*{D|
|00002410| 65 62 75 67 67 65 72 20 | 49 6e 74 65 72 66 61 63 |ebugger |Interfac|
|00002420| 65 7d 0d 0a 54 68 65 20 | 69 6e 74 65 72 61 63 74 |e}..The |interact|
|00002430| 69 76 65 20 64 65 62 75 | 67 67 65 72 20 69 6e 74 |ive debu|gger int|
|00002440| 65 72 66 61 63 65 20 77 | 69 74 68 69 6e 20 73 73 |erface w|ithin ss|
|00002450| 69 6d 20 69 73 20 6d 6f | 64 65 6c 65 64 0d 0a 61 |im is mo|deled..a|
|00002460| 66 74 65 72 20 61 20 73 | 75 62 73 65 74 20 6f 66 |fter a s|ubset of|
|00002470| 20 74 68 65 20 47 4e 55 | 20 64 65 62 75 67 67 65 | the GNU| debugge|
|00002480| 72 20 67 64 62 2e 20 20 | 41 6e 79 20 63 6f 6d 6d |r gdb. |Any comm|
|00002490| 61 6e 64 20 75 73 69 6e | 67 0d 0a 6c 69 6e 65 20 |and usin|g..line |
|000024a0| 6e 75 6d 62 65 72 20 6f | 72 20 73 79 6d 62 6f 6c |number o|r symbol|
|000024b0| 20 76 61 6c 75 65 20 69 | 6e 66 6f 72 6d 61 74 69 | value i|nformati|
|000024c0| 6f 6e 20 77 69 6c 6c 20 | 72 65 71 75 69 72 65 20 |on will |require |
|000024d0| 74 68 61 74 0d 0a 74 68 | 65 20 73 6f 75 72 63 65 |that..th|e source|
|000024e0| 20 62 65 20 61 73 73 65 | 6d 62 6c 65 64 20 77 69 | be asse|mbled wi|
|000024f0| 74 68 20 73 61 73 6d 27 | 73 20 5c 76 65 72 62 2b |th sasm'|s \verb+|
|00002500| 2d 67 2b 20 66 6c 61 67 | 2e 0d 0a 44 65 62 75 67 |-g+ flag|...Debug|
|00002510| 67 69 6e 67 20 65 78 65 | 63 75 74 61 62 6c 65 73 |ging exe|cutables|
|00002520| 20 70 72 6f 64 75 63 65 | 64 20 62 79 20 6f 74 68 | produce|d by oth|
|00002530| 65 72 20 6d 65 61 6e 73 | 20 6d 61 79 20 70 72 6f |er means| may pro|
|00002540| 64 75 63 65 0d 0a 63 6f | 6e 66 75 73 69 6e 67 20 |duce..co|nfusing |
|00002550| 72 65 73 75 6c 74 73 2e | 20 28 65 2e 67 2e 2c 20 |results.| (e.g., |
|00002560| 74 68 65 20 73 73 69 6d | 20 64 65 62 75 67 67 65 |the ssim| debugge|
|00002570| 72 20 65 78 70 65 63 74 | 73 20 6f 6e 6c 79 0d 0a |r expect|s only..|
|00002580| 6f 6e 65 20 73 6f 75 72 | 63 65 20 66 69 6c 65 29 |one sour|ce file)|
|00002590| 2e 20 20 54 68 65 20 64 | 65 62 75 67 67 65 72 20 |. The d|ebugger |
|000025a0| 69 73 20 61 63 74 69 76 | 61 74 65 64 20 62 79 20 |is activ|ated by |
|000025b0| 73 70 65 63 69 66 79 69 | 6e 67 0d 0a 74 68 65 20 |specifyi|ng..the |
|000025c0| 5c 76 65 72 62 2b 2d 67 | 2b 20 6f 70 74 69 6f 6e |\verb+-g|+ option|
|000025d0| 20 74 6f 20 73 73 69 6d | 2e 20 20 49 66 20 74 68 | to ssim|. If th|
|000025e0| 65 20 73 74 61 72 74 75 | 70 20 66 69 6c 65 20 60 |e startu|p file `|
|000025f0| 60 73 73 69 6d 2e 69 6e | 69 22 0d 0a 65 78 69 73 |`ssim.in|i"..exis|
|00002600| 74 73 20 69 6e 20 74 68 | 65 20 63 75 72 72 65 6e |ts in th|e curren|
|00002610| 74 20 64 69 72 65 63 74 | 6f 72 79 2c 20 69 74 20 |t direct|ory, it |
|00002620| 77 69 6c 6c 20 62 65 20 | 6f 70 65 6e 65 64 20 61 |will be |opened a|
|00002630| 6e 64 20 72 65 61 64 0d | 0a 66 6f 72 20 73 74 61 |nd read.|.for sta|
|00002640| 72 74 75 70 20 63 6f 6d | 6d 61 6e 64 73 20 70 72 |rtup com|mands pr|
|00002650| 69 6f 72 20 74 6f 20 75 | 73 65 72 20 69 6e 74 65 |ior to u|ser inte|
|00002660| 72 61 63 74 69 6f 6e 2e | 0d 0a 0d 0a 54 68 65 20 |raction.|....The |
|00002670| 66 6f 6c 6c 6f 77 69 6e | 67 20 63 6f 6d 6d 61 6e |followin|g comman|
|00002680| 64 73 20 61 72 65 20 61 | 76 61 69 6c 61 62 6c 65 |ds are a|vailable|
|00002690| 20 77 69 74 68 69 6e 20 | 74 68 65 20 64 65 62 75 | within |the debu|
|000026a0| 67 67 65 72 3a 0d 0a 0d | 0a 5c 62 65 67 69 6e 7b |gger:...|.\begin{|
|000026b0| 74 61 62 75 6c 61 72 7d | 7b 6c 70 7b 32 2e 38 35 |tabular}|{lp{2.85|
|000026c0| 69 6e 7d 7d 0d 0a 5c 76 | 65 72 62 2b 72 75 6e 20 |in}}..\v|erb+run |
|000026d0| 5b 61 72 67 73 5d 2b 20 | 26 20 45 78 65 63 75 74 |[args]+ |& Execut|
|000026e0| 65 20 74 68 65 20 70 72 | 6f 67 72 61 6d 20 77 69 |e the pr|ogram wi|
|000026f0| 74 68 20 74 68 65 20 73 | 70 65 63 69 66 69 65 64 |th the s|pecified|
|00002700| 20 61 72 67 75 6d 65 6e | 74 73 2e 20 5c 5c 0d 0a | argumen|ts. \\..|
|00002710| 5c 76 65 72 62 2b 71 75 | 69 74 2b 20 26 20 45 78 |\verb+qu|it+ & Ex|
|00002720| 69 74 20 73 73 69 6d 2e | 20 5c 5c 0d 0a 5c 76 65 |it ssim.| \\..\ve|
|00002730| 72 62 2b 68 65 6c 70 2b | 20 26 20 53 75 6d 6d 61 |rb+help+| & Summa|
|00002740| 72 69 7a 65 20 74 68 65 | 20 61 76 61 69 6c 61 62 |rize the| availab|
|00002750| 6c 65 20 63 6f 6d 6d 61 | 6e 64 73 2e 20 5c 5c 0d |le comma|nds. \\.|
|00002760| 0a 5c 76 65 72 62 2b 62 | 72 65 61 6b 20 61 72 67 |.\verb+b|reak arg|
|00002770| 2b 20 26 20 53 65 74 20 | 61 20 62 72 65 61 6b 70 |+ & Set |a breakp|
|00002780| 6f 69 6e 74 20 61 74 20 | 74 68 65 20 67 69 76 65 |oint at |the give|
|00002790| 6e 20 61 72 67 75 6d 65 | 6e 74 2e 20 20 49 66 20 |n argume|nt. If |
|000027a0| 74 68 65 0d 0a 61 72 67 | 75 6d 65 6e 74 20 69 73 |the..arg|ument is|
|000027b0| 20 61 6e 20 69 6e 74 65 | 67 65 72 2c 20 69 74 20 | an inte|ger, it |
|000027c0| 69 73 20 61 73 73 75 6d | 65 64 20 74 6f 20 62 65 |is assum|ed to be|
|000027d0| 20 61 20 6c 69 6e 65 20 | 6e 75 6d 62 65 72 2e 20 | a line |number. |
|000027e0| 20 42 72 65 61 6b 70 6f | 69 6e 74 73 0d 0a 63 61 | Breakpo|ints..ca|
|000027f0| 6e 20 61 6c 73 6f 20 62 | 65 20 73 65 74 20 61 74 |n also b|e set at|
|00002800| 20 76 69 72 74 75 61 6c | 20 61 64 64 72 65 73 73 | virtual| address|
|00002810| 65 73 20 28 65 2e 67 2e | 2c 20 60 60 62 72 65 61 |es (e.g.|, ``brea|
|00002820| 6b 20 2a 30 78 32 63 64 | 30 22 29 2e 20 55 70 20 |k *0x2cd|0"). Up |
|00002830| 74 6f 0d 0a 31 30 20 62 | 72 65 61 6b 70 6f 69 6e |to..10 b|reakpoin|
|00002840| 74 73 20 6d 61 79 20 62 | 65 20 73 65 74 2e 20 5c |ts may b|e set. \|
|00002850| 5c 0d 0a 5c 76 65 72 62 | 2b 69 6e 66 6f 2b 20 26 |\..\verb|+info+ &|
|00002860| 20 53 75 6d 6d 61 72 69 | 7a 65 20 63 75 72 72 65 | Summari|ze curre|
|00002870| 6e 74 20 62 72 65 61 6b | 70 6f 69 6e 74 73 2e 20 |nt break|points. |
|00002880| 5c 5c 0d 0a 5c 76 65 72 | 62 2b 63 6f 6e 74 2b 20 |\\..\ver|b+cont+ |
|00002890| 26 20 43 6f 6e 74 69 6e | 75 65 20 53 50 41 52 43 |& Contin|ue SPARC|
|000028a0| 20 70 72 6f 67 72 61 6d | 20 65 78 65 63 75 74 69 | program| executi|
|000028b0| 6f 6e 2e 20 5c 5c 0d 0a | 5c 76 65 72 62 2b 64 69 |on. \\..|\verb+di|
|000028c0| 73 70 6c 61 79 20 61 72 | 67 2b 20 26 20 44 69 73 |splay ar|g+ & Dis|
|000028d0| 70 6c 61 79 20 74 68 65 | 20 73 79 6d 62 6f 6c 20 |play the| symbol |
|000028e0| 6f 72 20 72 65 67 69 73 | 74 65 72 20 61 72 67 75 |or regis|ter argu|
|000028f0| 6d 65 6e 74 20 77 68 65 | 6e 65 76 65 72 20 63 6f |ment whe|never co|
|00002900| 6e 74 72 6f 6c 0d 0a 72 | 65 74 75 72 6e 73 20 74 |ntrol..r|eturns t|
|00002910| 6f 20 74 68 65 20 64 65 | 62 75 67 67 65 72 2e 20 |o the de|bugger. |
|00002920| 20 55 70 20 74 6f 20 31 | 30 20 64 69 73 70 6c 61 | Up to 1|0 displa|
|00002930| 79 20 65 6c 65 6d 65 6e | 74 73 20 6d 61 79 20 62 |y elemen|ts may b|
|00002940| 65 20 73 65 74 2e 20 20 | 54 68 65 72 65 0d 0a 69 |e set. |There..i|
|00002950| 73 20 6e 6f 20 77 61 79 | 20 74 6f 20 72 65 6d 6f |s no way| to remo|
|00002960| 76 65 20 64 69 73 70 6c | 61 79 20 65 6c 65 6d 65 |ve displ|ay eleme|
|00002970| 6e 74 73 20 69 6e 20 74 | 68 65 20 63 75 72 72 65 |nts in t|he curre|
|00002980| 6e 74 20 76 65 72 73 69 | 6f 6e 2e 20 5c 5c 0d 0a |nt versi|on. \\..|
|00002990| 5c 76 65 72 62 2b 70 72 | 69 6e 74 20 61 72 67 2b |\verb+pr|int arg+|
|000029a0| 20 26 20 50 72 69 6e 74 | 20 74 68 65 20 76 61 6c | & Print| the val|
|000029b0| 75 65 20 6f 66 20 61 20 | 73 79 6d 62 6f 6c 20 6f |ue of a |symbol o|
|000029c0| 72 20 72 65 67 69 73 74 | 65 72 20 61 72 67 75 6d |r regist|er argum|
|000029d0| 65 6e 74 2e 20 5c 5c 0d | 0a 5c 76 65 72 62 2b 76 |ent. \\.|.\verb+v|
|000029e0| 65 72 62 6f 73 65 2b 20 | 26 20 54 6f 67 67 6c 65 |erbose+ |& Toggle|
|000029f0| 20 74 68 65 20 76 65 72 | 62 6f 73 65 20 66 6c 61 | the ver|bose fla|
|00002a00| 67 2e 20 5c 5c 0d 0a 5c | 76 65 72 62 2b 68 61 6e |g. \\..\|verb+han|
|00002a10| 64 6c 65 20 6e 20 61 72 | 67 2b 20 26 20 43 6f 6e |dle n ar|g+ & Con|
|00002a20| 74 72 6f 6c 20 73 69 67 | 6e 61 6c 20 68 61 6e 64 |trol sig|nal hand|
|00002a30| 6c 69 6e 67 20 66 6f 72 | 20 73 69 67 6e 61 6c 20 |ling for| signal |
|00002a40| 6e 2e 20 4f 70 74 69 6f | 6e 73 0d 0a 61 72 65 20 |n. Optio|ns..are |
|00002a50| 5b 6e 6f 5d 73 74 6f 70 | 20 6f 72 20 5b 6e 6f 5d |[no]stop| or [no]|
|00002a60| 70 72 69 6e 74 2e 20 5c | 5c 0d 0a 5c 76 65 72 62 |print. \|\..\verb|
|00002a70| 2b 64 69 73 61 73 73 65 | 6d 62 6c 65 20 5b 61 72 |+disasse|mble [ar|
|00002a80| 67 73 5d 2b 20 26 20 44 | 69 73 61 73 73 65 6d 62 |gs]+ & D|isassemb|
|00002a90| 6c 65 20 63 6f 64 65 20 | 73 74 61 72 74 69 6e 67 |le code |starting|
|00002aa0| 20 61 74 20 74 68 65 20 | 50 43 20 6f 72 20 73 70 | at the |PC or sp|
|00002ab0| 65 63 69 66 69 65 64 0d | 0a 61 72 67 75 6d 65 6e |ecified.|.argumen|
|00002ac0| 74 28 73 29 2e 20 5c 5c | 0d 0a 5c 76 65 72 62 2b |t(s). \\|..\verb+|
|00002ad0| 64 65 6c 65 74 65 20 5b | 61 72 67 5d 2b 20 26 20 |delete [|arg]+ & |
|00002ae0| 44 65 6c 65 74 65 20 73 | 6f 6d 65 20 6f 72 20 61 |Delete s|ome or a|
|00002af0| 6c 6c 20 62 72 65 61 6b | 70 6f 69 6e 74 73 2e 20 |ll break|points. |
|00002b00| 5c 5c 0d 0a 5c 76 65 72 | 62 2b 61 64 64 72 65 73 |\\..\ver|b+addres|
|00002b10| 73 20 61 72 67 2b 20 26 | 20 50 72 69 6e 74 20 74 |s arg+ &| Print t|
|00002b20| 68 65 20 61 64 64 72 65 | 73 73 20 6f 66 20 61 20 |he addre|ss of a |
|00002b30| 73 79 6d 62 6f 6c 2e 20 | 5c 5c 0d 0a 5c 76 65 72 |symbol. |\\..\ver|
|00002b40| 62 2b 74 72 61 63 65 20 | 61 72 67 2b 20 26 20 54 |b+trace |arg+ & T|
|00002b50| 75 72 6e 20 6f 6e 20 63 | 6f 64 65 2f 64 61 74 61 |urn on c|ode/data|
|00002b60| 20 74 72 61 63 69 6e 67 | 20 61 73 20 77 69 74 68 | tracing| as with|
|00002b70| 20 2d 63 2f 2d 64 20 6f | 6e 20 63 6f 6d 6d 61 6e | -c/-d o|n comman|
|00002b80| 64 20 6c 69 6e 65 2e 20 | 5c 5c 0d 0a 5c 76 65 72 |d line. |\\..\ver|
|00002b90| 62 2b 75 6e 74 72 61 63 | 65 20 5b 61 72 67 5d 2b |b+untrac|e [arg]+|
|00002ba0| 20 26 20 54 75 72 6e 20 | 6f 66 66 20 63 6f 64 65 | & Turn |off code|
|00002bb0| 2f 64 61 74 61 20 74 72 | 61 63 69 6e 67 2e 20 5c |/data tr|acing. \|
|00002bc0| 5c 0d 0a 5c 76 65 72 62 | 2b 6c 69 73 74 20 5b 61 |\..\verb|+list [a|
|00002bd0| 72 67 73 5d 2b 20 26 20 | 4c 69 73 74 20 73 6f 75 |rgs]+ & |List sou|
|00002be0| 72 63 65 20 63 6f 64 65 | 20 73 74 61 72 74 69 6e |rce code| startin|
|00002bf0| 67 20 61 74 20 74 68 65 | 20 50 43 20 6f 72 20 73 |g at the| PC or s|
|00002c00| 70 65 63 69 66 69 65 64 | 20 6c 69 6e 65 0d 0a 6e |pecified| line..n|
|00002c10| 75 6d 62 65 72 28 73 29 | 2e 20 5c 5c 0d 0a 5c 76 |umber(s)|. \\..\v|
|00002c20| 65 72 62 2b 6e 65 78 74 | 2b 20 26 20 20 53 74 65 |erb+next|+ & Ste|
|00002c30| 70 20 74 6f 20 74 68 65 | 20 6e 65 78 74 20 6c 69 |p to the| next li|
|00002c40| 6e 65 20 6f 66 20 63 6f | 64 65 2e 5c 5c 0d 0a 5c |ne of co|de.\\..\|
|00002c50| 65 6e 64 7b 74 61 62 75 | 6c 61 72 7d 0d 0a 0d 0a |end{tabu|lar}....|
|00002c60| 4f 6e 6c 79 20 65 6e 6f | 75 67 68 20 63 68 61 72 |Only eno|ugh char|
|00002c70| 61 63 74 65 72 73 20 74 | 6f 20 75 6e 69 71 75 65 |acters t|o unique|
|00002c80| 6c 79 20 73 70 65 63 69 | 66 79 20 61 20 64 65 62 |ly speci|fy a deb|
|00002c90| 75 67 67 65 72 0d 0a 63 | 6f 6d 6d 61 6e 64 20 61 |ugger..c|ommand a|
|00002ca0| 72 65 20 6e 65 63 65 73 | 73 61 72 79 2e 20 20 4d |re neces|sary. M|
|00002cb0| 6f 73 74 20 6f 66 20 74 | 68 65 20 63 6f 6d 6d 61 |ost of t|he comma|
|00002cc0| 6e 64 73 20 61 72 65 20 | 70 61 74 74 65 72 6e 65 |nds are |patterne|
|00002cd0| 64 0d 0a 61 66 74 65 72 | 20 74 68 65 20 47 44 42 |d..after| the GDB|
|00002ce0| 20 63 6f 6d 6d 61 6e 64 | 20 69 6e 74 65 72 66 61 | command| interfa|
|00002cf0| 63 65 2e 0d 0a 44 65 62 | 75 67 67 65 72 20 61 72 |ce...Deb|ugger ar|
|00002d00| 67 75 6d 65 6e 74 73 20 | 6d 75 73 74 20 62 65 20 |guments |must be |
|00002d10| 73 65 70 61 72 61 74 65 | 64 20 62 79 20 73 70 61 |separate|d by spa|
|00002d20| 63 65 73 2e 0d 0a 41 6e | 79 20 64 65 62 75 67 67 |ces...An|y debugg|
|00002d30| 65 72 20 69 6e 70 75 74 | 20 6c 69 6e 65 20 77 69 |er input| line wi|
|00002d40| 74 68 20 5c 76 65 72 62 | 2b 27 23 27 2b 20 69 6e |th \verb|+'#'+ in|
|00002d50| 20 63 6f 6c 75 6d 6e 20 | 30 20 69 73 20 69 67 6e | column |0 is ign|
|00002d60| 6f 72 65 64 2e 0d 0a 54 | 68 65 20 72 65 67 69 73 |ored...T|he regis|
|00002d70| 74 65 72 20 6e 61 6d 65 | 73 20 72 65 63 6f 67 6e |ter name|s recogn|
|00002d80| 69 7a 65 64 20 62 79 20 | 74 68 65 20 64 65 62 75 |ized by |the debu|
|00002d90| 67 67 65 72 20 69 6e 63 | 6c 75 64 65 3a 0d 0a 0d |gger inc|lude:...|
|00002da0| 0a 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |.\begin{|verbatim|
|00002db0| 7d 0d 0a 20 20 24 67 30 | 2c 20 20 24 67 31 2c 20 |}.. $g0|, $g1, |
|00002dc0| 20 24 67 32 2c 20 20 24 | 67 33 2c 20 20 24 67 34 | $g2, $|g3, $g4|
|00002dd0| 2c 20 20 24 67 35 2c 20 | 20 24 67 36 2c 20 20 24 |, $g5, | $g6, $|
|00002de0| 67 37 2c 20 0d 0a 20 20 | 24 6f 30 2c 20 20 24 6f |g7, .. |$o0, $o|
|00002df0| 31 2c 20 20 24 6f 32 2c | 20 20 24 6f 33 2c 20 20 |1, $o2,| $o3, |
|00002e00| 24 6f 34 2c 20 20 24 6f | 35 2c 20 20 24 73 70 2c |$o4, $o|5, $sp,|
|00002e10| 20 20 24 6f 37 2c 20 0d | 0a 20 20 24 6c 30 2c 20 | $o7, .|. $l0, |
|00002e20| 20 24 6c 31 2c 20 20 24 | 6c 32 2c 20 20 24 6c 33 | $l1, $|l2, $l3|
|00002e30| 2c 20 20 24 6c 34 2c 20 | 20 24 6c 35 2c 20 20 24 |, $l4, | $l5, $|
|00002e40| 6c 36 2c 20 20 24 6c 37 | 2c 20 0d 0a 20 20 24 69 |l6, $l7|, .. $i|
|00002e50| 30 2c 20 20 24 69 31 2c | 20 20 24 69 32 2c 20 20 |0, $i1,| $i2, |
|00002e60| 24 69 33 2c 20 20 24 69 | 34 2c 20 20 24 69 35 2c |$i3, $i|4, $i5,|
|00002e70| 20 20 24 66 70 2c 20 20 | 24 69 37 2c 20 0d 0a 20 | $fp, |$i7, .. |
|00002e80| 20 24 66 30 2c 20 20 24 | 66 31 2c 20 20 24 66 32 | $f0, $|f1, $f2|
|00002e90| 2c 20 20 24 66 33 2c 20 | 20 24 66 34 2c 20 20 24 |, $f3, | $f4, $|
|00002ea0| 66 35 2c 20 20 24 66 36 | 2c 20 20 24 66 37 2c 20 |f5, $f6|, $f7, |
|00002eb0| 0d 0a 20 20 24 66 38 2c | 20 20 24 66 39 2c 20 20 |.. $f8,| $f9, |
|00002ec0| 24 66 31 30 2c 20 24 66 | 31 31 2c 20 24 66 31 32 |$f10, $f|11, $f12|
|00002ed0| 2c 20 24 66 31 33 2c 20 | 24 66 31 34 2c 20 24 66 |, $f13, |$f14, $f|
|00002ee0| 31 35 2c 20 0d 0a 20 20 | 24 66 31 36 2c 20 24 66 |15, .. |$f16, $f|
|00002ef0| 31 37 2c 20 24 66 31 38 | 2c 20 24 66 31 39 2c 20 |17, $f18|, $f19, |
|00002f00| 24 66 32 30 2c 20 24 66 | 32 31 2c 20 24 66 32 32 |$f20, $f|21, $f22|
|00002f10| 2c 20 24 66 32 33 2c 20 | 0d 0a 20 20 24 66 32 34 |, $f23, |.. $f24|
|00002f20| 2c 20 24 66 32 35 2c 20 | 24 66 32 36 2c 20 24 66 |, $f25, |$f26, $f|
|00002f30| 32 37 2c 20 24 66 32 38 | 2c 20 24 66 32 39 2c 20 |27, $f28|, $f29, |
|00002f40| 24 66 33 30 2c 20 24 66 | 33 31 2c 20 0d 0a 20 20 |$f30, $f|31, .. |
|00002f50| 24 70 63 2c 20 20 24 6e | 70 63 2c 20 24 79 2c 20 |$pc, $n|pc, $y, |
|00002f60| 20 20 24 66 73 72 2c 20 | 24 63 61 72 2c 20 24 7a | $fsr, |$car, $z|
|00002f70| 65 72 2c 20 24 6f 76 66 | 2c 20 24 6e 65 67 0d 0a |er, $ovf|, $neg..|
|00002f80| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |\end{ver|batim}..|
|00002f90| 0d 0a 0d 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 2a |....\sub|section*|
|00002fa0| 7b 53 79 73 74 65 6d 20 | 43 61 6c 6c 73 7d 0d 0a |{System |Calls}..|
|00002fb0| 54 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 73 79 |The foll|owing sy|
|00002fc0| 73 74 65 6d 20 63 61 6c | 6c 73 20 61 72 65 20 73 |stem cal|ls are s|
|00002fd0| 75 70 70 6f 72 74 65 64 | 20 69 6e 20 74 68 65 20 |upported| in the |
|00002fe0| 4d 53 44 4f 53 0d 0a 76 | 65 72 73 69 6f 6e 20 6f |MSDOS..v|ersion o|
|00002ff0| 66 20 73 73 69 6d 2e 20 | 20 41 6c 6c 20 73 75 70 |f ssim. | All sup|
|00003000| 70 6f 72 74 65 64 20 73 | 79 73 74 65 6d 20 63 61 |ported s|ystem ca|
|00003010| 6c 6c 73 20 61 72 65 20 | 73 75 62 6a 65 63 74 0d |lls are |subject.|
|00003020| 0a 74 6f 20 61 6e 79 20 | 61 70 70 6c 69 63 61 62 |.to any |applicab|
|00003030| 6c 65 20 4d 53 44 4f 53 | 20 6c 69 6d 69 74 61 74 |le MSDOS| limitat|
|00003040| 69 6f 6e 2e 0d 0a 0d 0a | 5c 62 65 67 69 6e 7b 76 |ion.....|\begin{v|
|00003050| 65 72 62 61 74 69 6d 7d | 0d 0a 31 3a 20 65 78 69 |erbatim}|..1: exi|
|00003060| 74 20 20 20 20 20 31 30 | 3a 20 75 6e 6c 69 6e 6b |t 10|: unlink|
|00003070| 20 20 20 20 33 33 3a 20 | 61 63 63 65 73 73 20 20 | 33: |access |
|00003080| 20 20 36 34 3a 20 67 65 | 74 70 61 67 65 73 69 7a | 64: ge|tpagesiz|
|00003090| 65 0d 0a 33 3a 20 72 65 | 61 64 20 20 20 20 20 31 |e..3: re|ad 1|
|000030a0| 32 3a 20 63 68 64 69 72 | 20 20 20 20 20 33 37 3a |2: chdir| 37:|
|000030b0| 20 6b 69 6c 6c 20 20 20 | 20 20 20 31 30 38 3a 20 | kill | 108: |
|000030c0| 73 69 67 76 65 63 0d 0a | 34 3a 20 77 72 69 74 65 |sigvec..|4: write|
|000030d0| 20 20 20 20 31 37 3a 20 | 73 62 72 6b 20 20 20 20 | 17: |sbrk |
|000030e0| 20 20 33 38 3a 20 73 74 | 61 74 20 20 20 20 20 20 | 38: st|at |
|000030f0| 31 33 36 3a 20 6d 6b 64 | 69 72 0d 0a 35 3a 20 6f |136: mkd|ir..5: o|
|00003100| 70 65 6e 20 20 20 20 20 | 31 39 3a 20 6c 73 65 65 |pen |19: lsee|
|00003110| 6b 20 20 20 20 20 34 37 | 3a 20 67 65 74 67 69 64 |k 47|: getgid|
|00003120| 20 20 20 20 31 33 37 3a | 20 72 6d 64 69 72 0d 0a | 137:| rmdir..|
|00003130| 36 3a 20 63 6c 6f 73 65 | 20 20 20 20 32 30 3a 20 |6: close| 20: |
|00003140| 67 65 74 70 69 64 20 20 | 20 20 35 34 3a 20 69 6f |getpid | 54: io|
|00003150| 63 74 6c 20 20 20 20 20 | 31 33 39 3a 20 73 65 74 |ctl |139: set|
|00003160| 63 6f 6e 74 65 78 74 0d | 0a 38 3a 20 63 72 65 61 |context.|.8: crea|
|00003170| 74 20 20 20 20 32 34 3a | 20 67 65 74 75 69 64 20 |t 24:| getuid |
|00003180| 20 20 20 36 32 3a 20 66 | 73 74 61 74 0d 0a 5c 65 | 62: f|stat..\e|
|00003190| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 0d 0a 0d 0a |nd{verba|tim}....|
|000031a0| 54 68 65 20 67 65 74 70 | 69 64 28 29 20 63 61 6c |The getp|id() cal|
|000031b0| 6c 20 61 6c 77 61 79 73 | 20 72 65 74 75 72 6e 73 |l always| returns|
|000031c0| 20 30 78 32 30 30 30 2e | 20 20 53 69 6d 69 6c 61 | 0x2000.| Simila|
|000031d0| 72 6c 79 2c 20 67 65 74 | 75 69 64 28 29 0d 0a 61 |rly, get|uid()..a|
|000031e0| 6c 77 61 79 73 20 72 65 | 74 75 72 6e 73 20 31 30 |lways re|turns 10|
|000031f0| 30 2e 20 20 54 68 65 20 | 6b 69 6c 6c 28 29 20 63 |0. The |kill() c|
|00003200| 61 6c 6c 20 72 65 74 75 | 72 6e 73 20 45 49 4e 56 |all retu|rns EINV|
|00003210| 41 4c 20 69 66 20 74 68 | 65 20 73 69 67 6e 61 6c |AL if th|e signal|
|00003220| 0d 0a 69 73 20 73 65 6e | 74 20 74 6f 20 61 6e 79 |..is sen|t to any|
|00003230| 20 70 72 6f 63 65 73 73 | 20 6f 74 68 65 72 20 74 | process| other t|
|00003240| 68 61 6e 20 30 78 32 30 | 30 30 2e 20 20 54 68 65 |han 0x20|00. The|
|00003250| 20 67 65 74 67 69 64 28 | 29 20 63 61 6c 6c 0d 0a | getgid(|) call..|
|00003260| 61 6c 77 61 79 73 20 72 | 65 74 75 72 6e 73 20 31 |always r|eturns 1|
|00003270| 30 2e 20 20 49 6f 63 74 | 6c 28 29 20 63 61 6c 6c |0. Ioct|l() call|
|00003280| 73 20 77 69 6c 6c 20 61 | 6c 6d 6f 73 74 20 63 65 |s will a|lmost ce|
|00003290| 72 74 61 69 6e 6c 79 20 | 6e 6f 74 0d 0a 68 61 76 |rtainly |not..hav|
|000032a0| 65 20 74 68 65 20 64 65 | 73 69 72 65 64 20 65 66 |e the de|sired ef|
|000032b0| 66 65 63 74 2e 20 20 54 | 68 65 20 73 65 74 63 6f |fect. T|he setco|
|000032c0| 6e 74 65 78 74 28 29 20 | 63 61 6c 6c 20 69 73 20 |ntext() |call is |
|000032d0| 75 73 65 64 20 74 6f 0d | 0a 72 65 74 75 72 6e 20 |used to.|.return |
|000032e0| 66 72 6f 6d 20 74 68 65 | 20 73 69 67 74 72 61 6d |from the| sigtram|
|000032f0| 70 20 73 69 67 6e 61 6c | 20 68 61 6e 64 6c 65 72 |p signal| handler|
|00003300| 20 64 69 73 70 61 74 63 | 68 65 72 2e 0d 0a 0d 0a | dispatc|her.....|
|00003310| 5c 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 4c 69 6d |\subsect|ion*{Lim|
|00003320| 69 74 61 74 69 6f 6e 73 | 7d 0d 0a 49 6e 20 74 68 |itations|}..In th|
|00003330| 65 20 69 6e 74 65 72 65 | 73 74 20 6f 66 20 73 69 |e intere|st of si|
|00003340| 6d 70 6c 69 63 69 74 79 | 2c 20 73 73 69 6d 20 64 |mplicity|, ssim d|
|00003350| 6f 65 73 20 6e 6f 74 20 | 69 6d 70 6c 65 6d 65 6e |oes not |implemen|
|00003360| 74 20 61 6e 79 20 65 78 | 74 65 6e 64 65 64 0d 0a |t any ex|tended..|
|00003370| 70 72 65 63 69 73 69 6f | 6e 20 66 6c 6f 61 74 69 |precisio|n floati|
|00003380| 6e 67 20 70 6f 69 6e 74 | 20 69 6e 73 74 72 75 63 |ng point| instruc|
|00003390| 74 69 6f 6e 73 2e 20 20 | 41 6c 73 6f 20 74 68 65 |tions. |Also the|
|000033a0| 20 53 50 41 52 43 20 65 | 6e 76 69 72 6f 6e 6d 65 | SPARC e|nvironme|
|000033b0| 6e 74 0d 0a 69 73 20 65 | 6d 70 74 79 20 69 6e 20 |nt..is e|mpty in |
|000033c0| 74 68 65 20 63 75 72 72 | 65 6e 74 20 76 65 72 73 |the curr|ent vers|
|000033d0| 69 6f 6e 2e 20 20 41 20 | 66 75 74 75 72 65 20 76 |ion. A |future v|
|000033e0| 65 72 73 69 6f 6e 20 6f | 66 20 73 73 69 6d 20 6d |ersion o|f ssim m|
|000033f0| 61 79 20 6d 61 6b 65 0d | 0a 74 68 65 20 44 4f 53 |ay make.|.the DOS|
|00003400| 20 65 6e 76 69 72 6f 6e | 6d 65 6e 74 20 61 63 63 | environ|ment acc|
|00003410| 65 73 73 69 62 6c 65 20 | 74 6f 20 53 50 41 52 43 |essible |to SPARC|
|00003420| 20 63 6f 64 65 2e 20 20 | 49 6e 20 61 64 64 69 74 | code. |In addit|
|00003430| 69 6f 6e 2c 0d 0a 73 69 | 6e 63 65 20 74 68 65 20 |ion,..si|nce the |
|00003440| 5c 76 65 72 62 2b 6d 6d | 61 70 28 29 2b 0d 0a 73 |\verb+mm|ap()+..s|
|00003450| 79 73 74 65 6d 20 63 61 | 6c 6c 20 69 73 20 6e 6f |ystem ca|ll is no|
|00003460| 74 20 79 65 74 20 69 6d | 70 6c 65 6d 65 6e 74 65 |t yet im|plemente|
|00003470| 64 2c 20 73 73 69 6d 20 | 63 61 6e 6e 6f 74 20 65 |d, ssim |cannot e|
|00003480| 78 65 63 75 74 65 20 64 | 79 6e 61 6d 69 63 61 6c |xecute d|ynamical|
|00003490| 6c 79 0d 0a 6c 69 6e 6b | 65 64 20 65 78 65 63 75 |ly..link|ed execu|
|000034a0| 74 61 62 6c 65 73 2e 0d | 0a 0d 0a 5c 73 65 63 74 |tables..|...\sect|
|000034b0| 69 6f 6e 2a 7b 45 78 61 | 6d 70 6c 65 20 43 6f 64 |ion*{Exa|mple Cod|
|000034c0| 65 7d 0d 0a 54 68 65 20 | 63 6f 6e 66 69 64 65 6e |e}..The |confiden|
|000034d0| 63 65 20 74 65 73 74 73 | 20 63 6f 6e 74 61 69 6e |ce tests| contain|
|000034e0| 20 73 65 76 65 72 61 6c | 20 65 78 61 6d 70 6c 65 | several| example|
|000034f0| 73 20 6f 66 20 53 50 41 | 52 43 0d 0a 61 73 73 65 |s of SPA|RC..asse|
|00003500| 6d 62 6c 79 20 63 6f 64 | 65 20 74 68 61 74 20 6d |mbly cod|e that m|
|00003510| 61 79 20 62 65 20 75 73 | 65 66 75 6c 20 72 65 66 |ay be us|eful ref|
|00003520| 65 72 65 6e 63 65 73 2e | 20 20 54 68 65 72 65 20 |erences.| There |
|00003530| 61 72 65 20 65 78 61 6d | 70 6c 65 73 0d 0a 77 68 |are exam|ples..wh|
|00003540| 69 63 68 20 73 68 6f 77 | 20 74 68 65 20 75 73 65 |ich show| the use|
|00003550| 20 6f 66 20 73 69 67 6e | 61 6c 20 68 61 6e 64 6c | of sign|al handl|
|00003560| 69 6e 67 2c 20 61 63 63 | 65 73 73 69 6e 67 20 74 |ing, acc|essing t|
|00003570| 68 65 20 63 6f 6d 6d 61 | 6e 64 0d 0a 6c 69 6e 65 |he comma|nd..line|
|00003580| 20 61 6e 64 20 6f 74 68 | 65 72 20 74 68 69 6e 67 | and oth|er thing|
|00003590| 73 2e 20 20 41 6c 6c 20 | 6f 66 20 74 68 65 73 65 |s. All |of these|
|000035a0| 20 74 65 73 74 73 20 77 | 65 72 65 20 61 73 73 65 | tests w|ere asse|
|000035b0| 6d 62 6c 65 64 20 77 69 | 74 68 0d 0a 73 61 73 6d |mbled wi|th..sasm|
|000035c0| 20 61 6e 64 20 72 61 6e | 20 74 68 65 20 73 61 6d | and ran| the sam|
|000035d0| 65 20 28 65 78 63 65 70 | 74 20 66 6f 72 20 73 70 |e (excep|t for sp|
|000035e0| 65 65 64 2c 20 6f 66 20 | 63 6f 75 72 73 65 29 20 |eed, of |course) |
|000035f0| 6f 6e 20 61 0d 0a 53 70 | 61 72 63 53 74 61 74 69 |on a..Sp|arcStati|
|00003600| 6f 6e 20 32 20 70 6c 61 | 74 66 6f 72 6d 20 61 73 |on 2 pla|tform as|
|00003610| 20 74 68 65 79 20 64 6f | 20 75 6e 64 65 72 20 73 | they do| under s|
|00003620| 73 69 6d 2e 20 20 53 6f | 6d 65 20 6f 66 20 74 68 |sim. So|me of th|
|00003630| 65 6d 0d 0a 75 73 65 20 | 74 68 65 20 65 78 69 74 |em..use |the exit|
|00003640| 20 73 74 61 74 75 73 20 | 74 6f 20 63 6f 6d 6d 75 | status |to commu|
|00003650| 6e 69 63 61 74 65 20 69 | 6e 66 6f 72 6d 61 74 69 |nicate i|nformati|
|00003660| 6f 6e 2e 0d 0a 0d 0a 5c | 73 65 63 74 69 6f 6e 2a |on.....\|section*|
|00003670| 7b 44 69 73 61 73 73 65 | 6d 62 6c 65 72 7d 0d 0a |{Disasse|mbler}..|
|00003680| 44 69 73 20 69 73 20 74 | 68 65 20 53 50 41 52 43 |Dis is t|he SPARC|
|00003690| 42 65 6e 63 68 20 61 73 | 73 65 6d 62 6c 65 72 2e |Bench as|sembler.|
|000036a0| 20 20 49 74 20 61 74 74 | 65 6d 70 74 73 20 74 6f | It att|empts to|
|000036b0| 20 64 69 73 61 73 73 65 | 6d 62 6c 65 0d 0a 74 68 | disasse|mble..th|
|000036c0| 65 20 74 65 78 74 20 73 | 65 67 6d 65 6e 74 20 6f |e text s|egment o|
|000036d0| 66 20 53 50 41 52 43 20 | 65 78 65 63 75 74 61 62 |f SPARC |executab|
|000036e0| 6c 65 73 2e 20 20 49 66 | 20 74 68 65 20 5c 76 65 |les. If| the \ve|
|000036f0| 72 62 2b 2d 72 2b 20 28 | 72 61 77 29 20 6f 70 74 |rb+-r+ (|raw) opt|
|00003700| 69 6f 6e 20 69 73 0d 0a | 67 69 76 65 6e 2c 20 64 |ion is..|given, d|
|00003710| 69 73 61 73 73 65 6d 62 | 6c 79 20 73 74 61 72 74 |isassemb|ly start|
|00003720| 73 20 61 74 20 74 68 65 | 20 66 69 72 73 74 20 77 |s at the| first w|
|00003730| 6f 72 64 20 69 6e 20 74 | 68 65 20 66 69 6c 65 2e |ord in t|he file.|
|00003740| 20 20 4f 74 68 65 72 77 | 69 73 65 2c 0d 0a 74 68 | Otherw|ise,..th|
|00003750| 65 20 33 32 20 62 79 74 | 65 20 65 78 65 63 75 74 |e 32 byt|e execut|
|00003760| 61 62 6c 65 20 68 65 61 | 64 65 72 20 69 73 20 73 |able hea|der is s|
|00003770| 6b 69 70 70 65 64 2e 20 | 20 54 68 65 20 5c 76 65 |kipped. | The \ve|
|00003780| 72 62 2b 2d 6e 2b 20 6f | 70 74 69 6f 6e 20 61 6c |rb+-n+ o|ption al|
|00003790| 73 6f 0d 0a 69 73 20 61 | 76 61 69 6c 61 62 6c 65 |so..is a|vailable|
|000037a0| 20 61 6e 64 20 70 72 65 | 76 65 6e 74 73 20 74 68 | and pre|vents th|
|000037b0| 65 20 76 65 72 73 69 6f | 6e 2f 63 6f 70 79 72 69 |e versio|n/copyri|
|000037c0| 67 68 74 20 62 61 6e 6e | 65 72 20 66 72 6f 6d 20 |ght bann|er from |
|000037d0| 62 65 69 6e 67 20 70 72 | 69 6e 74 65 64 2e 0d 0a |being pr|inted...|
|000037e0| 0d 0a 5c 73 65 63 74 69 | 6f 6e 2a 7b 53 75 70 70 |..\secti|on*{Supp|
|000037f0| 6f 72 74 20 61 6e 64 20 | 4c 69 63 65 6e 73 69 6e |ort and |Licensin|
|00003800| 67 7d 0d 0a 49 66 20 75 | 6e 65 78 70 65 63 74 65 |g}..If u|nexpecte|
|00003810| 64 20 6f 70 65 72 61 74 | 69 6f 6e 20 69 73 20 65 |d operat|ion is e|
|00003820| 6e 63 6f 75 6e 74 65 72 | 65 64 2c 20 74 68 65 20 |ncounter|ed, the |
|00003830| 66 6f 6c 6c 6f 77 69 6e | 67 20 70 72 6f 63 65 64 |followin|g proced|
|00003840| 75 72 65 0d 0a 6f 75 67 | 68 74 20 74 6f 20 62 65 |ure..oug|ht to be|
|00003850| 20 75 73 65 64 20 74 6f | 20 63 6f 6d 6d 75 6e 69 | used to| communi|
|00003860| 63 61 74 65 20 61 20 62 | 75 67 20 72 65 70 6f 72 |cate a b|ug repor|
|00003870| 74 20 74 6f 20 45 6c 65 | 63 74 72 6f 6e 65 74 69 |t to Ele|ctroneti|
|00003880| 63 73 2c 20 49 6e 63 2e | 0d 0a 0d 0a 46 69 72 73 |cs, Inc.|....Firs|
|00003890| 74 2c 20 74 72 79 20 74 | 6f 20 69 73 6f 6c 61 74 |t, try t|o isolat|
|000038a0| 65 20 74 68 65 20 70 72 | 6f 62 6c 65 6d 20 61 73 |e the pr|oblem as|
|000038b0| 20 6d 75 63 68 20 61 73 | 20 70 6f 73 73 69 62 6c | much as| possibl|
|000038c0| 65 20 77 69 74 68 20 74 | 68 65 0d 0a 73 73 69 6d |e with t|he..ssim|
|000038d0| 20 64 65 62 75 67 67 65 | 72 2e 20 20 57 72 69 74 | debugge|r. Writ|
|000038e0| 65 20 61 20 73 68 6f 72 | 74 20 73 65 6c 66 2d 63 |e a shor|t self-c|
|000038f0| 6f 6e 74 61 69 6e 65 64 | 20 53 50 41 52 43 20 61 |ontained| SPARC a|
|00003900| 73 73 65 6d 62 6c 65 72 | 20 66 69 6c 65 0d 0a 77 |ssembler| file..w|
|00003910| 68 69 63 68 20 73 68 6f | 75 6c 64 20 62 65 20 61 |hich sho|uld be a|
|00003920| 63 63 65 70 74 61 62 6c | 65 20 74 6f 20 73 61 73 |cceptabl|e to sas|
|00003930| 6d 2e 20 20 53 65 6e 64 | 20 69 74 20 77 69 74 68 |m. Send| it with|
|00003940| 20 61 6e 20 65 78 70 6c | 61 6e 61 74 69 6f 6e 0d | an expl|anation.|
|00003950| 0a 6f 66 20 74 68 65 20 | 75 6e 65 78 70 65 63 74 |.of the |unexpect|
|00003960| 65 64 20 62 65 68 61 76 | 69 6f 72 20 74 6f 20 74 |ed behav|ior to t|
|00003970| 68 65 20 61 64 64 72 65 | 73 73 20 62 65 6c 6f 77 |he addre|ss below|
|00003980| 2e 20 20 0d 0a 0d 0a 5c | 62 65 67 69 6e 7b 63 65 |. ....\|begin{ce|
|00003990| 6e 74 65 72 7d 0d 0a 5c | 62 65 67 69 6e 7b 76 65 |nter}..\|begin{ve|
|000039a0| 72 62 61 74 69 6d 7d 0d | 0a 45 6c 65 63 74 72 6f |rbatim}.|.Electro|
|000039b0| 6e 65 74 69 63 73 2c 20 | 49 6e 63 2e 0d 0a 33 31 |netics, |Inc...31|
|000039c0| 30 31 20 31 31 31 74 68 | 20 53 74 72 65 65 74 20 |01 111th| Street |
|000039d0| 53 2e 57 2e 0d 0a 45 76 | 65 72 65 74 74 2c 20 57 |S.W...Ev|erett, W|
|000039e0| 41 20 20 39 38 32 30 34 | 0d 0a 5c 65 6e 64 7b 76 |A 98204|..\end{v|
|000039f0| 65 72 62 61 74 69 6d 7d | 0d 0a 5c 65 6e 64 7b 63 |erbatim}|..\end{c|
|00003a00| 65 6e 74 65 72 7d 0d 0a | 0d 0a 54 68 65 20 53 50 |enter}..|..The SP|
|00003a10| 41 52 43 42 65 6e 63 68 | 20 74 6f 6f 6c 73 20 61 |ARCBench| tools a|
|00003a20| 72 65 20 69 6d 70 6c 65 | 6d 65 6e 74 65 64 20 69 |re imple|mented i|
|00003a30| 6e 20 43 20 61 6e 64 20 | 61 72 65 20 61 76 61 69 |n C and |are avai|
|00003a40| 6c 61 62 6c 65 20 6f 6e | 20 53 75 6e 0d 0a 61 6e |lable on| Sun..an|
|00003a50| 64 20 41 70 6f 6c 6c 6f | 20 77 6f 72 6b 73 74 61 |d Apollo| worksta|
|00003a60| 74 69 6f 6e 73 20 61 73 | 20 77 65 6c 6c 20 61 73 |tions as| well as|
|00003a70| 20 4d 53 44 4f 53 20 68 | 61 72 64 77 61 72 65 2e | MSDOS h|ardware.|
|00003a80| 20 20 54 68 65 79 20 61 | 72 65 20 43 6f 70 79 72 | They a|re Copyr|
|00003a90| 69 67 68 74 0d 0a 45 6c | 65 63 74 72 6f 6e 65 74 |ight..El|ectronet|
|00003aa0| 69 63 73 2c 20 49 6e 63 | 2e 20 31 39 39 32 2e 20 |ics, Inc|. 1992. |
|00003ab0| 54 68 65 20 62 69 6e 61 | 72 79 20 4d 53 44 4f 53 |The bina|ry MSDOS|
|00003ac0| 20 76 65 72 73 69 6f 6e | 20 6f 66 20 74 68 65 20 | version| of the |
|00003ad0| 74 6f 6f 6c 73 20 6d 61 | 79 0d 0a 62 65 20 66 72 |tools ma|y..be fr|
|00003ae0| 65 65 6c 79 20 72 65 64 | 69 73 74 72 69 62 75 74 |eely red|istribut|
|00003af0| 65 64 20 69 6e 20 69 74 | 73 20 6f 72 69 67 69 6e |ed in it|s origin|
|00003b00| 61 6c 20 5a 4f 4f 20 61 | 72 63 68 69 76 65 20 66 |al ZOO a|rchive f|
|00003b10| 6f 72 6d 61 74 2e 20 20 | 4f 74 68 65 72 0d 0a 64 |ormat. |Other..d|
|00003b20| 69 73 74 72 69 62 75 74 | 69 6f 6e 20 69 73 20 6e |istribut|ion is n|
|00003b30| 6f 74 20 61 6c 6c 6f 77 | 65 64 2e 20 20 41 20 63 |ot allow|ed. A c|
|00003b40| 6f 70 79 20 6f 66 20 74 | 68 65 20 63 75 72 72 65 |opy of t|he curre|
|00003b50| 6e 74 20 4d 53 44 4f 53 | 20 62 69 6e 61 72 79 0d |nt MSDOS| binary.|
|00003b60| 0a 6d 61 79 20 62 65 20 | 6f 62 74 61 69 6e 65 64 |.may be |obtained|
|00003b70| 20 62 79 20 73 65 6e 64 | 69 6e 67 20 55 53 24 31 | by send|ing US$1|
|00003b80| 35 20 74 6f 20 45 6c 65 | 63 74 72 6f 6e 65 74 69 |5 to Ele|ctroneti|
|00003b90| 63 73 20 61 74 20 74 68 | 65 20 61 62 6f 76 65 20 |cs at th|e above |
|00003ba0| 61 64 64 72 65 73 73 2e | 0d 0a 43 6f 6d 70 6c 65 |address.|..Comple|
|00003bb0| 74 65 20 43 20 73 6f 75 | 72 63 65 20 63 6f 64 65 |te C sou|rce code|
|00003bc0| 20 69 73 20 61 76 61 69 | 6c 61 62 6c 65 20 66 6f | is avai|lable fo|
|00003bd0| 72 20 55 53 24 31 35 30 | 2e 0d 0a 41 64 64 69 74 |r US$150|...Addit|
|00003be0| 69 6f 6e 61 6c 20 74 6f | 6f 6c 73 20 6d 61 79 20 |ional to|ols may |
|00003bf0| 62 65 20 61 64 64 65 64 | 20 74 6f 20 74 68 65 20 |be added| to the |
|00003c00| 70 61 63 6b 61 67 65 20 | 69 6e 20 66 75 74 75 72 |package |in futur|
|00003c10| 65 0d 0a 76 65 72 73 69 | 6f 6e 73 2e 20 20 50 6c |e..versi|ons. Pl|
|00003c20| 65 61 73 65 20 63 6f 6e | 74 61 63 74 20 45 6c 65 |ease con|tact Ele|
|00003c30| 63 74 72 6f 6e 65 74 69 | 63 73 2c 20 49 6e 63 2e |ctroneti|cs, Inc.|
|00003c40| 20 20 61 74 20 74 68 65 | 20 61 62 6f 76 65 20 61 | at the| above a|
|00003c50| 64 64 72 65 73 73 0d 0a | 66 6f 72 20 66 75 72 74 |ddress..|for furt|
|00003c60| 68 65 72 20 64 65 74 61 | 69 6c 73 2e 0d 0a 0d 0a |her deta|ils.....|
|00003c70| 53 50 41 52 43 20 69 73 | 20 61 20 74 72 61 64 65 |SPARC is| a trade|
|00003c80| 6d 61 72 6b 20 6f 66 20 | 53 75 6e 20 4d 69 63 72 |mark of |Sun Micr|
|00003c90| 6f 73 79 73 74 65 6d 73 | 2c 20 49 6e 63 2e 0d 0a |osystems|, Inc...|
|00003ca0| 5c 65 6e 64 7b 64 6f 63 | 75 6d 65 6e 74 7d 0d 0a |\end{doc|ument}..|
+--------+-------------------------+-------------------------+--------+--------+