4 Chapter 2. Compiling with C51
Running C51
To invoke the C51 compiler, type C51 at the DOS prompt. On this command line, you must include the name of the C source file to be compiled, as well as any other necessary control directives required to compile your source file. The format for the C51 command line is:
2 |
C51 sourcefile |
!directives…" |
|
||
|
where: |
|
|
sourcefile |
is the name of the source program you want to compile. |
|
directives |
are the directives you want to use to control the function of |
|
|
the compiler. Refer to “Control Directives” on page 6 for a |
|
|
detailed list of the available directives. |
The following command line example invokes C51, specifies the source file and uses the controls DEBUG, CODE, and PREPRINT.
C51 SAMPLE.C DEBUG CODE PREPRINT
The C51 compiler displays the following information upon successful invocation and compilation.
MS-DOS C51 COMPILER V5.0
C51 COMPILATION COMPLETE. 0 WARNING(S), 0 ERROR(S)
Keil Software — C51 Compiler User’s Guide |
5 |
|
|
DOS ERRORLEVEL
After compilation, the number of errors and warnings detected is output to the screen. C51 then sets the DOS ERRORLEVEL to indicate the status of the compilation. Values are listed in the following table:
ERRORLEVEL |
Meaning |
2 |
|
|
|
||
0 |
No errors or warnings |
||
|
1Warnings only
2Errors and possibly warnings
3Fatal errors
You can access the ERRORLEVEL variable in DOS batch files. Refer to your DOS user’s guide for more information on ERRORLEVEL or batch files.
C51 Output Files
C51 generates a number of output files during compilation. By default, each of these output files shares the same basename as the source file. However, each has a different file extension. The following table lists the files and gives a brief description of each.
File Extension |
Description |
|
|
basename.LST |
Files with this extension are listing files that contain the formatted source |
|
text along with any errors detected by the compiler. Listing files may |
|
optionally contain the used symbols and the generated assembly code. |
|
See the PRINT directive in the following sections for more information. |
basename.OBJ |
Files with this extension are object modules that contain relocatable object |
|
code. Object modules may be linked to an absolute object module by the |
|
BL51 Linker/Locator. |
basename.I |
Files with this extension contain the source text as expanded by the |
|
preprocessor. All macros are expanded and all comments are deleted in |
|
this listing. See the PREPRINT directive in the following sections for more |
|
information. |
basename.SRC |
Files with this extension are assembly source files generated from your C |
|
source code. These files can be assembled with the A51 assembler. See |
|
the SRC directive in the following sections for more information. |
|
|