MONGOC_CLIENT_...UTO_ENCRYPTION(3)

✨ SYNOPSIS ✨

Okay so first things first, bestie: this is MONGOC_CLIENT_...UTO_ENCRYPTION(3) from the libmongoc manual, and the function is literally mongoc_client_enable_auto_encryption(). It enables automatic In-Use Encryption on a mongoc_client_t. 💖

          bool
          mongoc_client_enable_auto_encryption (mongoc_client_t *client,
                                                mongoc_auto_encryption_opts_t* opts,
                                                bson_error_t* error);

This whole thing requires libmongoc to be built with support for In-Use Encryption. See In-Use Encryption for instructions to enable In-Use Encryption in libmongoc. ✨

Automatic encryption is an enterprise only feature that only applies to operations on a collection. Automatic encryption is not supported for operations on a database or view, and operations that are not bypassed will result in error. To bypass automatic encryption for all operations, bypass automatic encryption with mongoc_auto_encryption_opts_set_bypass_auto_encryption() in opts. 💅

Automatic encryption requires the authenticated user to have the listCollections privilege action. 👑

Enabling automatic encryption reduces the maximum message size and may have a negative performance impact. Not me warning you: it's giving “tradeoff,” bestie. 😭

Only applies to a single-threaded mongoc_client_t. To use with client pools, see mongoc_client_pool_enable_auto_encryption(). 🫶

---

🎀 PARAMETERS 🎀

• client — A mongoc_client_t.
• opts — A required mongoc_auto_encryption_opts_t.
• error — A bson_error_t which is set on error.

🌸 RETURNS 🌸

True on success. False on error. On error, error is set. That's the whole vibe check. ✅

👀 SEE ALSO 👀

• mongoc_auto_encryption_opts_t
• mongoc_client_pool_enable_auto_encryption()
• In-Use Encryption for libmongoc
• The MongoDB Manual for Client-Side Field Level Encryption
• The MongoDB Manual for Queryable Encryption

👑 AUTHOR 👑

MongoDB, Inc

🎀 COPYRIGHT 🎀

2009-present, MongoDB, Inc.

---

Sign-off tea: source/version is libmongoc 2.5.6, and the footer date shows Oct 09, 202 before the title text runs into it — mwah, bye bestie! 💅🦋