libssh2_channel_signal_ex(3)

💖 libssh2_channel_signal_ex — the libssh2 bestie manual 💖

okay so bestie, buckle up, we're doing libssh2_channel_signal_ex(3) today and honestly? it's giving "send a vibe check to a process" ✨

🌸 NAME 🌸

libssh2_channel_signal_ex — send a signal to a process that was previously opened on a channel 💅

🎀 SYNOPSIS 🎀

#include <libssh2.h>

int
libssh2_channel_signal_ex(LIBSSH2_CHANNEL *channel,
                          const char *signame,
                          size_t signame_len)

🦋 DESCRIPTION 🦋

So basically you can deliver a signal to the remote process/service. iconic. but lowkey — some servers or systems may not implement signals at all, and in that case they will probably ignore this message. so don't be shocked if nothing happens, it's not you, it's them 😭

Here's the cast of characters, no cap:

• channel — a previously opened channel instance, like the one you got back from libssh2_channel_open_ex(3) 🫶
• signame — the signal name, and it's the same as the signal name constant, just without the leading "SIG". so like, no SIG prefix bestie, we're keeping it cute ✂️
• signame_len — the length of the passed signal name parameter 📏

also there's a macro, libssh2_channel_signal(channel, signame), that literally supplies the strlen of the signame for you. the way that it just handles the length so you don't have to?? obsessed 💖

✨ RETURN VALUE ✨

Normal channel error codes, as always. and LIBSSH2_ERROR_EAGAIN when it would block 👑

👀 SEE ALSO 👀

• libssh2_channel_get_exit_signal(3)

libssh2 1.11.0 · 20 Apr 2023

and that's the whole page bestie, mwah 💋 go forth and signal your processes, periodt 🌈⭐