NAME

       cdist-type__package_dpkg - Manage packages with dpkg

DESCRIPTION

       This  type  is used on Debian and variants (like Ubuntu) to install packages that are provided locally as
       *.deb files.

       The object given to this type must be the name of the deb package.  The filename of the deb  package  has
       to   follow   Debian  naming  conventions,  i.e.   ${binary:Package}_${Version}_${Architecture}.deb  (see
       dpkg-query(1) for details).

OPTIONAL PARAMETERS

       state  present or absent, defaults to present.

REQUIRED PARAMETERS

       source path to the *.deb package

BOOLEAN PARAMETERS

       purge-if-absent
              If this parameter is given when state is absent, the package is  purged  from  the  system  (using
              --purge).

EXPLORER

       pkg_state
              Returns the full package name if package is installed, empty otherwise.

MESSAGES

       installed
              The deb-file was installed.

       removed (--remove)
              The package was removed, keeping config.

       removed (--purge)
              The package was removed including config (purged).

EXAMPLES

          # Install foo and bar packages
          __package_dpkg foo_0.1_all.deb --source /tmp/foo_0.1_all.deb
          __package_dpkg bar_1.4.deb --source $__type/files/bar_1.4.deb

          # uninstall baz:
          __package_dpkg baz_1.4_amd64.deb \
              --source $__type/files/baz_1.4_amd64.deb \
              --state "absent"
          # uninstall baz and also purge config-files:
          __package_dpkg baz_1.4_amd64.deb \
              --source $__type/files/baz_1.4_amd64.deb \
              --purge-if-absent \
              --state "absent"

SEE ALSO

       cdist-type__package(7), dpkg-query(1)

AUTHORS

       Tomas Pospisek <tpo_deb--@--sourcepole.ch>
       Thomas Eckert <tom--@--it-eckert.de>

COPYING

       Copyright  (C)  2013  Tomas Pospisek. 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.  This type is based on __package_apt.

COPYRIGHT

       ungleich GmbH 2021