/usr/share/doc/lintian/api.html/Lintian/Architecture.html is in lintian 2.5.30+deb8u4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><title>Lintian::Architecture</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" title="blkbluw" type="text/css" href="../_blkbluw.css" media="all" >
<link rel="alternate stylesheet" title="blkmagw" type="text/css" href="../_blkmagw.css" media="all" >
<link rel="alternate stylesheet" title="blkcynw" type="text/css" href="../_blkcynw.css" media="all" >
<link rel="alternate stylesheet" title="whtprpk" type="text/css" href="../_whtprpk.css" media="all" >
<link rel="alternate stylesheet" title="whtnavk" type="text/css" href="../_whtnavk.css" media="all" >
<link rel="alternate stylesheet" title="grygrnk" type="text/css" href="../_grygrnk.css" media="all" >
<link rel="alternate stylesheet" title="whtgrng" type="text/css" href="../_whtgrng.css" media="all" >
<link rel="alternate stylesheet" title="blkgrng" type="text/css" href="../_blkgrng.css" media="all" >
<link rel="alternate stylesheet" title="grygrnw" type="text/css" href="../_grygrnw.css" media="all" >
<link rel="alternate stylesheet" title="blkbluw" type="text/css" href="../_blkbluw.css" media="all" >
<link rel="alternate stylesheet" title="whtpurk" type="text/css" href="../_whtpurk.css" media="all" >
<link rel="alternate stylesheet" title="whtgrng" type="text/css" href="../_whtgrng.css" media="all" >
<link rel="alternate stylesheet" title="grygrnw" type="text/css" href="../_grygrnw.css" media="all" >
<script type="text/javascript" src="../_podly.js"></script>
</head>
<body class='pod'>
<!--
generated by Pod::Simple::HTML v3.28,
using Pod::Simple::PullParser v3.28,
under Perl v5.020002 at Thu Apr 9 20:14:46 2015 GMT.
If you want to change this HTML document, you probably shouldn't do that
by changing it directly. Instead, see about changing the calling options
to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
then reconverting this document from the Pod source.
When in doubt, email the author of Pod::Simple::HTML for advice.
See 'perldoc Pod::Simple::HTML' for more info.
-->
<!-- start doc -->
<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents"><<</a></b></p>
<div class='indexgroup'>
<ul class='indexList indexList1'>
<li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
<li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
<li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
<li class='indexItem indexItem1'><a href='#FUNCTIONS'>FUNCTIONS</a>
</ul>
</div>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>
<p>Lintian::Architecture -- Lintian API for handling architectures and wildcards</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>
<pre> 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";
}</pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p>Lintian API for checking and expanding architectures and architecture wildcards. The functions are backed by a <a href="../Lintian/Data.html" class="podlinkpod"
>data</a> file, so it may be out of date (use private/refresh-archs to update it).</p>
<p>Generally all architecture names are in the format "$os-$arch" and wildcards are "$os-any" or "any-$cpu", though there are exceptions:</p>
<ul>
<li>"all" is the "architecture independent" architecture.
<p>Source: Policy §5.6.8 (v3.9.3)</p>
</li>
<li>"any" is a wildcard matching any architecture except "all".
<p>Source: Policy §5.6.8 (v3.9.3)</p>
</li>
<li>All other cases of "$arch" are short for "linux-$arch"
<p>Source: Policy §11.1 (v3.9.3)</p>
</li>
</ul>
<p>Note that the architecture and cpu name are not always identical (example architecture "armhf" has cpu name "arm").</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="FUNCTIONS"
>FUNCTIONS</a></h1>
<p>The following methods are exportable:</p>
<dl>
<dt><a name="is_arch_wildcard_($wc)"
>is_arch_wildcard ($wc)</a></dt>
<dd>
<p>Returns a truth value if $wc is a known architecture wildcard.</p>
<p>Note: 'any' is considered a wildcard and not an architecture.</p>
<dt><a name="is_arch_($arch)"
>is_arch ($arch)</a></dt>
<dd>
<p>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.</p>
<dt><a name="is_arch_or_wildcard_($arch)"
>is_arch_or_wildcard ($arch)</a></dt>
<dd>
<p>Returns a truth value if $arch is either an architecture or an architecture wildcard.</p>
<p>Shorthand for:</p>
<pre> is_arch ($arch) || is_arch_wildcard ($arch)</pre>
<dt><a name="expand_arch_wildcard_($wc)"
>expand_arch_wildcard ($wc)</a></dt>
<dd>
<p>Returns a list of architectures that this wildcard expands to. No order is guaranteed (even between calls). Returned values must not be modified.</p>
<p>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.</p>
<p>The returned values matches the list generated by dpkg-architecture -L, so the returned list may use (e.g.) "amd64" for "linux-amd64".</p>
<dt><a name="wildcard_includes_arch_($wc,_$arch)"
>wildcard_includes_arch ($wc, $arch)</a></dt>
<dd>
<p>Returns a truth value if $arch is included in the list of architectures that $wc expands to.</p>
<p>This is generally faster than</p>
<pre> grep { $_ eq $arch } expand_arch_wildcard ($wc)</pre>
<p>It also properly handles cases like "linux-amd64" and "amd64" being aliases.</p>
</dd>
</dl>
<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents"><<</a></b></p>
<!-- end doc -->
</body></html>
|