Skip to content

Autobuild3 Filters

Mingcong Bai edited this page Jan 1, 2017 · 4 revisions

File Filters/Manipulators

Autobuild3 comes with a series of file filters meant to aid packagers when handling certain packages.

Currently, Autobuild3 supports the following filters:

  • elf: filter for handling ELF files found in the packaging root $PKGDIR.
  • info_dir: filter to remove /usr/share/info/dir in the packaging root.
  • lib_archives: filter to remove all libtools archive files, or .la in the packaging root.
  • mancompress: filter for compressing man pages found in the packaging root.
  • perl: filter for removing perllocal.pod and .packlist files from the packaging root.

The following filter is now deprecated as a part of the Core 4 compatibility update:

- perl_local: filter to remove perllocal.pod file found in the packaging root.

These filters are enabled by default, and are always called when packaging. In the case of perl, it is not sensible to build Perl packages without this filter - as all CPAN packages contain perllocal.sh in the vendor/site directory, which will result in file conflict with >1 CPAN packages packaged and installed.

Behavior of some filters can be configured.

"elf" filter options

Here below is a list of options for the elf filter. Option variables should be appended to autobuild/defines or its respective architectural counterpart.

ABSTRIP= expects a binary value (0/1) that decides whether to strip the ELF files found in the packaging root (defaults to 1 or "on").

ABELFDEP= expects a binary value (0/1) that decides whether to automatically detect ELF dependencies using the package manager backend (experimental; defaults to 0 or "off").

NOSTATIC= expects a binary value (0/1) that decides whether to purge all static libraries from the packaging root (defaults to 1 or "on").

"lib_archives" filter options

Here below is a list of options for the lib_archives filter. Option variables should be appended to autobuild/defines or its respective architectural counterpart.

NOLIBTOOL= expects a binary value (0/1) that decides whether to purge all libtool archives or .la from the packaging root (defaults to 1 or "on").