GFS_RMDIR(3)

💖 GFS_RMDIR(3) — the Gfarm manual, bestie edition 💖

okay so this is a page from the Gfarm manual, section 3 (that's the library-functions girlies 🫶), and today we're talking about gfs_rmdir. yes, it does exactly what you think. no cap.

✨ NAME ✨

gfs_rmdir — delete a directory 💅

🌸 SYNOPSIS 🌸

#include <gfarm/gfarm.h>

gfarm_error_t gfs_rmdir(const char * gfarm_url);

like. look at her. one header, one function, one const char *. iconic behavior honestly.

🦋 DESCRIPTION 🦋

gfs_rmdir() deletes a directory whose name is the string specified by gfarm_url.

and bestie. listen. the directory must be empty. that's not a suggestion, that's the vibe check, and if it fails the vibe check it will simply not go. 🙈

👑 RETURN VALUES 👑

okay so this function returns a gfarm_error_t and here's the whole roster, no skipping, we don't do that here:

• GFARM_ERR_NO_ERROR — the function terminated successfully. slay. she ate. 🎀
• GFARM_ERR_NO_MEMORY — insufficient memory was available. the computer is going through it rn 😭
• GFARM_ERR_PERMISSION_DENIED — gfarm_url points outside your accessible address space. not yours, not your business 💀
• GFARM_ERR_DIRECTORY_NOT_EMPTY — directory is not empty. told you bestie. empty it first. 🧹
• GFARM_ERR_NO_SUCH_OBJECT — directory does not exist. she's not there. she was never there. 🌈
• GFARM_ERR_NOT_A_DIRECTORY — a component of the path prefix is not a directory. something in the path is giving… not a directory. 🙈
• Others — an error except the above occurred. the reason is shown by gfarm_error_string(3). so go read that one, iykyk. 💜

fr fr: if you get anything that isn't GFARM_ERR_NO_ERROR, go hit up gfarm_error_string(3) and it'll tell you what's up.

💫 SEE ALSO 💫

gfarm_error_string(3)

that's the whole page bestie, mwah 💖

with love from the Gfarm girlies, dated 23 Jun 2019 — stay empty, stay deletable, stay slaying ✨👑💅