CL Invokes the Linker

CL automatically invokes the linker after compiling unless the /c option is used. CL passes to the linker the names of .obj files created during compiling and the names of any other files specified on the command line. The linker uses the options listed in the LINK environment variable. You can use the /link option to specify linker options on the CL command line. Options that follow the /link option override those in the LINK environment variable. The options in the following table suppress linking.

Option Description
/c Compile without linking
/E, /EP, /P Preprocess without compiling or linking
/Zg Generate function prototypes
/Zs Check syntax

For further details about linking, see MSVC Linker Options.

Example

Assume that you are compiling three C source files: MAIN.c, MOD1.c, and MOD2.c. Each file includes a call to a function defined in a different file:

  • MAIN.c calls the function func1 in MOD1.c and the function func2 in MOD2.c.

  • MOD1.c calls the standard library functions printf_s and scanf_s.

  • MOD2.c calls graphics functions named myline and mycircle, which are defined in a library named MYGRAPH.lib.

To build this program, compile with the following command line:

CL MAIN.c MOD1.C MOD2.C MYGRAPH.lib

CL first compiles the C source files and creates the object files MAIN.obj, MOD1.obj, and MOD2.obj. The compiler places the name of the standard library in each .obj file. For more details, see Use Run-Time Library.

CL passes the names of the .obj files, along with the name MYGRAPH.lib, to the linker. The linker resolves the external references as follows:

  1. In MAIN.obj, the reference to func1 is resolved using the definition in MOD1.obj; the reference to func2 is resolved using the definition in MOD2.obj.

  2. In MOD1.obj, the references to printf_s and scanf_s are resolved using the definitions in the library that the linker finds named within MOD1.obj.

  3. In MOD2.obj, the references to myline and mycircle are resolved using the definitions in MYGRAPH.lib.

See also

MSVC Compiler Options
Setting Compiler Options