diff options
| author | Luca Boccassi <bluca@debian.org> | 2022-05-25 14:41:47 +0100 |
|---|---|---|
| committer | Alan Modra <amodra@gmail.com> | 2022-05-26 12:56:12 +0930 |
| commit | 9e2bb0cb5e74aed4158f08495534922d7108f928 (patch) | |
| tree | ed3ed33aef50a4bd5e0f16d3072340a81d0d0b4f /ld/ld.texi | |
| parent | d1a24139adfb2f029c9d52a9c43da44a617f90a4 (diff) | |
| download | binutils-gdb-9e2bb0cb5e74aed4158f08495534922d7108f928.tar.gz | |
ld: add --package-metadata
Generate a .note.package FDO package metadata ELF note, following
the spec: https://systemd.io/ELF_PACKAGE_METADATA/
If the jansson library is available at build time (and it is explicitly
enabled), link ld to it, and use it to validate that the input is
correct JSON, to avoid writing garbage to the file. The
configure option --enable-jansson has to be used to explicitly enable
it (error out when not found). This allows bootstrappers (or others who
are not interested) to seamlessly skip it without issues.
Diffstat (limited to 'ld/ld.texi')
| -rw-r--r-- | ld/ld.texi | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/ld/ld.texi b/ld/ld.texi index a2b162ce5b5..eabbec8faa9 100644 --- a/ld/ld.texi +++ b/ld/ld.texi @@ -2935,6 +2935,18 @@ string identifying the original linked file does not change. Passing @code{none} for @var{style} disables the setting from any @code{--build-id} options earlier on the command line. + +@kindex --package-metadata=@var{JSON} +@item --package-metadata=@var{JSON} +Request the creation of a @code{.note.package} ELF note section. The +contents of the note are in JSON format, as per the package metadata +specification. For more information see: +https://systemd.io/ELF_PACKAGE_METADATA/ +If the JSON argument is missing/empty then this will disable the +creation of the metadata note, if one had been enabled by an earlier +occurrence of the --package-metdata option. +If the linker has been built with libjansson, then the JSON string +will be validated. @end table @c man end |