🗺️ धडा 02 — Files, paths आणि permissions: इमारतीचा नकाशा

📍 तुम्ही इथे आहात: 12 पैकी धडा 02 · पुढे: lesson-03-pipes-redirection

📦 या ब्रँचमध्ये काय आहे

धडे 01–02. गोष्टी कुठे आहेत, त्यांना कुठूनही नाव कसे द्यायचे, आणि कोण त्या वाचू, बदलू किंवा चालवू शकते.

bin/school.sh — HERE= ओळ: आपल्याला कुठून बोलावले याची पर्वा न करणारी script

🧒 5 वर्षांच्या मुलाला समजावल्यासारखे

शाळा ही एक इमारत आहे: एक मुख्य दार (/), कॉरिडॉर (folders) आणि खोल्या (files). तुम्ही खोलीचे नाव मुख्य दारापासून सांगू शकता — absolute path, /home/you/school/data/register.csv — किंवा तुम्ही जिथे उभे आहात तिथून — relative path, data/register.csv. प्रत्येक खोलीवर एक पाटी असते की कोण ती वाचू शकते, तिच्यावर लिहू शकते, किंवा आत जाऊ/चालवू शकते: owner, त्याचा group, आणि बाकी सगळे.

🗺️ आकृती

flowchart TD
  R["/"] --> H["home/you"] --> S["school/"] --> D["data/register.csv  -rw-r--r--"]
  S --> B["bin/school.sh  -rwxr-xr-x"]
  S --> L["lib/log.sh"]

❓ काय

pwd मी कुठे आहे · cd जा · ls -la यादी, लपलेल्या .files सकट · ~ home · . इथे · .. वर · * एक wildcard जो command ला दिसण्याआधीच shell expand करतो.
Permissions rwx × (owner, group, others): -rwxr-x--- = owner सगळे करू शकतो, group वाचू आणि चालवू शकतो, others काहीच नाही. chmod +x, chmod 600, chown user:group.
scripts आणि folders साठी 755, files साठी 644, secrets साठी 600.
सगळे काही file आहे: /etc config, /var/log logs, /tmp कच्चे काम, /proc इमारतीचा live dashboard, /dev/null कचरापेटी.
anchor: HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" — script चा स्वतःचा folder, बोलावणाऱ्याचा cwd काहीही असो.

🤔 का

"No such file" आणि "permission denied" या कोणत्याही script मधल्या दोन सर्वात नेहमीच्या errors आहेत, आणि दोन्ही याच धड्यात आहेत. फक्त एकाच folder मधून चालवल्यावर चालणारी script पूर्ण झालेली नाही.

🔧 कसे (या repo मध्ये)

school.sh HERE काढते आणि त्यावरून ../data/register.csv ला संदर्भ देते, म्हणून bin/school.sh आणि cd /tmp && /path/to/bin/school.sh सारखेच वागतात.

🧪 करून पाहा

ls -la bin/ data/                       # who may run what
cd /tmp && "$OLDPWD/bin/school.sh" list && cd -     # called from elsewhere: still finds the register
cp bin/school.sh /tmp/s.sh && chmod -x /tmp/s.sh && /tmp/s.sh list; echo "exit $?"   # permission denied → 126
chmod 600 data/register.csv && ls -l data/register.csv && chmod 644 data/register.csv
find . -name '*.sh' | sort

✅ तपासा — तुम्हाला काय दिसायला हवे

नोंदवही /tmp मधूनही दिसते; x नसलेली copy Permission denied आणि exit 126 ने fail होते; 600 नंतर ls -l -rw------- दाखवतो.

🏁 तुम्ही आत्ताच काय सिद्ध केले

तुम्ही कोणत्याही file ला कुठूनही नाव देऊ शकता, तिची permission पाटी वाचू शकता, आणि स्वतःच्या files स्वतः शोधणारी script लिहू शकता.

⚠️ नेहमीच्या चुका

cron / मधून चालवत असलेल्या script मध्ये relative paths.
error घालवण्यासाठी chmod 777. आता कोणीही तुमची script बदलू शकतो.
quotes शिवाय filenames मध्ये spaces (धडा 05) — rm My Report.txt अस्तित्वात नसलेल्या दोन files काढायला जातो आणि जी आहे ती तशीच राहते.

🏭 प्रत्यक्ष वापरात हे का महत्त्वाचे: group ला वाचता येणारी secrets, 644 वर असलेली deploy key, image मध्ये x नसलेली script — प्रत्येक एक खरा incident आहे. ship करण्यापूर्वी ls -l करा.

⏭️ पुढे

धडा 03 — pipes आणि redirection: कॉरिडॉर, आणि report व log कधीच का मिसळू नयेत.

🗺️ Lesson 02 — Files, paths & permissions: the building map

📍 You are here: Lesson 02 of 12 · Next: lesson-03-pipes-redirection

📦 What's in this branch

Lessons 01–02. Where things are, how to name them from anywhere, and who may read, change or run them.

bin/school.sh — the HERE= line: a script that does not care where it is called from

🧒 Explain like I'm 5

The school is a building with one front door (/), corridors (folders) and rooms (files). You can name a room from the front door — an absolute path, /home/you/school/data/register.csv — or from where you are standing — a relative path, data/register.csv. Each room has a sign saying who may read it, write on it, or enter/run it: the owner, their group, everyone else.

🗺️ Diagram

flowchart TD
  R["/"] --> H["home/you"] --> S["school/"] --> D["data/register.csv  -rw-r--r--"]
  S --> B["bin/school.sh  -rwxr-xr-x"]
  S --> L["lib/log.sh"]

❓ What

pwd where am I · cd go · ls -la list, including hidden .files · ~ home · . here · .. up · * a wildcard the shell expands before the command sees it.
Permissions rwx × (owner, group, others): -rwxr-x--- = owner can do everything, group can read and run, others nothing. chmod +x, chmod 600, chown user:group.
755 for scripts and folders, 644 for files, 600 for secrets.
Everything is a file: /etc config, /var/log logs, /tmp scratch, /proc the building's live dashboard, /dev/null the bin.
The anchor: HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" — the script's own folder, whatever the caller's cwd.

🤔 Why

"No such file" and "permission denied" are the two most common errors in any script, and both are this lesson. A script that works only when run from one folder is not finished.

🔧 How (in this repo)

school.sh computes HERE and refers to ../data/register.csv from it, so bin/school.sh and cd /tmp && /path/to/bin/school.sh behave the same.

🧪 Try it

ls -la bin/ data/                       # who may run what
cd /tmp && "$OLDPWD/bin/school.sh" list && cd -     # called from elsewhere: still finds the register
cp bin/school.sh /tmp/s.sh && chmod -x /tmp/s.sh && /tmp/s.sh list; echo "exit $?"   # permission denied → 126
chmod 600 data/register.csv && ls -l data/register.csv && chmod 644 data/register.csv
find . -name '*.sh' | sort

✅ Verify — what you should see

The register lists from /tmp too; the copy without x fails with Permission denied and exit 126; ls -l shows -rw------- after 600.

🏁 What you just proved

You can name any file from anywhere, read its permission sign, and write a script that finds its own files.

⚠️ Common mistakes

Relative paths in a script that cron runs from /.
chmod 777 to make an error go away. Now everyone can edit your script.
Spaces in filenames without quotes (lesson 05) — rm My Report.txt removes two files that do not exist and leaves the one that does.

🏭 Why this matters in production: secrets readable by the group, a deploy key at 644, a script without x in the image — each is a real incident. ls -l before you ship.

⏭️ Next

Lesson 03 — pipes & redirection: the corridors, and why the report and the log must never mix.

← Previouswhy the shell Next →pipes redirection

This page is the lesson's README from the lesson-02-files-and-paths branch, shown here so the whole School stays on one site. Code files open on GitHub at the same branch.