.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__PACKAGE_APT" "7" "Jun 23, 2019" "5.1.2" "cdist"
.
.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
..
.SH NAME
.sp
cdist\-type__package_apt \- Manage packages with apt\-get
.SH DESCRIPTION
.sp
apt\-get is usually used on Debian and variants (like Ubuntu) to
manage packages.
.SH REQUIRED PARAMETERS
.sp
None
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B name
If supplied, use the name and not the object id as the package name.
.TP
.B state
Either "present" or "absent", defaults to "present"
.TP
.B target\-release
Passed on to apt\-get install, see apt\-get(8).
Essentially allows you to retrieve packages from a different release
.TP
.B version
The version of the package to install. Default is to install the version
chosen by the local package manager.
.UNINDENT
.SH BOOLEAN PARAMETERS
.INDENT 0.0
.TP
.B purge\-if\-absent
If this parameter is given when state is \fIabsent\fP, the package is
purged from the system (using \fI\-\-purge\fP).
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Ensure zsh in installed
__package_apt zsh \-\-state present

# In case you only want *a* webserver, but don\(aqt care which one
__package_apt webserver \-\-state present \-\-name nginx

# Remove obsolete package
__package_apt puppet \-\-state absent
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBcdist\-type__package\fP(7)
.SH AUTHORS
.sp
Nico Schottelius <\fI\%nico\-cdist\-\-@\-\-schottelius.org\fP>
.SH COPYING
.sp
Copyright (C) 2011\-2012 Nico Schottelius. 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 2019
.\" Generated by docutils manpage writer.
.