.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CDIST-TYPE__APT_PIN" "7" "Sep 26, 2023" "7.0.0" "cdist"
.SH NAME
.sp
cdist\-type__apt_pin \- Manage apt pinning rules
.SH DESCRIPTION
.sp
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.)
.SH REQUIRED PARAMETERS
.INDENT 0.0
.TP
.B distribution
Specifies what distribution the package should be pinned to. Accepts both codenames (buster/bullseye/sid) and suite names (stable/testing/...).
.UNINDENT
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B package
Package name, glob or regular expression to match (multiple) packages. If not specified \fI__object_id\fP is used.
.TP
.B priority
The priority value to assign to matching packages. Deafults to 500. (To match the default target distro\(aqs priority)
.TP
.B state
Will be passed to underlying \fI__file\fP type; see there for valid values and defaults.
.UNINDENT
.SH BOOLEAN PARAMETERS
.sp
None.
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Add the bullseye repo to buster, but do not install any packages by default,
# only if explicitely asked for (\-1 means \(dqnever\(dq for apt)
 __apt_pin bullseye\-default \e
    \-\-package \(dq*\(dq \e
    \-\-distribution bullseye \e
    \-\-priority \-1

 require=\(dq__apt_pin/bullseye\-default\(dq __apt_source bullseye \e
    \-\-uri http://deb.debian.org/debian/ \e
    \-\-distribution bullseye \e
    \-\-component main

 __apt_pin foo \-\-package \(dqfoo foo\-*\(dq \-\-distribution bullseye

 __foo # Assuming, this installs the \(gafoo\(ga package internally

 __package foo\-plugin\-extras # Assuming we also need some extra stuff
.EE
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBapt_preferences\fP(5)
\fBcdist\-type__apt_source\fP(7)
\fBcdist\-type__apt_backports\fP(7)
\fBcdist\-type__file\fP(7)
.SH AUTHORS
.sp
Daniel Fancsali <\fI\%fancsali@gmail.com\fP>
.SH COPYING
.sp
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.
.SH COPYRIGHT
ungleich GmbH 2021
.\" Generated by docutils manpage writer.
.