2021-02-21 19:59:57 +00:00
cdist-type__apt_pin(7)
======================
NAME
----
2021-07-05 13:28:05 +00:00
cdist-type__apt_pin - Manage apt pinning rules
2021-02-21 19:59:57 +00:00
DESCRIPTION
-----------
2021-07-05 13:28:05 +00:00
Adds/removes/edits rules to pin some packages to a specific distribution. Useful if using multiple debian repositories at the same time. (Useful, if one wants to use a few specific packages from backports or perhaps Debain testing... or even sid.)
2021-02-21 19:59:57 +00:00
REQUIRED PARAMETERS
-------------------
2021-06-11 14:05:33 +00:00
distribution
Specifies what distribution the package should be pinned to. Accepts both codenames (buster/bullseye/sid) and suite names (stable/testing/...).
2021-02-21 19:59:57 +00:00
OPTIONAL PARAMETERS
-------------------
2021-06-11 14:05:33 +00:00
package
2021-07-05 13:28:05 +00:00
Package name, glob or regular expression to match (multiple) packages. If not specified `__object_id`
2021-06-11 14:05:33 +00:00
priority
The priority value to assign to matching packages. Deafults to 500. (To match the default target distro's priority)
state
Will be passed to underlying `__file`
2021-02-21 19:59:57 +00:00
BOOLEAN PARAMETERS
------------------
None.
EXAMPLES
--------
.. code-block :: sh
2021-07-05 13:28:05 +00:00
# Add the bullseye repo to buster, but do not install any packages by default,
# only if explicitely asked for (-1 means "never" for apt)
2021-06-11 14:05:33 +00:00
__apt_pin bullseye-default \
--package "*" \
--distribution bullseye \
--priority -1
require="__apt_pin/bullseye-default" __apt_source bullseye \
--uri http://deb.debian.org/debian/ \
--distribution bullseye \
--component main
__apt_pin foo --package "foo foo-*" --distribution bullseye
2021-07-05 13:28:05 +00:00
__foo # Assuming, this installs the `foo`
2021-06-11 14:05:33 +00:00
2021-07-05 13:28:05 +00:00
__package foo-plugin-extras # Assuming we also need some extra stuff
2021-02-21 19:59:57 +00:00
SEE ALSO
--------
2021-07-05 13:28:05 +00:00
:strong: `apt_preferences` \ (5)
:strong: `cdist-type__apt_source` \ (7)
:strong: `cdist-type__apt_backports` \ (7)
2021-06-11 14:05:33 +00:00
:strong: `cdist-type__file` \ (7)
2021-02-21 19:59:57 +00:00
AUTHORS
-------
Daniel Fancsali <fancsali@gmail.com>
COPYING
-------
Copyright \(C) 2021 Daniel Fancsali. 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.
