Unlike a POSIX read/write lock, in which both a read lock and a write
lock are unlocked by the same function, Windows requires that a read
lock is unlocked by a different function than a write lock.

Related: CDRIVER-3514

Co-authored-by: Kevin Albertson <kevin.albertson@10gen.com>

---------

Co-authored-by: Kevin Albertson <kevin.albertson@10gen.com>

* unskip `/server_discovery_and_monitoring/monitoring/heartbeat/pooled/dns`

* use `.invalid` TLD in test

To reliably return DNS error

* remove unnecessary test skips

Test expects to fail DNS lookup. Does not require internet.

* remove unused `test_framework_skip_if_rhel8_zseries`

* reduce serverSelectionTimeoutMS to speed up test

* update comment and expected error

* measure duration after destroy client or pool

Destroying the client or pool results in sending `endSessions`. This may result in another heartbeat attempt.

CDRIVER-3514

* Share SCRAM cache via a global lookup table
* Suppress pre-existing race condition
* Fix pre-existing memory leak
* Add test for scram cache invalidation

---------

Co-authored-by: Kevin Albertson <kevin.albertson@10gen.com>
Co-authored-by: Adrian Dole <donald@dole.tech>

* run simple_http_server.py on port 18000

Port 8000 conflicts with HAProxy started by run-load-balancer.sh in DET

* update load_balancers specification tests

Update to commit https://github.com/mongodb/specifications/commit/5af2ab77a6e68a4528085504ab6bd1360d30a6c8

 to fix test failure when an error is expected.

* use `hello`, not `isMaster` in test failpoint

* add new loadbalanced Evg config

* remove legacy load balanced config

* regenerate Evergreen config

* Sort imports

Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>

* check for `Unknown` or `PossiblePrimary`

* unskip `/Client/get_handshake_hello_response/pooled`

* unskip `/BulkOperation/split`

* use session in test operations

* apply read and write concern majority

* skip test if no sessions support

* Docs additions and updates:

- Enable the documentation index. Begin using index entries.
- Add a reference page for Linux, Conand, and vcpkg packages and how
  they can be found/used.
- Add a tutorial section for installing via vcpkg.

* Add an in-source example/test that uses vcpkg

This is a very minimal example and test case that installs the
release (not local!) version of libbson and libmongoc, and then tests
that the application builds and runs correctly. There is no CI task
for this yet, as it is unstable and does not make use of the local
source tree. Future updates may make a more thorough test case that
overrides the source for the vcpkg mongo-c-driver port to use the local
source tree, thus giving a route for automated testing of changes
against the third-party portfile.

* Add links to external port+recipes
* Tweak inclusion of the genindex page.

Including the genindex in a toctree seems to create a conflict with
the full_index page which tries to include the root `index.rst` via
another toctree? This is odd, but easy enough to work around.

* unskip mock tests referenced in CDRIVER-4350

* unskip `entity-client-storeEventsAsEntities`

As of https://github.com/mongodb/mongo-c-driver/pull/1220 the `storeEventsAsEntities` operation is supported in the test runner

* remove `/unified/entity-client-cmap-events` from skip-tests.txt

Test is already skipped in runner.c

* remove `/unified/entity-client-storeEventsAsEntities` from skip-tests.txt

Test is already skipped in runner.c

* remove `/unified/assertNumberConnectionsCheckedOut` from skip-tests.txt

Test is already skipped in runner.c

* unskip `/Stepdown/not_primary_keep`

* add reference to specification

* separate `/Stepdown` tests into `/pooled` and `/single`

This may help to narrow down a test failure. A failing assert does not identify whether a pooled client was used.

* use macro to reduce repetition

* use Ubuntu 20.04 variant for MongoDB 7.0+ in new Evergreen config

* split legacy AWS tasks into ubuntu1804 and ubuntu2004 variants

* split legacy Versioned API tasks into ubuntu1804 and ubuntu2004 variants

Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>

* unskip `/Topology/multiple_selection_errors`

* use `.invalid` domains in test

Intended to get a reliable DNS error, rather than contacting `example.com`

Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>

* CDRIVER-4338 unskip `/Topology/request_scan_on_error`

* CDRIVER-4339 unskip `/streamable/topology_version/update`

* CDRIVER-4340 unskip `/Client` tests

* CDRIVER-4337 unskip `/command_monitoring/unified/redacted-commands`

* CDRIVER-4336 unskip `/versioned_api` tests

* Clean up of TLS detection and import
* Earthly TLS controls and cleaner build envs
Adds a --tls build parameter to switch TLS backends. This PR also adds
a "str" utility for doing more concise string manipulation in POSIX sh.
* EVG Earthly tasks for more build configurations
This refactors earthly.py for extensibility and to match the
parameterization used in Earthfile.
* Support "auto" in Earthfile
* Tweak name spacing
* More feature and package summary information
* Unused LibreSSL compat

* format `test-happy-eyeballs.c`

* remove unreferenced `test_happy_eyeballs_retirement`

* set `MONGOC_TEST_IPV4_AND_IPV6_HOST` in mock server tests

Needed to run the `/TOPOLOGY/happy_eyeballs` tests

Use OP_MSG exhaust for mongod >= 4.2. Enable exhaust cursors for mongos >= 7.1.

* add `restore-instance-profile` function

---------

Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>

* Redefine the handling of SASL imports

Tweak importing of libsasl2 for user requirements

Tweaks the import of libsasl2 so that at import-time we don't
*require* the pkg-config files, since the dynamic library's dep
on libsasl should be sufficient to satisfy the runtime linking.

* Add FeatureSummary
* Bump Earthly version, allow setting sasl options
* Include dependencies for finding libsasl2
* Define more Earthly tasks
* make _mongo_pick public, tweak signature of bool01
* Add Earthly target for testing against cxx-driver

Build +test-cxx-driver to run a default mongo-cxx-driver using the
local mongo-c-driver as the driver backend.

* Better Earthly target docs
* Fix SASL path finding for Windows, and use parallel Make

* print failing URI on test failure

* refactor `_detect_nongenuine_hosts` to use separate helper and accept `mongoc_uri_t`

* move `_detect_nongenuine_hosts` earlier

This is intended to ease testing. Tests using bogus URIs will fail SRV lookup. Checking before SRV lookup allows tests to observe the log.

* check SRV hostname

---------

Co-authored-by: Jeremy Mikola <jmikola@gmail.com>
Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>

* Fix testing instructions

Previously, following the testing instructions in CONTRIBUTING.md
results in the following error:
```
"error":"NonExistentPath: Data directory /data/db not found. Create the missing directory or specify another path using (1) the --dbpath command line option, or (2) by adding the 'storage.dbPath' option in the configuration file."
```
This adds the dbpath to the command line so that way one can copy and
paste the instructions in order to run tests.

Also, prefer to use the newer mongosh over mongo.

---------

Co-authored-by: Kevin Albertson <kevin.albertson@10gen.com>

* silence `kinit` check

* do not assume existence of `krb5.conf`

Instead: check for presence of `kinit` command.
`/etc/krb5.conf` does not appear present on macOS hosts.

* regenerate Evergreen config