MONGOC_CLIENT_SET_APPNAME(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💅 MONGOC_CLIENT_SET_APPNAME(3) 💅

okay bestie, welcome to libmongoc's little corner of the manual — this page is all about mongoc_client_set_appname, and honestly? it's giving "tiny function, big personality." let's get into it ✨

🌸 SYNOPSIS 🌸

bool
mongoc_client_set_appname (mongoc_client_t *client, const char *appname)

So what does it do? It sets the application name for this client. That string, along with a bunch of other internal driver details, gets sent to the server as part of the initial connection handshake — you know, the "hello". literally the first thing your client says to the server. main character energy fr fr 👑

And here's the cute part: appname is copied, so it doesn't have to stay valid after the call to mongoc_client_set_appname(). you can free that string the second you're done, she's got her own copy now, she's fine 💖

🚨 but listen — this function will log an error and return false in these cases, no cap: - appname is longer than MONGOC_HANDSHAKE_APPNAME_MAX - client has already initiated a handshake (too late, bestie, the hello has been said 😭) - client comes from a mongoc_client_pool_t

🎀 PARAMETERS 🎀

  • client — a mongoc_client_t. the client in question. the one and only.
  • appname — the application name, of length at most MONGOC_HANDSHAKE_APPNAME_MAX. keep it cute and keep it short 💅

⭐ RETURNS ⭐

true if the appname is set successfully. otherwise, false. that's it, that's the vibe check 🦋

💜 AUTHOR 💜

MongoDB, Inc — the icons who made this happen 🫶

2009-present, MongoDB, Inc.

and that's the whole page, bestie, you ate that 🍓 signing off from the libmongoc edition, version 2.5.6, dated Oct 09, 2026 — go forth and name your apps, just do it before the handshake, iykyk 💀✨

📦 where this page comes from