8.3.16 Retain-symbols-file Option

The --retain-symbols-file file option keeps only those symbols listed in file.

This option retains only the symbols listed in the file file, discarding all others. The file is simply a flat file, with one symbol name per line. This option is especially useful in environments where a large global symbol table is accumulated gradually, to conserve run-time memory. --retain-symbols-file does not discard undefined symbols or symbols needed for relocations. You may only specify --retain-symbols-file once in the command line. It overrides the -s and -S options.