1CDIST-TYPE__APT_BACKPORTS(7)         cdist        CDIST-TYPE__APT_BACKPORTS(7)
2
3
4

NAME

6       cdist-type__apt_backports - Install backports
7

DESCRIPTION

9       This  singleton type installs backports for the current OS release.  It
10       aborts if backports are not supported for the specified OS or  no  ver‐
11       sion codename could be fetched (like Debian unstable).
12
13       The package index will be automatically updated if required.
14
15       It supports backports from following OSes:
16
17       • Debian
18
19       • Devuan
20
21       • Ubuntu
22

REQUIRED PARAMETERS

24       None.
25

OPTIONAL PARAMETERS

27       state  Represents the state of the backports repository. present or ab‐
28              sent, defaults to present.
29
30              Will be directly passed to cdist-type__apt_source(7).
31
32       mirror The mirror to fetch the backports from.  Will  defaults  to  the
33              generic mirror of the current OS.
34
35              Will be directly passed to cdist-type__apt_source(7).
36

BOOLEAN PARAMETERS

38       None.
39

MESSAGES

41       None.
42

EXAMPLES

44          # setup the backports
45          __apt_backports
46          __apt_backports --state absent
47          __apt_backports --state present --mirror "http://ftp.de.debian.org/debian/"
48
49          # install a backports package
50          # currently for the buster release backports
51          require="__apt_backports" __package_apt wireguard \
52               --target-release buster-backports
53

ABORTS

55       Aborts if the detected os is not Debian.
56
57       Aborts  if  no distribuition codename could be detected. This is common
58       for the unstable distribution, but there is no backports repository for
59       it already.
60

CAVEATS

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

SEE ALSO

70       Official Debian Backports site
71
72       cdist-type__apt_source(7)
73

AUTHORS

75       Matthias Stecher <matthiasstecher at gmx.de>
76

COPYING

78       Copyright (C) 2020 Matthias Stecher. You  can  redistribute  it  and/or
79       modify  it  under  the  terms of the GNU General Public License as pub‐
80       lished by the Free Software Foundation, either version  3  of  the  Li‐
81       cense, or (at your option) any later version.
82
84       ungleich GmbH 2021
85
86
87
88
897.0.0                            Jul 31, 2022     CDIST-TYPE__APT_BACKPORTS(7)
Impressum