NAME

       cdist-type__dpkg_architecture  -  Handles  foreign  architectures  on  debian-like systems
       managed by dpkg

DESCRIPTION

       This type handles foreign architectures on systems managed by dpkg(1). The  object  id  is
       the name of the architecture accepted by dpkg, which should be added or removed.

       If  the  architecture  is  not  setup  on  the system, it adds a new architecture as a new
       foreign architecture in dpkg. Then, it updates the apt package index to make packages from
       the new architecture available.

       If  the  architecture  should  be  removed,  it  will  remove  it  if  it  is not the base
       architecture on where the system was installed on. Before it, it will purge every  package
       based  on  the  "to  be  removed"  architecture  via apt to be able to remove the selected
       architecture.

REQUIRED PARAMETERS

       None.

OPTIONAL PARAMETERS

       state  present or absent. Defaults to present.

MESSAGES

       added  Added the specified architecture

       removed
              Removed the specified architecture

ABORTS

       Aborts in the following cases:

       If dpkg(1) is not available. It will abort with a proper error message.

       If the architecture is the same as the base architecture  the  system  is  build  upon  it
       (returned by dpkg --print-architecture) and it should be removed.

       It will fail if it can not execute apt(8). It is assumed that it is already installed.

EXAMPLES

          # add i386 (32 bit) architecture
          __dpkg_architecture i386

          # remove it again :)
          __dpkg_architecture i386 --state absent

SEE ALSO

       Multiarch on Debian systems

       How to setup multiarch on Debian

       dpkg(1) cdist-type__package_dpkg(7) cdist-type__package_apt(7)

       Useful commands:

          # base architecture installed on this system
          dpkg --print-architecture

          # extra architectures added
          dpkg --print-foreign-architectures

AUTHORS

       Matthias Stecher <matthiasstecher at gmx.de>

COPYING

       Copyright  (C)  2020  Matthias Stecher. You can redistribute it and/or modify it under the
       terms of the GNU General Public License as  ublished  by  the  Free  Software  Foundation,
       either version 3 of the License, or (at your option) any later version.

COPYRIGHT

       ungleich GmbH 2021