Ryan Brue 02587b5676 flatpak-metadata: Note host-root symlink pitfalls ...

Following symlinks from /run/host/root naively (for example, with
realpath()) is wrong.

This commit warns about this problem, and provides examples of how to
avoid it when using the host-root permission, either by using
https://man7.org/linux/man-pages/man2/openat2.2.html for modern kernels,
or 65adfdd5fc/steam-runtime-tools/resolve-in-sysroot.c
for older kernels.

Signed-off-by: Ryan Brue <ryanbrue.dev@gmail.com>

2025-09-24 17:19:21 +00:00

..

reference

image-source: Refactor - add FlatpakImageSource type

2025-08-25 15:56:20 +00:00

docbook.css

Build html documentation from the man pages

2016-07-12 00:41:13 -04:00

flatpak-build-bundle.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-build-commit-from.xml

Add docs for --subset=SUBSET

2020-11-13 10:32:19 +01:00

flatpak-build-export.xml

Add docs for --subset=SUBSET

2020-11-13 10:32:19 +01:00

flatpak-build-finish.xml

exports: add host-root

2025-09-24 17:19:21 +00:00

flatpak-build-import-bundle.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-build-init.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-build-sign.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-build-update-repo.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-build.xml

exports: add host-root

2025-09-24 17:19:21 +00:00

flatpak-config.xml

doc: Correct special value for flatpak config

2024-07-09 20:48:07 +01:00

flatpak-create-usb.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-docs.xml.in

Add initial support for preinstalling flatpaks

2025-08-26 11:51:07 +00:00

flatpak-document-export.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-document-info.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-document-unexport.xml

document-unexport: Finish implementing --doc-id

2022-01-10 09:40:40 +01:00

flatpak-documents.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-enter.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-history.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-info.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-install.xml

image-source: Support oci-archive: image sources

2025-08-25 15:56:20 +00:00

flatpak-installation.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-kill.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-list.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-make-current.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-mask.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-metadata.xml

flatpak-metadata: Note host-root symlink pitfalls

2025-09-24 17:19:21 +00:00

flatpak-override.xml

exports: add host-root

2025-09-24 17:19:21 +00:00

flatpak-permission-remove.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-permission-reset.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-permission-set.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-permission-show.xml

flatpak-permission-show(1): Remove incorrect paragraph from description

2025-01-14 20:24:15 +01:00

flatpak-permissions.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-pin.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-preinstall.xml

Add initial support for preinstalling flatpaks

2025-08-26 11:51:07 +00:00

flatpak-ps.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-remote-add.xml

doc: rename man pages to flatpakref(5) and flatpakrepo(5)

2024-02-15 11:41:56 -06:00

flatpak-remote-delete.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-remote-info.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-remote-ls.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-remote-modify.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-remote.xml

common: Implement /etc/containers/certs.d for OCI registries

2025-05-08 16:08:21 +00:00

flatpak-remotes.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-repair.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-repo.xml

Unify DocBook DTDs

2020-08-10 15:14:38 +02:00

flatpak-run.xml

exports: add host-root

2025-09-24 17:19:21 +00:00

flatpak-search.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-spawn.xml

doc: update documentation of flatpak-spawn --watch-bus

2025-06-25 13:16:08 +00:00

flatpak-summaries.txt

docs: Add initial document describing the flatpak summary files.

2020-10-29 17:19:47 +01:00

flatpak-uninstall.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak-update.xml

app: Add -u alias for --user

2022-08-16 10:50:29 +02:00

flatpak.xml

flatpak(1): Document more environment variables

2025-01-10 14:30:32 +01:00

flatpakref.xml

doc: rename man pages to flatpakref(5) and flatpakrepo(5)

2024-02-15 11:41:56 -06:00

flatpakrepo.xml

dir: search for repositories also under FLATPAK_BASEDIR

2024-09-20 17:30:56 +01:00

meson.build

Add initial support for preinstalling flatpaks

2025-08-26 11:51:07 +00:00

release-checklist.md

release-checklist: Match the last few releases

2024-11-28 16:23:25 +00:00

xmlto-config.xsl

Improve html generation

2017-04-14 10:43:40 -04:00