CDIST-TYPE__INSTALL_DIRECTORY(7)

🎀 cdist-type__install_directory — the manual page, bestie edition ✨

ok so you're reading cdist-type__install_directory(7) from the cdist manuals and honestly? you picked a good one. this lil type is the one that makes directories appear (or disappear) on your target machine using the install command. iconic behaviour, no cap.

---

✨ NAME ✨

cdist-type__install_directory — Manage a directory with install command 🗂️

---

💖 DESCRIPTION 💖

okay so here's the tea: this cdist type lets you create or remove directories on the target. that's it, that's the whole vibe. it's giving directory management, and it's giving it well. 🫶

---

🌸 REQUIRED PARAMETERS 🌸

None. literally nothing, she's low maintenance 💅

---

🦋 OPTIONAL PARAMETERS 🦋

• state — 'present' or 'absent', defaults to 'present'. so like, do you want the dir or not bestie 😌
• group — Group to chgrp to.
• mode — Unix permissions, suitable for chmod.
• owner — User to chown to.

---

⭐ BOOLEAN PARAMETERS ⭐

• parents — Whether to create parents as well (mkdir -p behaviour). Warning: all intermediate directory permissions default to whatever mkdir -p does.

Usually this means root:root, 0700. so like… heads up, the in-between dirs are gonna be locked down and you didn't even get a say 🙈

• recursive — If supplied the chgrp and chown call will run recursively. This does not influence the behaviour of chmod. read that again bestie, chmod is not invited to the recursion party 😭

---

💌 MESSAGES 💌

these are the lil receipts she leaves you when things happen ✨

• chgrp <group> — Changed group membership
• chown <owner> — Changed owner
• chmod <mode> — Changed mode
• create — Empty directory was created
• remove — Directory exists, but state is absent, directory will be removed by generated code.
• remove non directory — Something other than a directory with the same name exists and was removed prior to create.

---

🌈 EXAMPLES 🌈

no because these examples ate, look at her go 👑

# A silly example
__install_directory /tmp/foobar

# Remove a directory
__install_directory /tmp/foobar --state absent

# Ensure /etc exists correctly
__install_directory /etc --owner root --group root --mode 0755

# Create nfs service directory, including parents
__install_directory /home/services/nfs --parents

# Change permissions recursively
__install_directory /home/services --recursive --owner root --group root

# Setup a temp directory
__install_directory /local --mode 1777

# Take it all
__install_directory /home/services/kvm --recursive --parents \
    --owner root --group root --mode 0755 --state present

---

👑 AUTHORS 👑

Nico Schottelius <nico-cdist--@--schottelius.org> — shoutout to the legend, fr fr 💜

---

🍓 COPYING 🍓

Copyright (C) 2011 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

---

🧚 COPYRIGHT 🧚

ungleich GmbH 2021

---

okay that's the whole page, you're officially certified 📜✨ this was cdist version 7.0.0, dated Jul 31, 2022 — go forth and make your directories, bestie, you got this 💖🎀🦋