CDIST-TYPE__PACKAGE_PKGNG_FREEBSD(7)

💖 cdist-type__package_pkgng_freebsd(7) 💖

okay bestie, so this is a page from the cdist manual — yes, the actual manual, section 7 — and it's all about the __package_pkgng_freebsd type. let's get into it 🫶

---

✨ NAME ✨

cdist-type__package_pkgng_freebsd — manage FreeBSD packages with pkg-ng, periodt 💅

---

🌸 DESCRIPTION 🌸

so like, this type is usually used on FreeBSD to manage packages. that's literally its whole thing. it's giving package manager but make it cdist. 👑

---

🎀 REQUIRED PARAMETERS 🎀

None. not a single one, she's low maintenance. 💖

---

⭐ OPTIONAL PARAMETERS ⭐

• name — if you supply it, she uses that as the package name instead of the object id. handy when they don't match, iykyk.
• flavor — if you supply it, it's used to avoid ambiguity. like when two packages are fighting over the same name and you gotta pick a side. 🦋
• version — if you supply it, she installs that specific version of the package you named. precision, bestie. ✨
• repo — if you supply it, she installs the package you named from that particular repo. very "I know a guy" energy. 💅
• state — either "present" or "absent", and it defaults to "present". simple as that. 🌈

---

👑 BOOLEAN PARAMETERS 👑

• upgrade — if supplied, it allows upgrading to the latest version of a package. no cap. 🔥

---

💀 CAVEATS 💀

okay listen, this is the part where you actually pay attention, bestie:

• This type requires that repository definitions already exist in /etc/pkg/*.conf. Make sure they're there before you use this type — do it with __file. no repos, no vibes, no packages. 😭
• pkg-ng can't upgrade a package to a specific version. So if this type needs to upgrade a package, it can only upgrade to the latest available version, periodt. And if the upgrade parameter is not given and an upgrade needs to occur — an error will result. that's not a drill, that's a whole error. 💀

---

💌 MESSAGES 💌

here's the group chat of things this type might tell you:

• install — The package was installed 🎉
• remove — The package was removed
• upgrade — The package was upgraded ⬆️
• exist — The package was already present and thus not installed. she's already here, bestie, she ate and left no crumbs. 💅

---

🌟 EXAMPLES 🌟

# Ensure zsh is installed
__package_pkgng_freebsd zsh --state present

# Ensure vim is installed, use flavor no_x11
__package_pkgng_freebsd vim --state present --flavor no_x11

# If you don't want to follow pythonX packages, but always use python
__package_pkgng_freebsd python --state present --name python2

# Install a package from a particular repository when multiples exist
__package_pkgng_freebsd bash --state present --repo myrepo

# Remove obsolete package
__package_pkgng_freebsd puppet --state absent

look at her go. iconic. 🌸

---

🦋 SEE ALSO 🦋

• cdist-type__package(7)

---

💜 AUTHORS 💜

• Jake Guffey <jake.guffey--@--eprotex.com>

---

🍓 COPYING 🍓

Copyright (C) 2014 Jake Guffey. 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

---

and that's the whole page, bestie!! this one's from the cdist manual, version 7.0.0, dated Jul 31 — shoutout to the docs, they ate. stay slaying, and always read your CAVEATS before you deploy 💅✨