.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__PACKAGE_PKGNG_FREEBSD" "7" "Dec 18, 2016" "4.4.1" "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_pkgng_freebsd \- Manage FreeBSD packages with pkg\-ng
.SH DESCRIPTION
.sp
This type is usually used on FreeBSD 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 flavor
If supplied, use to avoid ambiguity.
.TP
.B version
If supplied, use to install a specific version of the package named.
.TP
.B repo
If supplied, use to install the package named from a particular repo.
.TP
.B state
Either "present" or "absent", defaults to "present"
.UNINDENT
.SH BOOLEAN PARAMETERS
.INDENT 0.0
.TP
.B upgrade
If supplied, allow upgrading to the latest version of a package.
.UNINDENT
.SH CAVEATS
.sp
This type requires that repository definitions already exist in /etc/pkg/*.conf.
Ensure that they exist prior to use of this type with __file.
.sp
pkg\-ng can\(aqt upgrade a package to a specific version. If this type needs to
upgrade a package, it can only ugprade to the latest available version. If the
"upgrade" parameter is not given and an upgrade needs to occur, an error will result.
.SH MESSAGES
.INDENT 0.0
.TP
.B install
The package was installed
.TP
.B remove
The package was removed
.TP
.B upgrade
The package was upgraded
.TP
.B exist
The package was already present and thus not installed
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Ensure zsh is installed
__package_pkgng_freebsd zsh \-\-state present

# Ensure vim is installed, use flavor no_x11
__package_pkgng_freebsd vim \-\-state present \-\-flavor no_x11

# If you don\(aqt want to follow pythonX packages, but always use python
__package_pkgng_freebsd python \-\-state present \-\-name python2

# Install a package from a particular repository when multiples exist
__package_pkgng_freebsd bash \-\-state present \-\-repo myrepo

# Remove obsolete package
__package_pkgng_freebsd puppet \-\-state absent
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBcdist\-type__package\fP(7)
.SH AUTHORS
.sp
Jake Guffey <\fI\%jake.guffey\-\-@\-\-eprotex.com\fP>
.SH COPYING
.sp
Copyright (C) 2014 Jake Guffey. 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.
.\" Generated by docutils manpage writer.
.