Add whole_archive option to cc::Build

[onalante-msft]

Rust 1.61 no longer links with whole-archive in some cases, instead linking in this manner only if requested¹. This means that the emitted Cargo metadata can sometimes be insufficient to produce usable artifacts from cc::Build outputs². A workaround is to set cargo_metadata to false and print the appropriate rustc-link-{lib,search} arguments, but having this as a built-in option would be helpful since the default linking mode (with respect to the Cargo metadata) is static linking.

Footnotes

1. https://github.com/rust-lang/rust/blob/1.61.0/RELEASES.md#compatibility-notes ↩

2. Concrete example: bind_engine and v_check from here are omitted when linking into a cdylib: build script. ↩

[petrochenkov]

Previous PR about this - #671.

[onalante-msft]

My apologies, I completely missed that. That PR is definitely the better option. Thank you for the reference.