libssh2_sftp_fsetstat(3)

πŸ“¦
version 1.11.1 Β· 3 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian trixie, epel 10, epel 9, fedora 43, fedora 44, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– libssh2_sftp_fsetstat β€” bestie's guide to the lil macro that does the thing πŸ’–

okay so this is page libssh2_sftp_fsetstat(3) from the libssh2 manual, and honestly? it's a short one. a lil snack. but we're still gonna read it together because every page deserves main character energy. πŸŽ€


✨ NAME ✨

libssh2_sftp_fsetstat β€” it's a convenience macro for libssh2_sftp_fstat_ex(3) calls, no cap. that's literally the whole job description. πŸ’…


🌸 SYNOPSIS 🌸

okay so the way you summon this is:

#include <libssh2.h>
#include <libssh2_sftp.h>

int
libssh2_sftp_fsetstat(LIBSSH2_SFTP_HANDLE *handle,
                      LIBSSH2_SFTP_ATTRIBUTES *attrs);

look at those two includes. you need both. the LIBSSH2_SFTP_HANDLE *handle is your handle, and LIBSSH2_SFTP_ATTRIBUTES *attrs is your attributes pointer. iconic duo behavior fr fr. 🫢


πŸ¦‹ DESCRIPTION πŸ¦‹

so the tea is: this is a macro. not a function, a macro. and it's defined in a public libssh2 header file, so it's just sitting there in the headers waiting for you. 🧚

and what does that macro do? it uses the underlying function libssh2_sftp_fstat_ex(3). that's it. that's the whole vibe. it's giving "convenience wrapper" and we respect it for that. ✨

bestie lowkey: because it's a macro and it's leaning on libssh2_sftp_fstat_ex(3), all the real answers live over there. so keep reading. πŸ‘€

πŸ’€ RETURN VALUE πŸ’€

ngl, this page is not gonna tell you. it just says:

See libssh2_sftp_fstat_ex(3)

periodt. go read that one. 😭


πŸ™ˆ ERRORS πŸ™ˆ

same situation, same energy:

See libssh2_sftp_fstat_ex(3)

no extra lore here. all the error deets are in the other page. πŸ“


🌈 SEE ALSO 🌈

  • libssh2_sftp_fstat_ex(3) β€” the actual source of truth, the parent function, the one carrying this whole macro on its back. πŸ‘‘

and that's the whole page, bestie!! short, sweet, macro-flavored. πŸ’œ

this was pulled from the libssh2 manual, version 1.2.4, dated 20 Feb 2010 β€” so yeah, vintage, but still slaying. ⭐ go forth and fstat_ex responsibly. πŸŽ€πŸ’–