GEARMAN_CLIENT_ADD_SERVER(3)

💖 GEARMAN_CLIENT_ADD_SERVER(3) 💖

okay bestie, gather round, because we're talking about Gearmand — yes, that Gearmand, the one from <http://gearman.info/> — and specifically about how you tell your client where all the gearmand servers live. this is the GEARMAN_CLIENT_ADD_SERVER(3) page and honestly? it's giving infrastructure. let's get into it 🫶

---

✨ NAME ✨

gearman_client_add_server — Gearmand Documentation, <http://gearman.info/>

like literally that's the name, that's the function, that's the whole vibe. it's the documentation page for the Gearmand crew. 💅

---

🌸 SYNOPSIS 🌸

first things first, you gotta pull in the header, no cap:

#include <libgearman/gearman.h>

then here's the whole squad of functions, exactly as they're declared:

gearman_return_t <#c.gearman_return_t>
gearman_client_add_server(gearman_client_st <#c.gearman_client_st>
*client, const char *host, in_port_t <#c.in_port_t> port)

gearman_return_t <#c.gearman_return_t>
gearman_client_add_servers(gearman_client_st <#c.gearman_client_st>
*client, const char *servers)

void gearman_client_remove_servers(gearman_client_st <#c
.gearman_client_st> *client)

that's three functions, three jobs, one very cute little trio. ✨

---

🦋 DESCRIPTION 🦋

okay so here's the tea, function by function:

• gearman_client_add_server() will add an additional gearmand server to the list of servers that the client will take work from. one more server, one more friend in the group chat. 🫶
• gearman_client_remove_servers() will remove all servers from the gearman_client_st <#c.gearman_client_st>. and yes bestie, all of them. not one, not a few — every single one. the whole roster, gone. 💀
• gearman_client_add_servers() takes a list of gearmand servers that will be parsed to provide servers for the client. so instead of adding them one at a time like a slowpoke, you hand over a whole list and it does the parsing for you. iconic behaviour honestly.

and the format for that list? it's this, exactly:

SERVER[:PORT][,SERVER[:PORT]]...

examples of this are::

10.0.0.1,10.0.0.2,10.0.0.3
localhost234,jobserver2.domain.com:7003,10.0.0.3

see how the port is optional? you can just drop a bare SERVER and let it vibe, or go full SERVER:PORT when you're feeling specific. the second example there is the ✨ chaos edition ✨ — one bare host, one host with :7003, one IP. all in one comma-separated list. slay.

---

💜 RETURN VALUE 💜

gearman_client_add_server() and gearman_client_remove_servers() both return gearman_return_t <#c.gearman_return_t>.

heads up bestie: the original page only names those two for the return value, and gearman_client_add_servers() isn't listed there. i'm not gonna invent an answer for you — i'm just telling you exactly what the page says. 👑

---

🎀 HOME 🎀

wanna find out more? the page says to check:

<http://gearman.info/>

and then it also says:

See also:

• gearmand(8)
• libgearman(3)
• gearman_client_st

the whole family, all linked up. 💖

---

🌈 Author 🌈

Data Differential — <http://www.datadifferential.com/>

⭐ Copyright ⭐

2011-2014, Data Differential, <http://www.datadifferential.com/>

---

that's the page, bestie, start to finish, no skips, no skimming, no "i'll read it later" (you won't). now go add a server. or don't. either way you know how now. 👑💅

this has been version 1.1.21+ds, dated Feb 04, 2026, from your favourite man page era — take care of yourself, hydrate, and remember: gearman_client_remove_servers() takes everything, so maybe don't call it on a whim. mwah. 🦋🌸💖