SHTOOL-MKDIR.TMP(1)

💖 SHTOOL-MKDIR.TMP(1) 💖

ok so bestie, this is the page for shtool-mkdir, living inside the GNU Portable Shell Tool (yes, that's the manual name, that's the vibe) ✨

---

🌸 NAME 🌸

shtool-mkdir — the GNU shtool mkdir(1) style command 🎀

---

✨ SYNOPSIS ✨

shtool mkdir [-t|--trace] [-f|--force] [-p|--parents] [-m|--mode mode]
[-o|--owner owner] [-g|--group group] dir [dir ...]

like, that's the whole shape of it, no cap 💅

---

🦋 DESCRIPTION 🦋

So this is a mkdir(1) style command, but it comes with extra options and it's smart — it knows what to do when the directory is already there, which is literally the whole reason it exists, because installation procedures need that. 👑

---

🎀 OPTIONS 🎀

here's everything you can hand it, bestie:

• -t, --trace — shows you the shell commands that are actually involved. it's giving behind-the-scenes. 🔍
• -f, --force — forces it to keep going and says nothing when the directory already exists, no complaints, we move. by default it terminates with an error instead. 😤
• -p, --parents — auto-creates the parent directories for you. by default it only makes the last directory in the path and just fails if the parents aren't there. 🫶
• -m, --mode mode — the directory mode applied to the directory, see chmod(1). if you omit mode it skips this step entirely and leaves whatever the operating system default is, which is usually based on umask(1). heads up: some directory modes need superuser privileges to be set. default is to stick with the operating system defaults. 🔐
• -o, --owner owner — the directory owner name or id applied to the directory, see chown(1). this one requires superuser privileges to execute. default is to skip the step and leave the operating system default, which is usually based on the executing uid or the parent setuid directory. 👑
• -g, --group group — the directory group name or id applied to the directory, see chgrp(1). this also requires superuser privileges to execute to the fullest extent — otherwise, on most operating systems, your choice of group is limited. default is to skip the step and leave the operating system default, which is usually based on the executing gid or the parent setgid directory. 🌈

---

🍓 EXAMPLE 🍓

here's how it looks in the wild, bestie:

#   Makefile
install:
    shtool mkdir -f -p -m 755 $(bindir)
    shtool mkdir -f -p -m 755 $(mandir)/man1
     :

---

💜 HISTORY 💜

The GNU shtool mkdir command was originally written for Public Domain by Noah Friedman, and then later revised by Ralf S. Engelschall <rse@engelschall.com> in 1999 so it could be included into GNU shtool. a little origin story for you 🧚

---

⭐ SEE ALSO ⭐

• shtool(1)
• mkdir(1)

---

ok that's the whole page, you ate it, periodt 💅✨ this was shtool 2.0.8, dated 18-Jul-2008 — mwah, go make some directories bestie 🎀🦋