Syntax

‑‑whole_archive filename

Parameters

See Rules for specifying a filename or directory as parameters.

Description

Use this option to make the linker treat every object file in the archive as if it was specified on the command line. This is useful when an archive contains root content that is always included from an object file (filename extension o), but only included from an archive if some entry from the module is referred to.

Example

If archive.a contains the object files file1.o, file2.o, and file3.o, using ‑‑whole_archive archive.a is equivalent to specifying file1.o file2.o file3.o.

See also

Keeping modules.