MONGOC_FIND_AN...ENT_VALIDATION(3)

💅 MONGOC_FIND_AND_MODIFY_OPTS_SET_BYPASS_DOCUMENT_VALIDATION(3) ✨

okay bestie, so this one is a manual page from libmongoc — yes, the MongoDB C driver — and it's all about one little function that lets you Tell The Database To Look The Other Way 🙈. Buckle up.

---

🌸 SYNOPSIS 🌸

bool
mongoc_find_and_modify_opts_set_bypass_document_validation (
   mongoc_find_and_modify_opts_t *opts, bool bypass);

🚨 heads up, queen: this option is only available when talking to MongoDB 3.2 and later. Older servers? They literally cannot, sorry.

---

🎀 PARAMETERS 🎀

• opts — a mongoc_find_and_modify_opts_t. Yep, that's the builder you're poking at.
• bypass — a bool saying whether the schema validation rules should just… be ignored. Like, straight up skipped.

---

✨ DESCRIPTION ✨

So what it does is add the bypassDocumentValidation argument to the builder. That's it. That's the whole vibe. 🦋

But here's the tea — when authentication is enabled, the authenticated user must have either the "dbadmin" or "restore" roles to bypass document validation. No roles, no bypass. Periodt. 👑

---

💖 RETURNS 💖

Returns true if it successfully added the option to the builder — slay, it worked. Otherwise it returns false and logs an error. 😭 So yeah, check your return values, bestie.

---

🧚 SETTING BYPASSDOCUMENTVALIDATION 🧚

The example file is called bypass.c and it's giving main character energy, honestly:

void
fam_bypass(mongoc_collection_t *collection)
{
   mongoc_find_and_modify_opts_t *opts;
   bson_t reply;
   bson_t *update;
   bson_error_t error;
   bson_t query = BSON_INITIALIZER;
   bool success;

   /* Find Zlatan Ibrahimovic, the striker */
   BSON_APPEND_UTF8(&query, "firstname", "Zlatan");
   BSON_APPEND_UTF8(&query, "lastname", "Ibrahimovic");
   BSON_APPEND_UTF8(&query, "profession", "Football player");

   /* Bump his age */
   update = BCON_NEW("$inc", "{", "age", BCON_INT32(1), "}");

   opts = mongoc_find_and_modify_opts_new();
   mongoc_find_and_modify_opts_set_update(opts, update);
   /* He can still play, even though he is pretty old. */
   mongoc_find_and_modify_opts_set_bypass_document_validation(opts, true);

   success = mongoc_collection_find_and_modify_with_opts(collection, &query, opts, &reply, &error);

   if (success) {
      char *str;

      str = bson_as_canonical_extended_json(&reply, NULL);
      printf("%s\n", str);
      bson_free(str);
   } else {
      fprintf(stderr, "Got error: \"%s\" on line %d\n", error.message, (int)(__LINE__));
   }

   bson_destroy(&reply);
   bson_destroy(update);
   bson_destroy(&query);
   mongoc_find_and_modify_opts_destroy(opts);
}

The way this lil program finds Zlatan, bumps his age by 1, and just casually bypasses validation while doing it?? iconic. 🔥

It outputs:

{
   "lastErrorObject" : {"updatedExisting" : true, "n" : 1},
                       "value" : {
                          "_id" : {"$oid" : "56562a99d13e6d86239c7b00"},
                          "age" : 34,
                          "firstname" : "Zlatan",
                          "goals" : 342,
                          "lastname" : "Ibrahimovic",
                          "profession" : "Football player",
                          "position" : "striker"
                       },
                                 "ok" : 1
}

---

👑 AUTHOR 👑

MongoDB, Inc — the whole entire company, fr fr.

💜 COPYRIGHT 💜

2009-present, MongoDB, Inc. — protect it at all costs 🫶

---

aaaand that's the page!! 🌈 this was libmongoc 2.5.6, dated Oct 09, 202 (the footer literally gets chopped off in the original and honestly? relatable 💀). mwah, go bypass some validation responsibly, bestie 💅🍓