canonicalize_file_name(3)

💖 canonicalize_file_name(3) 💖

okay so bestie, welcome to the glow-up page for canonicalize_file_name — it lives in the Library Functions Manual (section 3, the library girlies) and honestly? she's giving "short but does the most". let's get into it 🎀

---

✨ NAME ✨

canonicalize_file_name — return the canonicalized absolute pathname

---

📚 LIBRARY 📚

Standard C library (libc, -lc) — yeah, she's in libc, we been knew 💅

---

🦋 SYNOPSIS 🦋

#define _GNU_SOURCE         /* See feature_test_macros(7) */
#include <stdlib.h>

char *canonicalize_file_name(const char *path);

quick note bestie: that #define _GNU_SOURCE line is not optional, it's how you unlock her (peep feature_test_macros(7) for the deets), and the include is <stdlib.h>. do not skip either one, i'm literally begging 🙈

---

🌸 DESCRIPTION 🌸

So canonicalize_file_name() hands you back a null-terminated string holding the canonicalized absolute pathname that corresponds to path. ✨

And in that returned string, the way that everything gets cleaned up?? iconic:

• symbolic links are resolved 🔗
• . and .. pathname components are resolved too
• consecutive slash (/) characters get replaced by a single slash

The returned string is dynamically allocated</> by canonicalize_file_name() itself, so bestie, the caller should deallocate it with free(3) when it is no longer required. if you don't, that's a leak, and that's not the vibe 💀

also lowkey the cutest part: the call

canonicalize_file_name(path)

is equivalent to the call

realpath(path, NULL);

same energy, same result. she's just a little alias-coded 🫶

---

🎀 RETURN VALUE 🎀

• On success, canonicalize_file_name() returns a null-terminated string. slay 💖
• On error (e.g., a pathname component is unreadable or does not exist 😭), canonicalize_file_name() returns NULL and sets errno to indicate the error.

ok so if you get NULL back, do NOT just keep vibing — check errno. she's trying to tell you something.

---

🌈 ERRORS 🌈

See realpath(3). that's the whole section, go look over there, she's got the receipts 📜

---

👑 ATTRIBUTES 👑

For an explanation of the terms used in this section, see attributes(7).

• Interface: canonicalize_file_name()
  • Attribute: Thread safety
  • Value: MT-Safe

yes bestie, MT-Safe — she can hang out with all your threads at once, no drama, no chaos, we love a multithread-safe queen 🔥

---

⭐ STANDARDS ⭐

GNU. that's it, that's the standard. (so if you're on non-GNU, vibe check first 👀)

---

💜 SEE ALSO 💜

• readlink(2)
• realpath(3)

---

and that's the whole page, no cap 🧚

mwah — this was canonicalize_file_name(3) from Linux man-pages 6.20, dated 2026-02-08. go free your strings, bestie. periodt. 💅✨🍓