proc_pid_root(5)

🎀 proc_pid_root(5) 🎀

okay bestie, welcome to the File Formats Manual entry for proc_pid_root(5) — yes, one entire man page for what looks like one little symlink, and honestly? it's giving main character energy and it deserves it. let's go 💅

---

✨ NAME ✨

• /proc/pid/root/ — symbolic link to root directory 🦋

---

🌸 DESCRIPTION 🌸

/proc/pid/root/

okay so here's the vibe: UNIX and Linux support the idea of a per-process root of the filesystem, and that whole thing gets set by the chroot(2) system call. This file is a symbolic link that points to the process's root directory, and it behaves in the same way as exe, and fd/*. no cap 🔥

but wait. this file is not merely a symbolic link 😭 it's so much more than that.

It provides the same view of the filesystem (including namespaces and the set of per-process mounts) as the process itself. like, the whole filesystem how that process sees it. an example illustrates this point, so buckle up:

In one terminal, we start a shell in new user and mount namespaces, and in that shell we create some new mounts:

$ PS1='sh1# ' unshare -Urnm;
sh1# mount -t tmpfs tmpfs /etc;  # Mount empty tmpfs at /etc
sh1# mount --bind /usr /dev;     # Mount /usr at /dev
sh1# echo $$;
27123

In a second terminal window, in the initial mount namespace, we look at the contents of the corresponding mounts in the initial and new namespaces:

$ PS1='sh2# ' sudo sh;
sh2# ls /etc | wc -l;                  # In initial NS
309
sh2# ls /proc/27123/root/etc | wc -l;  # /etc in other NS
0                                     # The empty tmpfs dir
sh2# ls /dev | wc -l;                  # In initial NS
205
sh2# ls /proc/27123/root/dev | wc -l;  # /dev in other NS
11                                    # Actually bind
                                      # mounted to /usr
sh2# ls /usr | wc -l;                  # /usr in initial NS
11

see how the counts are completely different depending on whose root you're peeking through? that's the whole point, bestie. the same /etc is 309 entries one way and 0 the other way, because in the other namespace /etc is an empty tmpfs. iconic.

Now for the sad part 🙈 In a multithreaded process, the contents of the /proc/pid/root symbolic link are not available if the main thread has already terminated (typically by calling pthread_exit(3)). so if your main thread dipped, that link is just... not there. 😭

Also: permission to dereference or read (readlink(2)) this symbolic link is governed by a ptrace access mode PTRACE_MODE_READ_FSCREDS check; see ptrace(2). don't skip the vibe check, basically 💅

---

🌈 SEE ALSO 🌈

• proc(5) — go read it, iykyk 💖

---

and that's the whole page, bestie!! 🫶 this was written up in the Linux man-pages 6.20 release, dated 2026-02-08, and it lives at proc_pid_root(5). mwah, slay, periodt ✨🎀