PVFS2-LN(1)

💖 PVFS2-LN(1) — like, the OrangeFS soft link maker 💖

okay bestie, welcome to the pvfs2-ln page from the General Commands Manual — it's the little tool that makes a soft link in an OrangeFS volume and honestly? it eats. let's get into it. 🎀

---

✨ NAME ✨

pvfs2-ln — create a soft link in an OrangeFS volume 🦋

---

✨ SYNOPSIS ✨

pvfs2-ln -s [-Vvh] target link_name

like, that's it. that's the whole vibe. 💅

---

✨ DESCRIPTION ✨

so the pvfs2-ln utility creates a soft link — a symlink, bestie, the little pointer one — at link_name that points to target, where target is gonna live in an OrangeFS volume. 🫶

and here's the slay part: link_name can refer to files across file systems and even to files that don't even exist yet. icon behaviour, no cap. ✨

the options are as follows:

• -V — display verbose messages. it's giving chatty. 🗣️
• -v — print the version number and exit. bye. 👋
• -h — display the synopsis. the little reminder, yk? 📜

---

🌈 ENVIRONMENT 🌈

• PVFS2_DEBUGFILE — if you set this to the path of a local file, the debug output gets redirected to that file instead. keep the receipts in one place fr fr. 📝
• PVFS2_DEBUGMASK — sets the OrangeFS debug mask. all the possible masks are documented over in pvfs2-set-debugmask(1), so go check her out. 🎭
• PVFS2TAB_FILE — if you set this, it's the full pathname for an alternate pvfs2tab file. swap in your own, main character energy. 👑

---

🌸 FILES 🌸

• /etc/pvfs2tab

---

💫 EXAMPLES 💫

1. create a link at /mnt/bar referring to the file /mnt/foo, referring to it by a relative path. cute.

pvfs2-ln -s foo /mnt/bar

2. create a link at /mnt/bar referring to the file /etc/motd — which is not in the OrangeFS volume at all. yes, we're reaching outside. obsessed. 🦋

pvfs2-ln -s /etc/motd /mnt/bar

---

😭 CAVEATS 😭

a link to a file outside of the OrangeFS volume will refer to a different file if the file system is mounted at different mount points or on different machines. so like… be aware, bestie. it's not a bug it's a whole situation. 💀

---

🐛 BUGS 🐛

please submit bug reports to devel@lists.orangefs.org — they wanna hear from you, fr fr. 🙈

---

🫶 SEE ALSO 🫶

• ln(1)
• pvfs2-cp(1)
• pvfs2tab(5)

---

and that's the whole page, bestie — this one came from the General Commands Manual source, dated 2017-06-30, filed under PVFS2-LN(1). go make some links, you're gonna slay. 💅✨🎀