Alien-Build
view release on metacpan or search on metacpan
Regular expression for the files that should be copied from the
DESTDIR into the stage directory. If not defined, then all files will
be copied.
destdir_ffi_filter
Same as destdir_filter except applies to build_ffi instead of build.
digest
This properties contains the cryptographic digests (if any) that
should be used when verifying any fetched and downloaded files. It is
a hash reference where the key is the filename and the value is an
array reference containing a pair of values, the first being the
algorithm ('SHA256' is recommended) and the second is the actual
digest. The special filename * may be specified to indicate that any
downloaded file should match that digest. If there are both real
filenames and the * placeholder, the real filenames will be used for
filenames that match and any other files will use the placeholder.
Example:
$build->meta_prop->{digest} = {
'foo-1.00.tar.gz' => [ SHA256 => '9feac593aa49a44eb837de52513a57736457f1ea70078346c60f0bfc5f24f2c1' ],
'foo-1.01.tar.gz' => [ SHA256 => '6bbde6a7f10ae5924cf74afc26ff5b7bc4b4f9dfd85c6b534c51bd254697b9e7' ],
'*' => [ SHA256 => '33a20aae3df6ecfbe812b48082926d55391be4a57d858d35753ab1334b9fddb3' ],
};
Cryptographic signatures will only be checked if the check_digest
meta property is set and if the Digest negotiator plugin is loaded.
(The Digest negotiator can be used directly, but is also loaded
automatically if you use the digest directive is used by the
alienfile).
env
Environment variables to override during the build stage.
env_interpolate
Environment variable values will be interpolated with helpers.
Example:
meta->prop->{env_interpolate} = 1;
meta->prop->{env}->{PERL} = '%{perl}';
local_source
Set to true if source code package is available locally. (that is not
fetched over the internet). This is computed by default based on the
start_url property. Can be set by an alienfile or plugin.
platform
Hash reference. Contains information about the platform beyond just
$^O.
platform.compiler_type
Refers to the type of flags that the compiler accepts. May be
expanded in the future, but for now, will be one of:
microsoft
On Windows when using Microsoft Visual C++
unix
Virtually everything else, including gcc on windows.
The main difference is that with Visual C++ -LIBPATH should be used
instead of -L, and static libraries should have the .LIB suffix
instead of .a.
platform.system_type
$^O is frequently good enough to make platform specific logic in
your alienfile, this handles the case when $^O can cover platforms
that provide multiple environments that Perl might run under. The
main example is windows, but others may be added in the future.
unix
vms
windows-activestate
windows-microsoft
windows-mingw
windows-strawberry
windows-unknown
Note that cygwin and msys are considered unix even though they run
on windows!
platform.cpu.count
Contains a non-negative integer of available (possibly virtual)
CPUs on the system. This can be used by build plugins to build in
parallel. The environment variable ALIEN_CPU_COUNT can be set to
override the CPU count.
platform.cpu.arch.name
Contains a normalized name for the architecture of the current
Perl. This can be used by fetch plugins to determine which binary
packages to download. The value may be one of the following, but
this list will be expanded as needed.
armel
32-bit ARM soft-float
armhf
32-bit ARM hard-float
aarch64
64-bit ARM
ppc
32-bit PowerPC (big-endian)
ppc64
64-bit PowerPC (big-endian)
x86
32-bit Intel (i386, i486, i686)
x86_64
64-bit Intel (AMD64)
unknown
Unable to detect architecture. Please report this if needed.
out_of_source
Build in a different directory from the where the source code is
stored. In autoconf this is referred to as a "VPATH" build. Everyone
else calls this an "out-of-source" build. When this property is true,
instead of extracting to the source build root, the downloaded source
will be extracted to an source extraction directory and the source
build root will be empty. You can use the extract install property to
get the location of the extracted source.
network
True if a network fetch is available. This should NOT be set by an
alienfile or plugin. This is computed based on the
ALIEN_INSTALL_NETWORK environment variables.
start_url
The default or start URL used by fetch plugins.
install_prop
my $href = $build->install_prop;
Install properties are used during the install phase (either under
share or system install). They are remembered for the entire install
phase, but not kept around during the runtime phase. Thus they cannot
( run in 0.508 second using v1.01-cache-2.11-cpan-5b529ec07f3 )