CDIST-TYPE__LINK(7)

📦
version 7.0.0 · 8 versions
, in fedora 43, fedora 44

okay so bestie, welcome to cdist-type__link(7) from the cdist manual fam (section 7, the cool section). this is the type that lets you manage hard and symbolic links, and the whole vibe is: the object id you hand it? that's the destination of the link. periodt. 🔗✨

✨ DESCRIPTION ✨

This cdist type lets you manage hard links and symbolic links, no cap. The given object id is the destination for the link. That's the whole assignment and it ate. 💅

🎀 REQUIRED PARAMETERS 🎀

like, you literally cannot skip these, they're not optional bestie:

  • source — specifies the link source. the origin story. the blueprint. 🦋
  • type — specifies the link type. and it's giving two options only: either hard or symbolic. pick your fighter. 🔥

🌸 OPTIONAL PARAMETERS 🌸

  • state — 'present' or 'absent', defaults to 'present'. lowkey the mood ring of the whole operation. ✨

💬 MESSAGES 💬

these are the lil receipts cdist hands you so you know what went down:

  • created <destination> — link to destination was created. new link just dropped, iconic. 🎀
  • removed <destination> — link to destination was removed. it's gone, we don't talk about it. 💀
  • removed <destination> (directory) — destination was removed because state is present and destination was a directory. plot twist, it wasn't even a link. 🙈
  • removed <destination> (wrongsource) — destination was removed because state is present and the destination link source was wrong. it was linking to the wrong person the whole time, embarrassing fr fr. 😭

🌈 EXAMPLES 🌈

copy these exactly bestie, no free-styling:

# Create hard link of /etc/shadow
__link /root/shadow --source /etc/shadow --type hard

# Relative symbolic link
__link /etc/apache2/sites-enabled/www.test.ch   \
   --source ../sites-available/www.test.ch      \
   --type symbolic

# Absolute symbolic link
__link /opt/plone --source /home/services/plone --type symbolic

# Remove link
__link /opt/plone --state absent

👑 AUTHORS 👑

Nico Schottelius <nico-cdist--@--schottelius.org> — the main character who wrote this. we stan. 🫶

📜 COPYING 📜

Copyright (C) 2011-2012 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.

this is the legal bit bestie, don't skim it — GPLv3-or-later, so share the love (and the source) accordingly. ⭐

ungleich GmbH 2021

that's the whole page, you're welcome. this was cdist-type__link(7) from cdist 7.0.0, dated Jul 31, 2022 — go forth and link things, bestie, and remember: the destination is always the object id. slay. 💖✨🎀🦋🌸💅

📦 where this page comes from