The Scrap Heap is a wasteland of discarded objects — broken swords, empty potion bottles, shattered mirrors. But hidden among the junk are portal mirrors, and learning ln -s lets you build instant teleportation.

🎯 Quest Objectives

Understand the difference between hard links and symbolic links
Create a symbolic link with ln -s
Identify symlinks with ls -l (look for ->)
Resolve the target of a symlink with readlink
Use the scrap’s portal symlinks to shortcut navigation
Collect the portal crystal

�️ Quest Prerequisites

Cellar side-quest complete
Comfortable with ls -F, ls -l, and cd

⚡ Command Cheatsheet

Command	What It Does
`ln -s target link_name`	Create a symbolic link pointing to `target`
`ls -l`	Long listing — symlinks show `link -> target`
`ls -F`	Symlinks show with `@` marker
`readlink link_name`	Print the target of a symlink
`readlink -f link_name`	Print the fully-resolved absolute path
`realpath path`	Same as `readlink -f` (more modern)

Hard Link vs Symbolic Link

Property	Hard Link	Symbolic Link
Points to	Inode (data)	Path (name)
Works across filesystems	No	Yes
Target deleted	Link still works	Broken link (dangling)
`ls -F` marker	none	`@`

🗺️ Walkthrough

Step 1 — Survey the scrap heap

ls -F
# broken_sword  empty_bottle  portal_mirror@  scrap_pile/  crystal_hint

ls -l portal_mirror
# lrwxrwxrwx  1 user group  12 Jan 01  portal_mirror -> /vault/lab

portal_mirror is already a symlink — it points to the vault’s lab. You can cd portal_mirror and you will land directly in the lab.

Step 2 — Navigate via the existing portal

cd portal_mirror
pwd
# .../vault/lab   ← teleported!
cd -             # Return to previous directory (the scrap heap)
pwd
# .../scrap

cd - takes you back to wherever you were last. Very useful.

Step 3 — Read the hint

cat crystal_hint
# "Create a shortcut named 'quick_entrance' pointing to ../../ENTRANCE"

Step 4 — Create your own portal

ln -s ../../ENTRANCE quick_entrance
ls -l quick_entrance
# lrwxrwxrwx  1 user group  20 Jan 01  quick_entrance -> ../../ENTRANCE

ls -F quick_entrance/
# scroll  cellar/          ← entrance contents, via symlink

Step 5 — Inspect and resolve

readlink quick_entrance
# ../../ENTRANCE

readlink -f quick_entrance
# /home/user/bashcrawl/ENTRANCE  ← absolute, resolved path

Step 6 — Collect the crystal

cat crystal_hint
inventory
# portal crystal ✓

💡 Common Pitfalls

Problem	Cause	Fix
Symlink shows broken (red in terminal)	Target path does not exist	Check relative path with `readlink`
`ln -s` with no arguments	Wrong order	Syntax: `ln -s TARGET LINK_NAME`
`cd symlink` goes somewhere unexpected	Relative path off	Use absolute path or `readlink -f`
Cannot delete directory via symlink	Symlink vs directory	`rm symlink` removes the link; `rm -r` removes the target

Danger: rm -r symlink_to_dir may behave unexpectedly depending on your shell version. Prefer unlink symlink_name to safely remove only the link.

✅ Validation

You know the difference between ls -F @ and a real directory
You created quick_entrance and successfully cd‘d through it
You can resolve absolute target paths with readlink -f
The portal crystal is in your inventory

➡️ Next Steps

Complete other branches → Hidden Chapel · Vault
Enter the final gauntlet → The Rift
Back to hub → Bashcrawl Hub

📚 External Resources

Continue your terminal adventure with these resources:

Bashcrawl Web Demo — Play in your browser, no installation required
Bashcrawl on GitHub — Source code, setup, and open contributions
GNU Bash Manual — Symbolic Links — Portal magic for brave adventurers
IT-Journey Bashcrawl Hub — Full quest series and walkthroughs
Linux Symlinks Guide — Master the art of magical portals

Portals created. The dungeon’s geography bends to your will. 🗑️