GENSIO_ACC_SET_ACCEPT_CALLBACK_ENABLE_S(3)

✨ gensio_acc_set_accept_callback_enable 💖

okay bestie, welcome to gensio_acc_set_accept_callback_enable(3) — it's a Library Functions Manual page, and it's literally about the accept callback, so if you're out here accepting connections you're gonna wanna read this. no skipping 🫶

🌸 NAME 🌸

gensio_acc_set_accept_callback_enable, gensio_acc_set_accept_callback_enable_cb, gensio_acc_set_accept_callback_enable_s — Enable or disable the accept ready callback ✨

🎀 SYNOPSIS 🎀

#include <gensio/gensio.h>

void gensio_acc_set_accept_callback_enable(
                    struct gensio_accepter *accepter,
                    bool enabled);

int gensio_acc_set_accept_callback_enable_cb(
                    struct gensio_accepter *accepter,
                                 bool enabled,
                                 gensio_acc_done done,
                                 void *done_data);

int gensio_acc_set_accept_callback_enable_s(
                    struct gensio_accepter *accepter,
                                 bool enabled);

💅 DESCRIPTION 💅

so these three functions are your little on/off switch for the accept callback, like when connections come in. enable/disable the accept callback when connections come in, that's the whole vibe. 👑

gensio_acc_set_accept_callback_enable — this one does an asynchronous disable. and like, heads up bestie: this can race with pending and running callbacks, so you must be prepared to handle these races. no cap, it's just how it is. 😭

gensio_acc_set_accept_callback_enable_cb — same energy as the one above, except it does a callback when the enable is complete. it's really only useful for disable, because when the done callback fires, that means no more accepts will be called and all callbacks are done. and listen: if you call this, you cannot do another enable/disable until done is called. periodt. 💅

gensio_acc_set_accept_callback_enable_s — like above, but a synchronous call. see the notes on gensio_open_s() for the dangers of using this function. yes, dangers. go read them. 🙈

⭐ RETURN VALUES ⭐

Zero is returned on success, or a gensio error on failure. that's it, that's the whole thing. slay. ✨

🦋 SEE ALSO 🦋

• gensio_err(3)
• gensio(5)
• gensio_open_s(3)

🌈 and that's the page, bestie! go forth and accept those connections responsibly, and remember: races are real, synchronous calls are spicy, and you are the main character. iykyk 💖

this iconic little page is dated 27 Feb 2019 and comes to you straight from the gensio library, gensio_acc...back_enable(3) — mwah, no notes, obsessed. 🎀🫶💜