NAME

       cdist-type__apt_backports - Install backports

DESCRIPTION

       This  singleton  type  installs  backports  for  the  current OS release.  It aborts if backports are not
       supported for the specified OS or no version codename could be fetched (like Debian unstable).

       The package index will be automatically updated if required.

       It supports backports from following OSes:

       • Debian

       • Devuan

       • Ubuntu

REQUIRED PARAMETERS

       None.

OPTIONAL PARAMETERS

       state  Represents the state of the backports repository. present or absent, defaults to present.

              Will be directly passed to cdist-type__apt_source(7).

       mirror The mirror to fetch the backports from. Will defaults to the generic mirror of the current OS.

              Will be directly passed to cdist-type__apt_source(7).

BOOLEAN PARAMETERS

       None.

MESSAGES

       None.

EXAMPLES

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

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

ABORTS

       Aborts if the detected os is not Debian.

       Aborts if no distribuition codename could be detected. This is common for the unstable distribution,  but
       there is no backports repository for it already.

CAVEATS

       For  Ubuntu,  it  setup  all  componenents  for  the backports repository: main, restricted, universe and
       multiverse. The user may not want to install proprietary packages, which will only be  installed  if  the
       user explicitly uses the backports target-release. The user may change this behavior to install backports
       packages without the need of explicitly select it.

SEE ALSO

       Official Debian Backports site

       cdist-type__apt_source(7)

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.

COPYRIGHT

       ungleich GmbH 2021

7.0.0                                             Jun 16, 2024                      CDIST-TYPE__APT_BACKPORTS(7)