LC_CHANNEL_SEND(3)

🎀 LC_CHANNEL_SEND(3) — NAME 🎀

okay so welcome to LC_CHANNEL_SEND(3), bestie — this is the Librecast Programmer's Manual and we're talking about lc_channel_send, lc_channel_sendmsg, and their whole job, which is: sending data on a Librecast channel 💌

📚 LIBRARY

the Librecast library, obviously — that's liblibrecast, and you link it with -llibrecast 🫶

✨ SYNOPSIS ✨

#include <librecast/net.h>

ssize_t lc_channel_send(lc_channel_t *chan, const void *buf, size_t len, int flags)
ssize_t lc_channel_sendmsg(lc_channel_t *chan, struct msghdr *msg, int flags);

Compile and link with -llibrecast. 🛠️

💖 DESCRIPTION 💖

okay so listen. each of these functions sends data over multicast on the librecast channel chan. and here's the vibe: they are analogous to the send(2) and sendmsg(2) calls. like, same energy, same shape, but multicast. iconic behavior honestly 👑

so in addition to the usual flags you'd use with send(2) and sendmsg(2), these functions support this one extra flag:

• MSG_DROP — this flag makes the packet get dropped instead of sent. it's used for testing, fr fr. all the normal processing still happens, like encoding and everything, proceeds as usual — the only thing skipped is the final send syscall. and the return value? it'll be the number of bytes that would have been sent 🫠✨

🦋 RETURN VALUE 🦋

these calls return the number of bytes received, or -1 if an error occurred 😭 and in the event of an error, errno is set to indicate the error. so check your errno, bestie, always.

💀 ERRORS 💀

see send(2). that's it, that's the section — go look, iykyk 🙈

🌈 SEE ALSO 🌈

• lc_ctx_new(3)
• lc_channel_new(3)
• send(2)
• sendmsg(2)

and that's the whole page, bestie!! this came to you straight from the LIBRECAST manual, dated 2023-08-09 — no cap, go forth and multicast responsibly 🎀💅🦋