Lintian::Architecture

Section: Debian Package Checker (3)
Updated: 2019-04-04
Page Index

NAME

Lintian::Architecture -- Lintian API for handling architectures and wildcards

SYNOPSIS

 use Lintian::Architecture qw(:all);
 
 print "arch\n" if is_arch ('i386');
 print "wildcard\n" if is_arch_wildcard ('any');
 print "either arch or wc\n" if is_arch_or_wildcard ('linux-any');
 foreach my $arch (expand_arch_wildcard ('any')) {
     print "any expands to $arch\n";
 }

DESCRIPTION

Lintian API for checking and expanding architectures and architecture wildcards. The functions are backed by a data file, so it may be out of date (use private/refresh-archs to update it).

Generally all architecture names are in the format ``$os-$arch'' and wildcards are ``$os-any'' or ``any-$cpu'', though there are exceptions:

•: ``all'' is the ``architecture independent'' architecture.
Source: Policy X5.6.8 (v3.9.3)
•: ``any'' is a wildcard matching any architecture except ``all''.
Source: Policy X5.6.8 (v3.9.3)
•: All other cases of ``$arch'' are short for ``linux-$arch''
Source: Policy X11.1 (v3.9.3)

Note that the architecture and cpu name are not always identical (example architecture ``armhf'' has cpu name ``arm'').

FUNCTIONS

The following methods are exportable:

is_arch_wildcard ($wc)

Returns a truth value if $wc is a known architecture wildcard.

Note: 'any' is considered a wildcard and not an architecture.

is_arch ($arch)

Returns a truth value if $arch is (an alias of) a Debian machine architecture OR the special value ``all''. It returns a false value for architecture wildcards (including ``any'') and unknown architectures.

is_arch_or_wildcard ($arch)

Returns a truth value if $arch is either an architecture or an architecture wildcard.

Shorthand for:

 is_arch ($arch) || is_arch_wildcard ($arch)

expand_arch_wildcard ($wc)

Returns a list of architectures that this wildcard expands to. No order is guaranteed (even between calls). Returned values must not be modified.

Note: This list is based on the architectures in Lintian's data file. However, many of these are not supported or used in Debian or any of its derivatives.

The returned values matches the list generated by dpkg-architecture -L, so the returned list may use (e.g.) ``amd64'' for ``linux-amd64''.

wildcard_includes_arch ($wc, $arch)

Returns a truth value if $arch is included in the list of architectures that $wc expands to.

This is generally faster than

  grep { $_ eq $arch } expand_arch_wildcard ($wc)

It also properly handles cases like ``linux-amd64'' and ``amd64'' being aliases.