CDIST-TYPE__APT_BACKPORTS(7)

✨ cdist-type__apt_backports ✨

okay bestie, welcome to cdist-type__apt_backports β€” the cdist manual page that gets your OS those shiny newer packages πŸŽ€


πŸ’– NAME πŸ’–

cdist-type__apt_backports β€” install backports, no cap πŸ’…


🌸 DESCRIPTION 🌸

So this is a singleton type, which means it installs backports for the current OS release. That's it, that's the job 🫢

It will abort if backports aren't supported for the OS you specified, or if it couldn't fetch a version codename at all (think Debian unstable, it's giving chaos 😭).

The package index gets automatically updated if that's required. Lowkey handy, highkey convenient ✨

It supports backports from these OSes, periodt:

  • Debian
  • Devuan
  • Ubuntu

πŸ¦‹ REQUIRED PARAMETERS πŸ¦‹

None. Not a single one. You're free, you're unbothered, you're iconic πŸ‘‘


✨ OPTIONAL PARAMETERS ✨

  • state β€” this is the state of the backports repository. It's either present or absent, and it defaults to present. This value gets passed directly to cdist-type__apt_source(7), so it's not doing anything sneaky behind the scenes πŸ’œ
  • mirror β€” the mirror you want to fetch the backports from. It defaults to the generic mirror of the current OS. This one also gets passed directly to cdist-type__apt_source(7). Slay 🌈

πŸŽ€ BOOLEAN PARAMETERS πŸŽ€

None. Zero. Nada. The vibes are simple here πŸ™ˆ


πŸ’Œ MESSAGES πŸ’Œ

None either. It's a quiet queen, she doesn't text back πŸ’€


πŸ”₯ EXAMPLES πŸ”₯

Setting up the backports, three ways, pick your fighter:

# setup the backports
__apt_backports
__apt_backports --state absent
__apt_backports --state present --mirror "http://ftp.de.debian.org/debian/"

And then installing an actual backports package β€” this example is currently for the buster release backports:

# install a backports package
# currently for the buster release backports
require="__apt_backports" __package_apt wireguard \
     --target-release buster-backports

Look at that require= doing the most. Obsessed πŸ˜­πŸ’–


😭 ABORTS 😭

  • It aborts if the detected os is not Debian.
  • It aborts if no distribuition codename could be detected. This is common for the unstable distribution, but there is no backports repository for it already. (Yes, "distribuition" β€” we keep the lore exactly as it is, bestie 🫢)

πŸ’€ CAVEATS πŸ’€

For Ubuntu, this type sets up all components for the backports repository: main, restricted, universe and multiverse. The thing is, the user may not want to install proprietary packages β€” and those will only get installed if the user explicitly uses the backports target-release. The user may change this behavior to install backports packages without needing to explicitly select it. Read that twice, it matters, fr fr πŸ’…


🌈 SEE ALSO 🌈


πŸ‘‘ AUTHORS πŸ‘‘

Matthias Stecher <matthiasstecher at gmx.de>


πŸ“ COPYING πŸ“

Copyright (C) 2020 Matthias Stecher. 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


and that's the whole page, bestie πŸ’–βœ¨ version 7.0.0, dated Jul 31, 2022, straight from the cdist-type__apt_backports(7) archives β€” go forth and backport responsibly πŸŽ€πŸ¦‹πŸŒΈ

πŸ“¦ where this page comes from