File attributes¶

%__NAME_path PATH_RE
%__NAME_magic MAGIC_RE
%__NAME_mime MIME_RE

%__NAME_exclude_path PATH_RE
%__NAME_exclude_magic MAGIC_RE
%__NAME_exclude_mime MIME_RE

%__NAME_flags FLAG[,FLAG ...]
%__NAME_exclude_flags FLAG[,FLAG ...]

Generators¶

%__NAME_​TYPE COMMAND
%__NAME_​TYPE() BODY

%__NAME_protocol {singlefile|multifile}

Per-package tunables¶

%_local_file_attrs NAME[:NAME ...]
%__TYPE_exclude DEPSTRING_RE
%__TYPE_exclude_from PATH_RE
%__NAME_​TYPE_opts OPTS

Notes¶

TYPE can be one of conflicts, enhances, obsoletes, orderwithrequires, provides, recommends, requires, suggests and supplements. FLAG can be one of exeonly and magic_and_path.

Matching rules¶

%__NAME_path PATH_RE

%__NAME_magic MAGIC_RE

file -z -e tokens /some/file

%__NAME_mime MIME_RE

file --mime /some/file

%__NAME_exclude_path PATH_RE
%__NAME_exclude_magic MAGIC_RE
%__NAME_exclude_mime MIME_RE

Matching is inclusive unless changed by flags (see below): If the path, magic or both match, the file is said to have the attribute in question, unless there is a matching exclusion rule (also inclusive by default) or a flag that prevents the match. If both the magic and mime rules are defined, the magic rule is ignored and a warning is printed.

Tunables¶

%__NAME_flags FLAGS
%__NAME_exclude_flags FLAGS

Generator macros¶

%__NAME_conflicts COMMAND
%__NAME_enhances COMMAND
%__NAME_obsoletes COMMAND
%__NAME_orderwithrequires COMMAND (Added: 4.17.0)
%__NAME_provides COMMAND
%__NAME_recommends COMMAND
%__NAME_requires COMMAND
%__NAME_suggests COMMAND
%__NAME_supplements COMMAND

Protocols¶

%__NAME_protocol PROTOCOL

Unlike the PATH_RE in file attributes, generators receive filenames with the %{buildroot} prefix so that they can access the actual file contents on disk.

Generators must always consume all of standard input. For backwards compatibility, generators should not make any assumptions about the number of files passed, regardless of the protocol used.

Exported macros¶

In addition to globally defined macros, the following macros are automatically exported to generators, on a subpackage basis:

• %{name}
• %{epoch}
• %{version}
• %{release}

Added: 4.15.0

Parametric generators¶

If a generator is declared as a parametric macro, the macro itself is called for dependency generation, with the filename as its first argument (%1). The macro expansion itself is considered as the generated dependencies, one per line.

The following trivial example creates provides from path basenames, which is enormously faster than the equivalent traditional generator shelling out to execute a script that calls basename(1):

%__foo_provides()	%{basename:%{1}}

While RPM's own macro primitives are limited, using %{lua} enables the writing of complicated, macro-only generators.

See PARAMETRIC MACROS and Lua expansion in rpm-macros(7) for details.

Added: 4.16.0

External generators¶

%__find_​TYPE COMMAND

This is a legacy, deprecated interface that's only available for v4 packages for backwards compatibility, and should not be used. Packages built this way contain less data about their files, such as no "color" information (which is vital for RPM's functionality on multiarch systems), file type information or per-file dependency tracking.

To enable this interface regardless, define the macro:

%_use_internal_dependency_generator 0

Displaying debug information¶

The rpmbuild(1) and rpmdeps(1) tools have a hidden --rpmfcdebug switch that enables additional output for the dependency generation stage. The output format is currently roughly as follows:

<file number> <on-disk path> <color info> <file attribute matches>


    <list of dependencies associated with this file>

File attribute matches are the names of the rules that matched for the file, and that is where rule troubleshooting typically starts: a file with no attributes will not have any dependencies attached.

Global excludes¶

Global variants of the per-package exclusion macros may also be defined on the system:

%__global_​TYPE_exclude DEPSTRING_RE
%__global_​TYPE_exclude_from PATH_RE

These apply to all package builds and thus may affect the output of a particular generator in unexpected ways. Make sure to inspect the contents of these macros if that's the case.

Example 1. A trivial multifile generator¶

Suppose there's a %{_fileattrsdir}/frob.attr file with the following contents:

%__frob_provides %{_rpmconfigdir}/frobnize --provides
%__frob_requires %{_rpmconfigdir}/frobnize --requires
%__frob_protocol multifile
%__frob_path \.frob$
%__frob_magic ^.* a frob file .*$

This file defines a file attribute called frob that has two generators, both of which use a frobnize script that implements the multifile protocol. The file attribute matches all files with the .frob suffix as well as those that contain the "a frob file" magic string.

The %{_rpmconfigdir}/frobnize script has the following contents:

#!/bin/bash
# Frob dependency extractor
# Type of dependency strings to print
mode=$1
# Process every file on standard input
while read -r file; do


    # Print currently processed file as per multifile protocol


    echo ";$file"


    # Get basename and first line


    name=$(basename $file | cut -f1 -d.)


    line=$(head -n1 $file)


    # Print dependency strings


    case $mode in


       --provides)


           echo "frob($name)"


           echo "frob($line)"


           ;;


       --requires)


           echo "bard($name)"


           echo "bard($line)"


           ;;


    esac
done

Now, suppose there's a frob.spec file that installs the file hello.frob with the contents "world" to some location on the filesystem. When the spec is built, the resulting package will have the following provides and requires:

$ rpmbuild -bb /path/to/frob.spec
...
$ rpm -qp --provides --requires /path/to/frob.rpm
...
frob(hello)
frob(world)
bard(hello)
bard(world)
...

If multiple files with the .frob suffix or "a frob file" magic were present in the package, the frobnize script would only be executed once, with all the matching filenames passed at once.

Note that if the generator decided to break from the while loop, it would have to discard any remaining input prior to exiting, as per protocol, which could be done with the following command placed after the loop:

cat > /dev/null

Example 2. Spec-local generators¶

This spec file snippet introduces two spec-local file attributes, frob and bard, that match any and all files, and their generators that use a frobnize and bardize.sh script shipped by the package itself and only included with the sources, respectively:

...
Source1: bardize.sh
...
%define _local_file_attrs frob:bard
%define __frob_provides %{buildroot}/%{_rpmconfigdir}/frobnize
%define __frob_path .*
%define __bard_provides %{SOURCE1}
%define __bard_path .*
...

Example 3. Bundled file attributes and generators¶

%{_fileattrsdir}/*.attr
%{_rpmconfigdir}/*.req
%{_rpmconfigdir}/*.prov