|
DataMuseum.dkPresents historical artifacts from the history of: Rational R1000/400 Tapes |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about Rational R1000/400 Tapes Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - downloadIndex: ┃ S ┃
Length: 8705 (0x2201)
Names: »SUNADA_HELP«
└─⟦516dceb10⟧ Bits:30000751 8mm tape, Rational 1000, RCI_VADS
└─ ⟦9a14c9417⟧ »DATA«
└─⟦this⟧
0x0000…0020 0a 61 64 61 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 41 44 53 20 52 ┆ ada VADS R┆ 0x0020…0040 65 66 65 72 65 6e 63 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 ┆eference a┆ 0x0040…0060 64 61 0a 0a 20 20 20 20 20 61 64 61 0a 0a 20 20 20 20 20 20 20 20 20 41 64 61 20 63 6f 6d 70 69 ┆da ada Ada compi┆ 0x0060…0080 6c 65 72 0a 0a 20 20 20 20 20 53 79 6e 74 61 78 0a 0a 20 20 20 20 20 61 64 61 20 5b 6f 70 74 69 ┆ler Syntax ada [opti┆ 0x0080…00a0 6f 6e 73 5d 20 5b 73 6f 75 72 63 65 5f 66 69 6c 65 5d 2e 2e 2e 20 5b 6c 69 6e 6b 65 72 5f 6f 70 ┆ons] [source_file]... [linker_op┆ 0x00a0…00c0 74 69 6f 6e 73 5d 0a 20 20 20 20 20 5b 6f 62 6a 65 63 74 5f 66 69 6c 65 2e 6f 5d 2e 2e 2e 0a 0a ┆tions] [object_file.o]... ┆ 0x00c0…00e0 20 20 20 20 20 4f 70 74 69 6f 6e 73 0a 0a 20 20 20 20 20 2d 23 20 69 64 65 6e 74 69 66 69 65 72 ┆ Options -# identifier┆ 0x00e0…0100 20 74 79 70 65 20 76 61 6c 75 65 20 28 64 65 66 69 6e 65 29 20 44 65 66 69 6e 65 20 61 6e 20 69 ┆ type value (define) Define an i┆ 0x0100…0120 64 65 6e 74 69 66 69 65 72 20 6f 66 20 61 0a 20 20 20 20 20 73 70 65 63 69 66 69 65 64 20 74 79 ┆dentifier of a specified ty┆ 0x0120…0140 70 65 20 61 6e 64 20 76 61 6c 75 65 2e 20 53 65 65 20 43 68 61 70 74 65 72 20 2c 20 56 41 44 53 ┆pe and value. See Chapter , VADS┆ 0x0140…0160 20 41 44 41 0a 20 20 20 20 20 50 52 45 50 52 4f 43 45 53 53 4f 52 20 52 45 46 45 52 45 4e 43 45 ┆ ADA PREPROCESSOR REFERENCE┆ 0x0160…0180 2e 0a 0a 20 20 20 20 20 2d 61 20 66 69 6c 65 5f 6e 61 6d 65 20 20 20 28 61 72 63 68 69 76 65 29 ┆. -a file_name (archive)┆ 0x0180…01a0 20 54 72 65 61 74 20 66 69 6c 65 5f 6e 61 6d 65 20 61 73 20 61 6e 20 6f 62 6a 65 63 74 0a 20 20 ┆ Treat file_name as an object ┆ 0x01a0…01c0 20 20 20 61 72 63 68 69 76 65 20 66 69 6c 65 20 63 72 65 61 74 65 20 64 62 79 20 61 72 2e 20 53 ┆ archive file create dby ar. S┆ 0x01c0…01e0 69 6e 63 65 20 73 6f 6d 65 20 61 72 63 68 69 76 65 20 66 69 6c 65 73 20 65 6e 64 0a 20 20 20 20 ┆ince some archive files end ┆ 0x01e0…0200 20 77 69 74 68 20 2e 61 2c 20 2d 61 20 69 73 20 75 73 65 64 20 74 6f 20 64 69 73 74 69 6e 67 75 ┆ with .a, -a is used to distingu┆ 0x0200…0220 69 73 68 20 61 72 63 68 69 76 65 20 66 69 6c 65 73 20 66 72 6f 6d 20 41 64 61 0a 20 20 20 20 20 ┆ish archive files from Ada ┆ 0x0220…0240 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 0a 20 20 20 20 20 2d 64 20 20 20 28 64 65 70 65 6e 64 ┆source files. -d (depend┆ 0x0240…0260 65 6e 63 69 65 73 29 20 41 6e 61 6c 79 7a 65 20 66 6f 72 20 64 65 70 65 6e 64 65 6e 63 69 65 73 ┆encies) Analyze for dependencies┆ 0x0260…0280 20 6f 6e 6c 79 2e 20 44 6f 20 6e 6f 74 20 64 6f 0a 20 20 20 20 20 73 65 6d 61 6e 74 69 63 20 61 ┆ only. Do not do semantic a┆ 0x0280…02a0 6e 61 6c 79 73 69 73 20 6f 72 20 63 6f 64 65 20 67 65 6e 65 72 61 74 69 6f 6e 2e 20 55 70 64 61 ┆nalysis or code generation. Upda┆ 0x02a0…02c0 74 65 20 74 68 65 20 6c 69 62 72 61 72 79 2c 0a 20 20 20 20 20 6d 61 72 6b 69 6e 67 20 61 6e 79 ┆te the library, marking any┆ 0x02c0…02e0 20 64 65 66 69 6e 65 64 20 75 6e 69 74 73 20 61 73 20 75 6e 63 6f 6d 70 69 6c 65 64 2e 20 54 68 ┆ defined units as uncompiled. Th┆ 0x02e0…0300 65 20 2d 64 20 6f 70 74 69 6f 6e 20 69 73 0a 20 20 20 20 20 75 73 65 64 20 62 79 20 61 2e 6d 61 ┆e -d option is used by a.ma┆ 0x0300…0320 6b 0a 0a 20 20 20 20 20 65 20 74 6f 20 65 73 74 61 62 6c 69 73 68 20 64 65 70 65 6e 64 65 6e 63 ┆k e to establish dependenc┆ 0x0320…0340 69 65 73 20 61 6d 6f 6e 67 20 6e 65 77 20 66 69 6c 65 73 2e 0a 0a 50 72 69 6e 74 65 64 20 31 32 ┆ies among new files. Printed 12┆ 0x0340…0360 2f 32 36 2f 38 39 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 41 44 53 20 20 20 20 20 20 20 20 ┆/26/89 VADS ┆ 0x0360…0380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 0a 0a 61 64 61 20 20 20 20 ┆ 1 ada ┆ 0x0380…03a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 41 44 53 20 52 65 66 65 72 65 6e 63 65 ┆ VADS Reference┆ 0x03a0…03c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 64 61 0a 0a 20 20 20 20 ┆ ada ┆ 0x03c0…03e0 20 2d 65 20 20 20 28 65 72 72 6f 72 29 20 50 72 6f 63 65 73 73 20 63 6f 6d 70 69 6c 61 74 69 6f ┆ -e (error) Process compilatio┆ 0x03e0…0400 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 75 73 69 6e 67 20 61 2e 65 72 72 6f 0a 0a 20 ┆n error messages using a.erro ┆ 0x0400…0420 20 20 20 20 72 20 61 6e 64 20 73 65 6e 64 20 69 74 20 74 6f 20 73 74 61 6e 64 61 72 64 20 6f 75 ┆ r and send it to standard ou┆ 0x0420…0440 74 70 75 74 2e 20 4f 6e 6c 79 20 74 68 65 20 73 6f 75 72 63 65 20 6c 69 6e 65 73 0a 20 20 20 20 ┆tput. Only the source lines ┆ 0x0440…0460 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65 72 72 6f 72 73 20 61 72 65 20 6c 69 73 74 65 64 2e 20 4f ┆ containing errors are listed. O┆ 0x0460…0480 6e 6c 79 20 6f 6e 65 20 2d 65 20 6f 72 20 2d 45 20 6f 70 74 69 6f 6e 0a 20 20 20 20 20 73 68 6f ┆nly one -e or -E option sho┆ 0x0480…04a0 75 6c 64 20 62 65 20 75 73 65 64 2e 0a 0a 20 20 20 20 20 2d 45 0a 0a 20 20 20 20 20 2d 45 20 66 ┆uld be used. -E -E f┆ 0x04a0…04c0 69 6c 65 0a 0a 20 20 20 20 20 2d 45 20 64 69 72 65 63 74 6f 72 79 20 20 20 28 65 72 72 6f 72 20 ┆ile -E directory (error ┆ 0x04c0…04e0 6f 75 74 70 75 74 29 20 57 69 74 68 6f 75 74 20 61 20 66 69 6c 65 20 6f 72 20 64 69 72 65 63 74 ┆output) Without a file or direct┆ 0x04e0…0500 6f 72 79 0a 20 20 20 20 20 61 72 67 75 6d 65 6e 74 2c 20 61 64 61 20 70 72 6f 63 65 73 73 65 73 ┆ory argument, ada processes┆ 0x0500…0520 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 75 73 69 6e 67 20 61 2e 65 72 72 6f 72 20 61 6e ┆ error messages using a.error an┆ 0x0520…0540 64 0a 20 20 20 20 20 64 69 72 65 63 74 73 20 61 20 62 72 69 65 66 20 6f 75 74 70 75 74 20 74 6f ┆d directs a brief output to┆ 0x0540…0560 20 73 74 61 6e 64 61 72 64 20 6f 75 74 70 75 74 3b 20 74 68 65 20 72 61 77 20 65 72 72 6f 72 0a ┆ standard output; the raw error ┆ 0x0560…0580 20 20 20 20 20 6d 65 73 73 61 67 65 73 20 61 72 65 20 6c 65 66 74 20 69 6e 20 61 64 61 5f 73 6f ┆ messages are left in ada_so┆ 0x0580…05a0 75 72 63 65 2e 65 72 72 2e 20 49 66 20 61 20 66 69 6c 65 20 70 61 74 68 6e 61 6d 65 20 69 73 0a ┆urce.err. If a file pathname is ┆ 0x05a0…05c0 20 20 20 20 20 67 69 76 65 6e 2c 20 74 68 65 20 72 61 77 20 65 72 72 6f 72 20 6d 65 73 73 61 67 ┆ given, the raw error messag┆ 0x05c0…05e0 65 73 20 61 72 65 20 70 6c 61 63 65 64 20 69 6e 20 74 68 61 74 20 66 69 6c 65 2e 20 49 66 20 61 ┆es are placed in that file. If a┆ 0x05e0…0600 0a 20 20 20 20 20 64 69 72 65 63 74 6f 72 79 20 61 72 67 75 6d 65 6e 74 20 69 73 20 73 75 70 70 ┆ directory argument is supp┆ 0x0600…0620 6c 69 65 64 2c 20 74 68 65 20 72 61 77 20 65 72 72 6f 72 20 6f 75 74 70 75 74 20 69 73 0a 20 20 ┆lied, the raw error output is ┆ 0x0620…0640 20 20 20 70 6c 61 63 65 64 20 69 6e 20 64 69 72 2f 73 6f 75 72 63 65 2e 0a 0a 20 20 20 20 20 65 ┆ placed in dir/source. e┆ 0x0640…0660 72 72 2e 20 54 68 65 20 66 69 6c 65 20 6f 66 20 72 61 77 20 65 72 72 6f 72 20 6d 65 73 73 61 67 ┆rr. The file of raw error messag┆ 0x0660…0680 65 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 73 20 69 6e 70 75 74 20 74 6f 0a 20 20 20 20 20 ┆es can be used as input to ┆ 0x0680…06a0 61 2e 65 72 72 6f 72 0a 0a 20 20 20 20 20 2d 65 6c 20 20 28 65 72 72 6f 72 20 6c 69 73 74 69 6e ┆a.error -el (error listin┆ 0x06a0…06c0 67 29 20 49 6e 74 65 72 73 70 65 72 73 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 61 6d ┆g) Intersperse error messages am┆ 0x06c0…06e0 6f 6e 67 20 73 6f 75 72 63 65 0a 20 20 20 20 20 6c 69 6e 65 73 20 61 6e 64 20 64 69 72 65 63 74 ┆ong source lines and direct┆ 0x06e0…0700 20 74 6f 20 73 74 61 6e 64 61 72 64 20 6f 75 74 70 75 74 2e 0a 0a 20 20 20 20 20 2d 45 6c 0a 0a ┆ to standard output. -El ┆ 0x0700…0720 50 72 69 6e 74 65 64 20 31 32 2f 32 36 2f 38 39 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 41 ┆Printed 12/26/89 VA┆ 0x0720…0740 44 53 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆DS ┆ 0x0740…0760 32 0a 0a 61 64 61 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 41 44 53 ┆2 ada VADS┆ 0x0760…0780 20 52 65 66 65 72 65 6e 63 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ Reference ┆ 0x0780…07a0 20 61 64 61 0a 0a 20 20 20 20 20 2d 45 6c 20 66 69 6c 65 0a 0a 20 20 20 20 20 2d 45 6c 20 64 69 ┆ ada -El file -El di┆ 0x07a0…07c0 72 65 63 74 6f 72 79 20 20 28 65 72 72 6f 72 20 6c 69 73 74 69 6e 67 29 20 53 61 6d 65 20 61 73 ┆rectory (error listing) Same as┆ 0x07c0…07e0 20 74 68 65 20 2d 45 20 6f 70 74 69 0a 0a 20 20 20 20 20 6f 6e 2c 20 65 78 63 65 70 74 20 74 68 ┆ the -E opti on, except th┆ 0x07e0…0800 61 74 20 73 6f 75 72 63 65 20 6c 69 73 74 69 6e 67 20 77 69 74 68 20 65 72 72 6f 72 73 20 69 73 ┆at source listing with errors is┆ 0x0800…0820 20 70 72 6f 64 75 63 65 64 2e 0a 0a 20 20 20 20 20 2d 65 76 20 20 28 65 72 72 6f 72 20 76 69 28 ┆ produced. -ev (error vi(┆ 0x0820…0840 31 29 29 20 50 72 6f 63 65 73 73 20 73 79 6e 74 61 78 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 ┆1)) Process syntax error message┆ 0x0840…0860 73 20 75 73 69 6e 67 0a 20 20 20 20 20 61 2e 65 72 72 6f 72 2c 20 65 6d 62 65 64 20 74 68 65 6d ┆s using a.error, embed them┆ 0x0860…0880 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 66 69 6c 65 2c 20 61 6e 64 20 63 61 6c 6c 20 74 68 ┆ in the source file, and call th┆ 0x0880…08a0 65 0a 20 20 20 20 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 65 64 69 74 6f 72 20 45 52 52 4f 52 5f ┆e environment editor ERROR_┆ 0x08a0…08c0 45 44 49 54 4f 52 2e 20 28 49 66 20 45 52 52 4f 52 5f 45 44 49 54 4f 52 20 69 73 0a 20 20 20 20 ┆EDITOR. (If ERROR_EDITOR is ┆ 0x08c0…08e0 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 ┆ defined, the environment variab┆ 0x08e0…0900 6c 65 20 45 52 52 4f 52 5f 50 41 54 54 45 52 4e 20 73 68 6f 75 6c 64 20 61 6c 73 6f 0a 20 20 20 ┆le ERROR_PATTERN should also ┆ 0x0900…0920 20 20 62 65 20 64 65 66 69 6e 65 64 2e 20 45 52 52 4f 52 5f 50 41 54 54 45 52 4e 20 69 73 20 61 ┆ be defined. ERROR_PATTERN is a┆ 0x0920…0940 6e 20 65 64 69 74 6f 72 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 0a 20 20 20 ┆n editor search command that ┆ 0x0940…0960 20 20 6c 6f 63 61 74 65 73 20 74 68 65 20 66 69 72 73 74 20 6f 63 63 75 72 72 65 6e 63 65 20 6f ┆ locates the first occurrence o┆ 0x0960…0980 66 20 60 23 23 23 27 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 66 69 6c 65 2e 29 20 49 66 0a 20 ┆f `###' in the error file.) If ┆ 0x0980…09a0 20 20 20 20 6e 6f 20 65 64 69 74 6f 72 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 76 69 28 31 ┆ no editor is specified, vi(1┆ 0x09a0…09c0 29 20 69 73 20 69 6e 76 6f 6b 65 64 2e 0a 0a 20 20 20 20 20 2d 4b 20 20 20 28 6b 65 65 70 29 20 ┆) is invoked. -K (keep) ┆ 0x09c0…09e0 4b 65 65 70 20 74 68 65 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 6c 61 6e 67 75 61 67 65 20 28 ┆Keep the intermediate language (┆ 0x09e0…0a00 49 4c 29 20 66 69 6c 65 0a 20 20 20 20 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 20 63 6f ┆IL) file produced by the co┆ 0x0a00…0a20 6d 70 69 6c 65 72 20 66 72 6f 6e 74 20 65 6e 64 2e 20 20 54 68 65 20 49 4c 20 66 69 6c 65 20 77 ┆mpiler front end. The IL file w┆ 0x0a20…0a40 69 6c 6c 20 62 65 0a 20 20 20 20 20 70 6c 61 63 65 64 20 69 6e 74 20 68 65 20 2e 6f 62 6a 65 63 ┆ill be placed int he .objec┆ 0x0a40…0a60 74 73 0a 0a 20 20 20 20 20 20 64 69 72 65 63 74 6f 72 79 2c 20 77 69 74 68 20 74 68 65 20 66 69 ┆ts directory, with the fi┆ 0x0a60…0a80 6c 65 20 6e 61 6d 65 20 41 64 61 5f 73 6f 75 72 63 65 2e 69 0a 0a 20 20 20 20 20 2d 4c 20 6c 69 ┆le name Ada_source.i -L li┆ 0x0a80…0aa0 62 72 61 72 79 5f 6e 61 6d 65 20 20 20 20 20 28 6c 69 62 72 61 72 79 29 20 4f 70 65 72 61 74 65 ┆brary_name (library) Operate┆ 0x0aa0…0ac0 20 69 6e 20 56 41 44 53 20 6c 69 62 72 61 72 79 0a 20 20 20 20 20 6c 69 62 72 61 72 79 5f 6e 61 ┆ in VADS library library_na┆ 0x0ac0…0ae0 6d 65 20 28 74 68 65 20 63 75 72 72 65 6e 74 20 77 6f 72 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 ┆me (the current working director┆ 0x0ae0…0b00 79 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 29 2e 0a 0a 20 20 20 20 20 2d 6c 66 69 6c 65 5f ┆y is the default). -lfile_┆ 0x0b00…0b20 61 62 62 72 65 76 69 61 74 69 6f 6e 20 28 6c 69 62 72 61 72 79 20 73 65 61 72 63 68 29 20 54 68 ┆abbreviation (library search) Th┆ 0x0b20…0b40 69 73 20 69 73 20 61 6e 20 6f 70 74 69 6f 6e 0a 20 20 20 20 20 70 61 73 73 65 64 20 74 6f 20 74 ┆is is an option passed to t┆ 0x0b40…0b60 68 65 20 55 4e 49 58 20 6c 69 6e 6b 65 72 2c 20 6c 64 28 31 29 20 74 65 6c 6c 69 6e 67 20 69 74 ┆he UNIX linker, ld(1) telling it┆ 0x0b60…0b80 20 74 6f 20 73 65 61 72 63 68 20 74 68 65 0a 20 20 20 20 20 73 70 65 63 69 66 69 65 64 20 6c 69 ┆ to search the specified li┆ 0x0b80…0ba0 62 72 61 72 79 20 66 69 6c 65 2e 20 28 4e 6f 20 73 70 61 63 65 20 62 65 74 77 65 65 6e 20 74 68 ┆brary file. (No space between th┆ 0x0ba0…0bc0 65 20 2d 6c 20 61 6e 64 20 74 68 65 0a 20 20 20 20 20 66 69 6c 65 20 61 62 62 72 65 76 69 61 74 ┆e -l and the file abbreviat┆ 0x0bc0…0be0 69 6f 6e 2e 29 0a 0a 50 72 69 6e 74 65 64 20 31 32 2f 32 36 2f 38 39 20 20 20 20 20 20 20 20 20 ┆ion.) Printed 12/26/89 ┆ 0x0be0…0c00 20 20 20 20 20 56 41 44 53 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ VADS ┆ 0x0c00…0c20 20 20 20 20 20 20 20 33 0a 0a 61 64 61 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ 3 ada ┆ 0x0c20…0c40 20 20 20 56 41 44 53 20 52 65 66 65 72 65 6e 63 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ VADS Reference ┆ 0x0c40…0c60 20 20 20 20 20 20 20 20 61 64 61 0a 0a 20 20 20 20 20 46 6f 72 20 61 20 64 65 73 63 72 69 70 74 ┆ ada For a descript┆ 0x0c60…0c80 69 6f 6e 20 6f 66 20 74 68 65 20 66 69 6c 65 20 61 62 62 72 65 76 69 61 74 69 6f 6e 73 2c 20 73 ┆ion of the file abbreviations, s┆ 0x0c80…0ca0 65 65 20 61 6c 73 6f 0a 20 20 20 20 20 4f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 64 6f ┆ee also Operating system do┆ 0x0ca0…0cc0 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 6c 64 28 31 29 2e 0a 0a 20 20 20 20 20 2d 4d 20 75 6e 69 ┆cumentation, ld(1). -M uni┆ 0x0cc0…0ce0 74 5f 6e 61 6d 65 20 20 20 28 6d 61 69 6e 29 20 50 72 6f 64 75 63 65 20 61 6e 20 65 78 65 63 75 ┆t_name (main) Produce an execu┆ 0x0ce0…0d00 74 61 62 6c 65 20 70 72 6f 67 72 61 6d 20 62 79 0a 20 20 20 20 20 6c 69 6e 6b 69 6e 67 20 74 68 ┆table program by linking th┆ 0x0d00…0d20 65 20 6e 61 6d 65 64 20 75 6e 69 74 20 61 73 20 74 68 65 20 6d 61 69 6e 20 70 72 6f 67 72 61 6d ┆e named unit as the main program┆ 0x0d20…0d40 2e 20 75 6e 69 74 5f 6e 61 6d 65 20 6d 75 73 74 0a 20 20 20 20 20 61 6c 72 65 61 64 79 20 62 65 ┆. unit_name must already be┆ 0x0d40…0d60 20 63 6f 6d 70 69 6c 65 64 2e 20 49 74 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 61 20 70 ┆ compiled. It must be either a p┆ 0x0d60…0d80 61 72 61 6d 65 74 65 72 6c 65 73 73 0a 20 20 20 20 20 70 72 6f 63 65 64 75 72 65 20 6f 72 20 61 ┆arameterless procedure or a┆ 0x0d80…0da0 20 70 61 72 61 6d 65 74 65 72 6c 65 73 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 69 6e ┆ parameterless function returnin┆ 0x0da0…0dc0 67 20 61 6e 20 69 6e 74 65 67 65 72 2e 0a 20 20 20 20 20 54 68 65 20 65 78 65 63 75 74 61 62 6c ┆g an integer. The executabl┆ 0x0dc0…0de0 65 20 70 72 6f 67 72 61 6d 20 77 69 6c 6c 20 62 65 20 6e 61 6d 65 64 20 61 2e 6f 75 74 20 75 6e ┆e program will be named a.out un┆ 0x0de0…0e00 6c 65 73 73 20 6f 76 65 72 72 69 64 64 65 6e 0a 20 20 20 20 20 77 69 74 68 20 74 68 65 20 2d 6f ┆less overridden with the -o┆ 0x0e00…0e20 20 6f 70 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 2d 4d 20 73 6f 75 72 63 65 5f 66 69 6c 65 20 28 6d ┆ option. -M source_file (m┆ 0x0e20…0e40 61 69 6e 29 20 50 72 6f 64 75 63 65 20 61 6e 20 65 78 65 63 75 74 61 62 6c 65 20 70 72 6f 67 72 ┆ain) Produce an executable progr┆ 0x0e40…0e60 61 6d 20 62 79 0a 20 20 20 20 20 63 6f 6d 70 69 6c 69 6e 67 20 61 6e 64 20 6c 69 6e 6b 69 6e 67 ┆am by compiling and linking┆ 0x0e60…0e80 20 73 6f 75 72 63 65 5f 66 69 6c 65 2e 20 54 68 65 20 6d 61 69 6e 20 75 6e 69 74 20 6f 66 20 74 ┆ source_file. The main unit of t┆ 0x0e80…0ea0 68 65 0a 20 20 20 20 20 70 72 6f 67 72 61 6d 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 62 65 ┆he program is assumed to be┆ 0x0ea0…0ec0 20 74 68 65 20 72 6f 6f 74 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 2e 61 20 66 69 6c 65 20 28 66 ┆ the root name of the .a file (f┆ 0x0ec0…0ee0 6f 72 0a 20 20 20 20 20 66 6f 6f 2e 61 20 74 68 65 20 75 6e 69 74 20 69 73 20 66 6f 6f 29 2e 20 ┆or foo.a the unit is foo). ┆ 0x0ee0…0f00 4f 6e 6c 79 20 6f 6e 65 20 2e 61 20 66 69 6c 65 20 6d 61 79 20 62 65 20 70 72 65 63 65 64 65 64 ┆Only one .a file may be preceded┆ 0x0f00…0f20 20 62 79 0a 20 20 20 20 20 2d 4d 2e 20 54 68 65 20 65 78 65 63 75 74 61 62 6c 65 20 70 72 6f 67 ┆ by -M. The executable prog┆ 0x0f20…0f40 72 61 6d 20 77 69 6c 6c 20 62 65 20 6e 61 6d 65 64 20 61 2e 6f 75 74 20 75 6e 6c 65 73 73 0a 20 ┆ram will be named a.out unless ┆ 0x0f40…0f60 20 20 20 20 6f 76 65 72 72 69 64 64 65 6e 20 77 69 74 68 20 74 68 65 20 2d 6f 20 6f 70 74 69 6f ┆ overridden with the -o optio┆ 0x0f60…0f80 6e 2e 0a 0a 20 20 20 20 20 2d 6f 20 65 78 65 63 75 74 61 62 6c 65 5f 66 69 6c 65 20 20 28 6f 75 ┆n. -o executable_file (ou┆ 0x0f80…0fa0 74 70 75 74 29 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 74 6f 20 62 65 20 75 73 65 64 20 ┆tput) This option is to be used ┆ 0x0fa0…0fc0 69 6e 0a 20 20 20 20 20 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 2d 4d 20 ┆in conjunction with the -M ┆ 0x0fc0…0fe0 6f 70 74 69 6f 6e 2e 20 65 78 65 63 75 74 61 62 6c 65 5f 66 69 6c 65 20 69 73 20 74 68 65 20 6e ┆option. executable_file is the n┆ 0x0fe0…1000 61 6d 65 0a 20 20 20 20 20 6f 66 20 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 20 72 61 74 68 65 ┆ame of the executable rathe┆ 0x1000…1020 72 20 74 68 61 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 2e 6f 75 74 2e 0a 0a 20 20 20 20 20 ┆r than the default a.out. ┆ 0x1020…1040 2d 4f 5b 30 2d 39 5d 20 20 20 28 6f 70 74 69 6d 69 7a 65 29 20 49 6e 76 6f 6b 65 20 74 68 65 20 ┆-O[0-9] (optimize) Invoke the ┆ 0x1040…1060 63 6f 64 65 20 6f 70 74 69 6d 69 7a 65 72 20 28 4f 50 54 49 4d 33 29 2e 20 41 6e 0a 20 20 20 20 ┆code optimizer (OPTIM3). An ┆ 0x1060…1080 20 6f 70 74 69 6f 6e 61 6c 20 64 69 67 69 74 20 28 74 68 65 72 65 20 69 73 20 6e 6f 20 73 70 61 ┆ optional digit (there is no spa┆ 0x1080…10a0 63 65 20 62 65 66 6f 72 65 20 74 68 65 20 64 69 67 69 74 29 20 70 72 6f 76 69 64 65 73 0a 20 20 ┆ce before the digit) provides ┆ 0x10a0…10c0 20 20 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 54 68 ┆ the level of optimization. Th┆ 0x10c0…10e0 65 20 64 65 66 61 75 6c 74 20 69 73 20 2d 4f 34 2e 0a 0a 20 20 20 20 20 2d 4f 20 20 20 66 75 6c ┆e default is -O4. -O ful┆ 0x10e0…1100 6c 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a 0a 50 72 69 6e 74 65 64 20 31 32 2f 32 36 2f 38 39 ┆l optimization Printed 12/26/89┆ 0x1100…1120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 41 44 53 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ VADS ┆ 0x1120…1140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 34 0a 0a 61 64 61 20 20 20 20 20 20 20 20 20 20 ┆ 4 ada ┆ 0x1140…1160 20 20 20 20 20 20 20 20 20 20 20 20 56 41 44 53 20 52 65 66 65 72 65 6e 63 65 20 20 20 20 20 20 ┆ VADS Reference ┆ 0x1160…1180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 64 61 0a 0a 20 20 20 20 20 2d 4f 30 20 20 ┆ ada -O0 ┆ 0x1180…11a0 70 72 65 76 65 6e 74 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a 0a 20 20 20 20 20 2d 4f 31 20 ┆prevents optimization -O1 ┆ 0x11a0…11c0 20 6e 6f 20 68 6f 69 73 74 69 6e 67 0a 0a 20 20 20 20 20 2d 4f 32 20 20 6e 6f 20 68 6f 69 73 74 ┆ no hoisting -O2 no hoist┆ 0x11c0…11e0 69 6e 67 20 62 75 74 20 6d 6f 72 65 20 70 61 73 73 65 73 0a 0a 20 20 20 20 20 2d 4f 33 20 20 6e ┆ing but more passes -O3 n┆ 0x11e0…1200 6f 20 68 6f 69 73 74 69 6e 67 20 62 75 74 20 65 76 65 6e 20 6d 6f 72 65 20 70 61 73 73 65 73 0a ┆o hoisting but even more passes ┆ 0x1200…1220 0a 20 20 20 20 20 2d 4f 34 20 20 68 6f 69 73 74 69 6e 67 20 66 72 6f 6d 20 6c 6f 6f 70 73 0a 0a ┆ -O4 hoisting from loops ┆ 0x1220…1240 20 20 20 20 20 2d 4f 35 20 20 68 6f 69 73 74 69 6e 67 20 66 72 6f 6d 20 6c 6f 6f 70 73 20 62 75 ┆ -O5 hoisting from loops bu┆ 0x1240…1260 74 20 6d 6f 72 65 20 70 61 73 73 65 73 0a 0a 20 20 20 20 20 2d 4f 36 20 20 68 6f 69 73 74 69 6e ┆t more passes -O6 hoistin┆ 0x1260…1280 67 20 66 72 6f 6d 20 6c 6f 6f 70 73 20 77 69 74 68 20 6d 61 78 69 6d 75 6d 20 70 61 73 73 65 73 ┆g from loops with maximum passes┆ 0x1280…12a0 0a 0a 20 20 20 20 20 2d 4f 37 20 20 68 6f 69 73 74 69 6e 67 20 66 72 6f 6d 20 6c 6f 6f 70 73 20 ┆ -O7 hoisting from loops ┆ 0x12a0…12c0 61 6e 64 20 62 72 61 6e 63 68 65 73 0a 0a 50 72 69 6e 74 65 64 20 31 32 2f 32 36 2f 38 39 20 20 ┆and branches Printed 12/26/89 ┆ 0x12c0…12e0 20 20 20 20 20 20 20 20 20 20 20 20 56 41 44 53 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ VADS ┆ 0x12e0…1300 20 20 20 20 20 20 20 20 20 20 20 20 20 20 35 0a 0a 61 64 61 20 20 20 20 20 20 20 20 20 20 20 20 ┆ 5 ada ┆ 0x1300…1320 20 20 20 20 20 20 20 20 20 20 56 41 44 53 20 52 65 66 65 72 65 6e 63 65 20 20 20 20 20 20 20 20 ┆ VADS Reference ┆ 0x1320…1340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 64 61 0a 0a 20 20 20 20 20 2d 4f 38 20 20 68 6f ┆ ada -O8 ho┆ 0x1340…1360 69 73 74 69 6e 67 20 66 72 6f 6d 20 6c 6f 6f 70 73 20 61 6e 64 20 62 72 61 6e 63 68 65 73 2c 20 ┆isting from loops and branches, ┆ 0x1360…1380 6d 6f 72 65 20 70 61 73 73 65 73 0a 0a 20 20 20 20 20 2d 4f 39 20 20 68 6f 69 73 74 69 6e 67 20 ┆more passes -O9 hoisting ┆ 0x1380…13a0 66 72 6f 6d 20 6c 6f 6f 70 73 20 61 6e 64 20 62 72 61 6e 63 68 65 73 2c 20 6d 61 78 69 6d 75 6d ┆from loops and branches, maximum┆ 0x13a0…13c0 20 70 61 73 73 65 73 0a 0a 20 20 20 20 20 48 6f 69 73 74 69 6e 67 20 66 72 6f 6d 20 62 72 61 6e ┆ passes Hoisting from bran┆ 0x13c0…13e0 63 68 65 73 20 28 61 6e 64 20 63 61 73 65 73 20 61 6c 74 65 72 6e 61 74 69 76 65 73 29 20 63 61 ┆ches (and cases alternatives) ca┆ 0x13e0…1400 6e 20 62 65 20 73 6c 6f 77 0a 20 20 20 20 20 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 61 6c 77 61 ┆n be slow and does not alwa┆ 0x1400…1420 79 73 20 70 72 6f 76 69 64 65 20 73 69 67 6e 69 66 69 63 61 6e 74 20 70 65 72 66 6f 72 6d 61 6e ┆ys provide significant performan┆ 0x1420…1440 63 65 20 67 61 69 6e 73 20 73 6f 0a 20 20 20 20 20 69 74 20 63 61 6e 20 62 65 20 73 75 70 70 72 ┆ce gains so it can be suppr┆ 0x1440…1460 65 73 73 65 64 2e 0a 0a 20 20 20 20 20 46 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f ┆essed. For more informatio┆ 0x1460…1480 6e 20 61 62 6f 75 74 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2c 20 73 65 65 20 20 43 4f 4d 50 49 ┆n about optimization, see COMPI┆ 0x1480…14a0 4c 49 4e 47 20 41 44 41 0a 20 20 20 20 20 50 52 4f 47 52 41 4d 53 2c 20 43 6f 6d 70 69 6c 65 72 ┆LING ADA PROGRAMS, Compiler┆ 0x14a0…14c0 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 6f 6e 20 70 61 67 65 0a 20 20 20 20 20 20 2e 20 53 ┆ Optimizations on page . S┆ 0x14c0…14e0 65 65 20 61 6c 73 6f 20 70 72 61 67 6d 61 20 4f 50 54 49 4d 49 5a 45 5f 43 4f 44 45 28 4f 46 46 ┆ee also pragma OPTIMIZE_CODE(OFF┆ 0x14e0…1500 29 20 6f 6e 20 70 61 67 65 0a 0a 20 20 20 20 20 2d 50 20 20 20 49 6e 76 6f 6b 65 20 74 68 65 20 ┆) on page -P Invoke the ┆ 0x1500…1520 41 64 61 20 50 72 65 70 72 6f 63 65 73 73 6f 72 2e 20 53 65 65 20 43 68 61 70 74 65 72 20 2c 20 ┆Ada Preprocessor. See Chapter , ┆ 0x1520…1540 56 41 44 53 20 41 44 41 0a 20 20 20 20 20 50 52 45 50 52 4f 43 45 53 53 4f 52 20 52 45 46 45 52 ┆VADS ADA PREPROCESSOR REFER┆ 0x1540…1560 45 4e 43 45 2e 0a 0a 20 20 20 20 20 2d 52 20 56 41 44 53 5f 6c 69 62 72 61 72 79 20 20 20 20 20 ┆ENCE. -R VADS_library ┆ 0x1560…1580 28 72 65 63 6f 6d 70 69 6c 65 20 69 6e 73 74 61 6e 74 69 61 74 69 6f 6e 29 20 46 6f 72 63 65 20 ┆(recompile instantiation) Force ┆ 0x1580…15a0 61 6e 61 6c 79 73 69 73 0a 20 20 20 20 20 6f 66 20 61 6c 6c 20 67 65 6e 65 72 69 63 20 69 6e 73 ┆analysis of all generic ins┆ 0x15a0…15c0 74 61 6e 74 69 61 74 69 6f 6e 73 2c 20 63 61 75 73 69 6e 67 20 72 65 69 6e 73 74 61 6e 74 69 61 ┆tantiations, causing reinstantia┆ 0x15c0…15e0 74 69 6f 6e 20 6f 66 0a 20 20 20 20 20 61 6e 79 20 74 68 61 74 20 61 72 65 20 6f 75 74 20 6f 66 ┆tion of any that are out of┆ 0x15e0…1600 20 64 61 74 65 2e 0a 0a 20 20 20 20 20 2d 53 20 20 20 28 73 75 70 70 72 65 73 73 29 20 41 70 70 ┆ date. -S (suppress) App┆ 0x1600…1620 6c 79 20 70 72 61 67 6d 61 20 53 55 50 50 52 45 53 53 20 74 6f 20 74 68 65 20 65 6e 74 69 72 65 ┆ly pragma SUPPRESS to the entire┆ 0x1620…1640 0a 20 20 20 20 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 66 6f 72 20 61 6c 6c 20 73 75 70 70 72 65 ┆ compilation for all suppre┆ 0x1640…1660 73 73 69 62 6c 65 20 63 68 65 63 6b 73 2e 20 28 53 65 65 20 61 6c 73 6f 20 70 72 61 67 6d 0a 0a ┆ssible checks. (See also pragm ┆ 0x1660…1680 20 20 20 20 20 61 20 53 55 50 50 52 45 53 53 28 41 4c 4c 5f 43 48 45 43 4b 53 29 20 6f 6e 20 70 ┆ a SUPPRESS(ALL_CHECKS) on p┆ 0x1680…16a0 61 67 65 0a 0a 50 72 69 6e 74 65 64 20 31 32 2f 32 36 2f 38 39 20 20 20 20 20 20 20 20 20 20 20 ┆age Printed 12/26/89 ┆ 0x16a0…16c0 20 20 20 56 41 44 53 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ VADS ┆ 0x16c0…16e0 20 20 20 20 20 36 0a 0a 61 64 61 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ 6 ada ┆ 0x16e0…1700 20 56 41 44 53 20 52 65 66 65 72 65 6e 63 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ VADS Reference ┆ 0x1700…1720 20 20 20 20 20 20 61 64 61 0a 0a 20 20 20 20 20 2d 73 68 20 20 28 73 68 6f 77 29 20 44 69 73 70 ┆ ada -sh (show) Disp┆ 0x1720…1740 6c 61 79 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 6f 6f 6c 20 65 78 65 63 75 74 61 ┆lay the name of the tool executa┆ 0x1740…1760 62 6c 65 20 62 75 74 20 64 6f 0a 20 20 20 20 20 6e 6f 74 20 65 78 65 63 75 74 65 20 69 74 2e 0a ┆ble but do not execute it. ┆ 0x1760…1780 0a 20 20 20 20 20 2d 54 20 20 20 28 74 69 6d 69 6e 67 29 20 50 72 69 6e 74 20 74 69 6d 69 6e 67 ┆ -T (timing) Print timing┆ 0x1780…17a0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 63 6f 6d 70 69 6c 61 74 69 6f 6e ┆ information for the compilation┆ 0x17a0…17c0 2e 0a 0a 20 20 20 20 20 2d 76 20 20 20 28 76 65 72 62 6f 73 65 29 20 50 72 69 6e 74 20 63 6f 6d ┆. -v (verbose) Print com┆ 0x17c0…17e0 70 69 6c 65 72 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 2c 20 64 61 74 65 20 61 6e 64 20 74 ┆piler version number, date and t┆ 0x17e0…1800 69 6d 65 0a 20 20 20 20 20 6f 66 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 2c 20 6e 61 6d 65 20 6f 66 ┆ime of compilation, name of┆ 0x1800…1820 20 66 69 6c 65 20 63 6f 6d 70 69 6c 65 64 2c 20 63 6f 6d 6d 61 6e 64 20 69 6e 70 75 74 20 6c 69 ┆ file compiled, command input li┆ 0x1820…1840 6e 65 2c 0a 20 20 20 20 20 74 6f 74 61 6c 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 74 69 6d 65 2c ┆ne, total compilation time,┆ 0x1840…1860 20 61 6e 64 20 65 72 72 6f 72 20 73 75 6d 6d 61 72 79 20 6c 69 6e 65 2e 20 53 74 6f 72 61 67 65 ┆ and error summary line. Storage┆ 0x1860…1880 0a 20 20 20 20 20 75 73 61 67 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 ┆ usage information about th┆ 0x1880…18a0 65 20 6f 62 6a 65 63 74 20 66 69 6c 65 20 69 73 20 70 72 6f 76 69 64 65 64 2e 20 57 69 74 68 0a ┆e object file is provided. With ┆ 0x18a0…18c0 20 20 20 20 20 4f 50 54 49 4d 33 20 74 68 65 20 6f 75 74 70 75 74 20 66 6f 72 6d 61 74 20 6f 66 ┆ OPTIM3 the output format of┆ 0x18c0…18e0 20 63 6f 6d 70 72 65 73 73 69 6f 6e 20 28 74 68 65 20 73 69 7a 65 20 6f 66 0a 20 20 20 20 20 6f ┆ compression (the size of o┆ 0x18e0…1900 70 74 69 6d 69 7a 65 64 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 29 20 69 73 20 61 73 20 61 20 70 ┆ptimized instructions) is as a p┆ 0x1900…1920 65 72 63 65 6e 74 61 67 65 20 6f 66 20 69 6e 70 75 74 0a 20 20 20 20 20 28 75 6e 6f 70 74 69 6d ┆ercentage of input (unoptim┆ […truncated at 200 lines…]