Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/cc.refentry @ 3076:d28d94edee79
Found SDFLAGS from level1/coco1/modules/makefile was missing. Added line.
| author | David Ladd <drencor-xeen@users.sf.net> |
|---|---|
| date | Mon, 23 Feb 2015 15:00:06 -0600 |
| parents | b00cf13c9f61 |
| children |
| rev | line source |
|---|---|
| 920 | 1 <refentry id="cc"> |
| 2 <refnamediv> | |
| 3 <refname>CC</refname> | |
| 4 <refpurpose>C Compiler</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>cc</command> |
| 920 | 10 <arg>options</arg> |
| 11 <arg rep="repeat" choice="plain"><replaceable>file</replaceable></arg> | |
| 12 <arg>options</arg> | |
| 13 </cmdsynopsis> | |
| 14 </refsynopsisdiv> | |
| 15 | |
| 16 <refsect1><title>Description</title> | |
| 17 <para> | |
| 18 The are two commands which invoke distinct versions of the | |
| 1500 | 19 compiler. <command>cc1</command> is for NitrOS-9 Level 1 which uses a two pass compiler, |
| 20 and, <command>cc2</command> is for Level 2 which causes a single pass version. Both | |
| 920 | 21 versions of the compiler works identically, the main difference is |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
920
diff
changeset
|
22 that <command>cc1</command> has been divided into two passes to fit the smaller memory |
| 1500 | 23 size of NitrOS-9 Level 1. In the following text, "cc" refers to |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
920
diff
changeset
|
24 either <command>cc1</command> or <command>cc2</command> as appropiate for your system. |
| 920 | 25 </para> |
| 26 </refsect1> | |
| 27 <refsect1><title>Options</title> | |
| 28 <para> | |
| 29 Recognized options: (UPPER and lower case is equiv.) | |
| 30 </para> | |
| 31 <informaltable frame="none"> | |
| 32 <tgroup cols="2"> | |
| 33 <colspec colwidth="0.9in"/> | |
| 34 <colspec colwidth="3.0in"/> | |
| 35 <tbody> | |
| 36 <row> | |
| 37 <entry>-a</entry> | |
| 38 <entry>Suppress assembly. Leave output in ".a" file.</entry> | |
| 39 </row> | |
| 40 <row> | |
| 41 <entry>-e=n</entry> | |
| 42 <entry>Edition number (n) is supplied to c.prep for | |
| 43 inclusion in module psect and/or to c.link for | |
| 44 inclusion as the edition number of the linked | |
| 45 module.</entry> | |
| 46 </row> | |
| 47 <row> | |
| 48 <entry>-o</entry> | |
| 49 <entry>Inhibits assembly code optimizer pass.</entry> | |
| 50 </row> | |
| 51 <row> | |
| 52 <entry>-p</entry> | |
| 53 <entry>Invoke compiler function profiler.</entry> | |
| 54 </row> | |
| 55 <row> | |
| 56 <entry>-r</entry> | |
| 57 <entry>Suppress link step. Leave output in ".r" file.</entry> | |
| 58 </row> | |
| 59 <row> | |
| 60 <entry>-m=<replaceable>size</replaceable></entry> | |
| 61 <entry>Size in pages (in kbytes if followed by a K) of | |
| 62 additional memory the linker should allocate to | |
| 63 object module.</entry> | |
| 64 </row> | |
| 65 <row> | |
| 66 <entry>-l=<replaceable>path</replaceable></entry> | |
| 67 <entry>Library file for linker to search before the standard library.</entry> | |
| 68 </row> | |
| 69 <row> | |
| 70 <entry>-f=<replaceable>path</replaceable></entry> | |
| 71 <entry>Override other output naming. Module name (in | |
| 72 object module) is the last name in the pathlist. | |
| 73 -f is not allowed with -a or -r.</entry> | |
| 74 </row> | |
| 75 <row> | |
| 76 <entry>-c</entry> | |
| 77 <entry>Output comments in assembly language code.</entry> | |
| 78 </row> | |
| 79 <row> | |
| 80 <entry>-s</entry> | |
| 81 <entry>Suppress generation of stack-checking code.</entry> | |
| 82 </row> | |
| 83 <row> | |
| 84 <entry>-d<replaceable>NAME</replaceable></entry> | |
| 85 <entry>Is equivalent to #define <replaceable>NAME</replaceable> 1 in the | |
| 86 preprocessor. -d<replaceable>NAME</replaceable>=<replaceable>STRING</replaceable> | |
| 87 is equivalent | |
| 88 to #define <replaceable>NAME</replaceable> <replaceable>STRING</replaceable>.</entry> | |
| 89 </row> | |
| 90 <row> | |
| 91 <entry>-n=<replaceable>name</replaceable></entry> | |
| 92 <entry>output module name. <replaceable>name</replaceable> is used to override | |
| 93 the -f default output name.</entry> | |
| 94 </row> | |
| 95 </tbody> | |
| 96 </tgroup> | |
| 97 </informaltable> | |
| 98 <para> | |
| 99 CC1 only: | |
| 100 </para> | |
| 101 <informaltable frame="none"> | |
| 102 <tgroup cols="2"> | |
| 103 <colspec colwidth="0.9in"/> | |
| 104 <colspec colwidth="3.0in"/> | |
| 105 <tbody> | |
| 106 <row> | |
| 107 <entry>-x</entry> | |
| 108 <entry>Create, but do not execute c.com command file.</entry> | |
| 109 </row> | |
| 110 </tbody> | |
| 111 </tgroup> | |
| 112 </informaltable> | |
| 113 <para> | |
| 114 CC2 only: | |
| 115 </para> | |
| 116 <informaltable frame="none"> | |
| 117 <tgroup cols="2"> | |
| 118 <colspec colwidth="0.9in"/> | |
| 119 <colspec colwidth="3.0in"/> | |
| 120 <tbody> | |
| 121 <row> | |
| 122 <entry>-q</entry> | |
| 123 <entry>Quiet mode. Suppress echo of file names.</entry> | |
| 124 </row> | |
| 125 </tbody> | |
| 126 </tgroup> | |
| 127 </informaltable> | |
| 128 </refsect1> | |
| 129 </refentry> |