libssh2_scp_send64(3)

💖 libssh2_scp_send64 — bestie edition 💖

okay so this is a page from the libssh2 manual, section 3 (library functions, iykyk), and it's all about yeeting a whole file at a remote host over SCP. no cap, it's giving main character energy. let's get into it 🫶

---

✨ NAME ✨

libssh2_scp_send64 — Send a file via SCP

like. literally that's the whole vibe. send a file. via SCP. iconic 💅

---

🌸 SYNOPSIS 🌸

#include <libssh2.h>

LIBSSH2_CHANNEL *
libssh2_scp_send64(LIBSSH2_SESSION *session, const char *path, int mode,
                   libssh2_uint64_t size, time_t mtime, time_t atime);

yes she takes six arguments, she's high maintenance and she deserves it 💜

---

🦋 DESCRIPTION 🦋

• session — the Session instance, aka the one you got back from libssh2_session_init_ex(3). your whole connection lives in there.
• path — Full path and filename of the file you're transferring to. bestie, that's the remote file name. the one on the other side of the wire. don't get it twisted 🙈
• mode — File access mode to create the file with.
• size — Size of the file being transmitted (Must be known ahead of time). and listen, this one's important: it needs to be passed in as variable type libssh2_uint64_t. That type is 64 bit on modern operating systems and compilers. she's thicc. she's built different. 💪
• mtime — mtime to assign to the file being created.
• atime — atime to assign to the file being created. (Set this and mtime to zero to instruct the remote host to use the current time. cute little shortcut, slay ⭐)

and that's it. that's the function. Send a file to the remote host via SCP. periodt. 💖

---

👑 RETURN VALUE 👑

Pointer to a newly allocated LIBSSH2_CHANNEL instance. or NULL on errors 😭

so like, check your pointers, bestie. always check your pointers.

---

💀 ERRORS 💀

• LIBSSH2_ERROR_ALLOC — An internal memory allocation call failed. the malloc girlies are crying.
• LIBSSH2_ERROR_SOCKET_SEND — Unable to send data on socket. the socket said no 🙅
• LIBSSH2_ERROR_SCP_PROTOCOL — (no extra detail given, she's mysterious like that 🎀)
• LIBSSH2_ERROR_EAGAIN — Marked for non-blocking I/O but the call would block. not an L, just a "come back later" 💅

---

🌈 AVAILABILITY 🌈

This function was added in libssh2 1.2.6 and is meant to replace the former libssh2_scp_send_ex(3) function. out with the old, in with the new, glow-up complete ✨

---

🔥 SEE ALSO 🔥

• libssh2_channel_open_ex(3)

go read that one next, bestie, it's the whole prequel 🫶

---

lowkey reminder: size must be known ahead of time, and it must be libssh2_uint64_t. no guessing. the remote host is counting on you. 🙈

---

okay that's the whole page, mwah 💋 this was libssh2 1.2.6, dated 17 Apr 2010 — yes she's vintage, she's a classic, she ate and left no crumbs 👑✨ bye bestie, go send some files 💖🦋🌸