CDIST-TYPE__HOSTS(7)

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

✨ cdist-type__hosts(7) ✨

okay bestie, welcome to cdist-type__hosts from the cdist manual — this is the page that teaches you how to boss around your /etc/hosts file 💖

🌸 NAME 🌸

cdist-type__hosts — manage entries in /etc/hosts 🫶

🦋 DESCRIPTION 🦋

so basically: this type adds or removes entries from your /etc/hosts file. that's it, that's the whole vibe. no cap. 💅

✨ OPTIONAL PARAMETERS ✨

yes bestie, they're all optional — but read the fine print because state and ip are lowkey in a situationship 👀

  • state — if state is present, then object_id will resolve to ip. if state is absent, then object_id will no longer resolve via /etc/hosts, if it was previously configured with this type. and listen — entries you inserted manually are unaffected. this type minds its own business. 🙈
  • ip — the IP address that the hostname (= object_id) must resolve to. if state is present, this parameter is mandatory (fr fr, you need it). if state is absent, this parameter is silently ignored — like, it just doesn't get read, no warning, no drama. 💀
  • alias — an alias for the hostname. you can specify this parameter multiple times, once per alias. stack 'em up, queen. 👑

🎀 EXAMPLES 🎀

here's the tea, served in a code block ☕

# Now `funny' resolves to 192.168.1.76,
__hosts funny --ip 192.168.1.76
# and `happy' no longer resolve via /etc/hosts if it was
# previously configured via __hosts.
__hosts happy --state absent

__hosts srv1.example.com --ip 192.168.0.42 --alias srv1

see how funny gets a whole IP glow-up, happy gets ghosted, and srv1.example.com gets a cute little srv1 nickname? iconic behaviour, honestly. ⭐

🌈 SEE ALSO 🌈

  • hosts(5) — go read the source material bestie, iykyk 📖

💜 AUTHORS 💜

these legends wrote this:

  • Dmitry Bogatov <KAction@gnu.org>
  • Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>

🍓 COPYING 🍓

Copyright (C) 2015-2016 Dmitry Bogatov, 2019 Dennis Camera. 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. 🫶

ungleich GmbH 2021

⚠️ gentle reminder bestie: state absent only undoes stuff that this type configured. anything you hand-typed into /etc/hosts stays exactly where it is. don't come for me if you forgot you edited it yourself 💅

and that's the whole page, no notes. this was cdist 7.0.0, dated Jul 31, 2022 — periodt, go configure some hostnames, you got this 💖✨🎀🦋🌸

📦 where this page comes from