8677 Commits
Author SHA1 Message Date
razzeee e382cbeb80 docs: Add contributing hints about commit message expectations 2026-09-02 11:01:03 +00:00
Sebastian Wick 1a6ec6a1f7 Revert "run: Fix seccomp socket family filtering on i386"
It turns out that at least Steam currently crashes because the
socketcall syscall is not available to it anymore.

This reverts commit 04d0046e14.
2026-08-27 19:12:39 +00:00
Sebastian Wick 540a487ed1 subprojects: Update bubblewrap to v0.12.0
It contains a crucial security fix for mount destination path
resolution.
2026-08-26 14:29:17 +00:00
Bart Piotrowski 70011ab5d4 Switch CoC to Contributor Covenant, update contact info 2026-08-25 09:35:50 +02:00
luming zh e182111ad0 po: Update Chinese (China) translation 2026-08-24 10:37:34 +00:00
Simon McVittie 55ec5bd592 libtest: Fix undefined variable reference if all test-cases are skipped
Fixes: f0ce1311 "tests: Drop plan_tests function, no longer used"
Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 16:08:07 +00:00
Simon McVittie 86d10f5f7a Revert "tests: Avoid Meson's strict TAP parsing for now"
Now that our error messages are valid UTF-8, we should no longer need to
do this.

This reverts commit 242e9893e7.

Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 16:07:48 +00:00
Simon McVittie 5f3f7a8b98 ref-utils: Always produce valid UTF-8 in validation error messages
While I'm changing the translatable string anyway, this also
incorporates a suggestion from #6753 to quote the invalid character, so
that output is clearer in the case where the invalid character is
whitespace.

Thanks: Christian Stadelmann
Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 16:07:48 +00:00
Simon McVittie 00457f29f3 po: Update translations for "Invalid glob character" where obvious
Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 16:07:48 +00:00
Simon McVittie 9cd0ef4b0b utils: Avoid corrupting our output if an invalid glob is not UTF-8
Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 16:07:48 +00:00
Simon McVittie ffcb20f781 utils: Add a function to describe invalid characters in strings
Until now we have been using `%c` to show invalid characters, but in
general that will corrupt our output if the input is non-ASCII,
because the individual bytes of a UTF-8 string are not valid UTF-8 alone.

Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 16:07:48 +00:00
Simon McVittie f0ce1311af tests: Drop plan_tests function, no longer used
Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 15:34:20 +00:00
Simon McVittie eb240aa067 tests: Consistently Use the "no plan" style for TAP tests
Instead of announcing ahead of time how many tests will be run, just
log 1..32 or similar at the end, from the done_testing function.

This should go some way towards preventing unnecessary cherry-pick
conflicts when tests added to this script get backported.

Resolves: https://github.com/flatpak/flatpak/issues/6793
Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 15:34:20 +00:00
Simon McVittie f7a88aca00 tests: At the end of each test, explicitly log that we have finished
This is the equivalent of the function of the same name in Perl's
Test::More. If we already emitted a test plan, it asserts that the
number of tests we planned to do equals the number we actually did.

If not, it assumes that however many tests we have done, that's all of
the tests that we intend to do - this can be useful in test scripts
that routinely increase in length, like test-run.sh which is becoming
rather long (and has frequent conflicts for the "plan" line when we
cherry-pick new test coverage to older branches).

Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 15:34:20 +00:00
Simon McVittie 724ac88751 tests: Add a function to declare the "plan", instead of direct echo
This is approximately the equivalent of 'plan' in Perl Test::More:
it announces how many tests we plan to run.

Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 15:34:20 +00:00
Simon McVittie ea4321912b tests: Track and emit TAP test numbers in shell script tests
This will help us to emit correct TAP syntax, without having to always
declare up-front how many tests we are going to run.

Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-21 15:34:20 +00:00
Sebastian Wick 3a5b50e93a README: Point translation contributions to GNOME's l10n platform
We just made it possible to create PRs through damned-lies, and might
want to switch to direct pushes. Let's point translators to this
workflow.
2026-08-21 13:28:47 +00:00
Sebastian Wick eb974af4b0 ci: Release with vendored libglnx and variant-schema-compiler
We now have subprojects for a few dependencies. libglnx and
variant-schema-compiler used to be git subtrees and we recommend
distributions to use those vendored dependencies. We turned them into
meson wraps, which means they are no longer vendored in. We can include
them with --include-subprojects, but then we have to make sure that the
subprojects we recommend to use from the system (bwrap and
xdg-dbus-proxy) are disabled.
2026-08-21 12:55:37 +00:00
Sebastian Wick 49040df5f2 build: Use a meson .wrap file for the variant-schema-compiler subproject
It is not a meson project, but we can use the patch_directory key to
overlay a meson.build file over the git checkout. It uses
meson.override_find_program so that in flatpak, a call to
find_program('variant-schema-compiler') will find the program.
2026-08-21 12:55:37 +00:00
Sebastian Wick db7f12b4c8 build: Use a meson .wrap file for the libglnx subproject
And make libglnx a static library dependency.
2026-08-21 12:55:37 +00:00
luming zh c1ddb66f85 po: Update Chinese (China) translation 2026-08-20 08:28:56 +00:00
Sebastian Wick 06f43a572e tests: Add test for copying symlinks 2026-08-19 14:57:39 +00:00
Sebastian Wick f637529fc9 glnx_file_copy_at: Use O_PATH fd for xattr and ownership operations
After creating the symlink, open it with O_PATH to pin the inode and
verify the target matches. All subsequent operations (xattrs, chown) go
through the pinned fd instead of path-based operations.
2026-08-19 14:57:39 +00:00
Sebastian Wick 8699d67a48 xattrs: Drop fd-based code paths from get_xattrs_impl
All callers now go through /proc/self/fd paths, so the flistxattr,
fgetxattr branches and the fd parameter are dead code.
2026-08-19 14:57:39 +00:00
Sebastian Wick b30c4ad983 xattrs: Use /proc/self/fd path in glnx_fd_set_all_xattrs
This allows it to work on O_PATH file descriptors, which is needed for
operating on symlinks.
2026-08-19 14:57:39 +00:00
Sebastian Wick 7339e32080 xattrs: Use /proc/self/fd path in glnx_fd_get_all_xattrs
This allows it to work on O_PATH file descriptors, which is needed for
operating on symlinks.
2026-08-19 14:57:39 +00:00
Sebastian Wick 6020dbf7f6 chase: Handle EAGAIN from openat2
From openat2(2):

  EAGAIN how.resolve contains either RESOLVE_IN_ROOT or
    RESOLVE_BENEATH, and the kernel could not ensure that a
    ".." component didn't escape (due to a race condition or
    potential attack).  The caller may choose to retry the
    openat2() call.

We should handle this by simply retrying the syscall.
2026-08-19 14:57:39 +00:00
Sebastian Wick 5a6c442c05 dir: Validate GVariant structure before using generated variant readers
Reject summaries, subsummaries, and summary indexes that are not in
GVariant normal form before passing them to the generated variant
accessor framework, which performs direct pointer arithmetic without
structural validation.
2026-08-19 14:31:47 +00:00
Sebastian Wick a7bf3fbf29 system-helper: Handle NULL entries in cache_dirs_in_use iteration
The cache_dirs_in_use tracks the cache dirs, and which pull it is
associated with. It can also be associated with no pull anymore in which
case the value is NULL.

The iteration over cache_dirs_in_use thus needs to handle NULL values.
2026-08-19 14:18:27 +00:00
Sebastian Wick 076391b856 README: Document the required kernel and conservative dependencies
Closes: #6774
2026-08-19 13:37:33 +00:00
Sebastian Wick 22eec07b5a portal: Account for source fds in fd_map_remap_fd max_fd tracking
fd_map_remap_fd assigns a temporary fd number (++max_fd) that may later
be used as a conflict resolution target. If the source fd passed to
fd_map_remap_fd is higher than max_fd, conflict resolution can assign
a replacement value that collides with that source fd. In
child_setup_func, the dup2 for the conflicting entry then overwrites
the source fd before it is remapped, delivering the wrong fd to the
child process.

In practice this manifests as sandbox-expose-fd-ro passing a random fd
(e.g. a socket) instead of the intended O_PATH fd to flatpak run via
--ro-bind-fd, producing errors like:

  error: /proc/self/fd/21 resolves to non-absolute path socket:[423446]

Similar error have been observed in Epiphany/WebKit:
https://bugs.webkit.org/show_bug.cgi?id=305344
2026-08-19 11:15:56 +00:00
luming zh 098c34b0b0 po: Update Chinese (China) translation 2026-08-19 10:34:21 +00:00
Sebastian Wick 476b8591e9 subprojects: Update dbus-proxy.wrap to v0.1.8
Version 0.1.7 contains a security vulnerability, so let's bump it to a
version which does not.
2026-08-18 11:49:26 +00:00
Sebastian Wick 100b450034 system-helper: Track the right unique sender name for pulls
The code used the connection name, which is the unique sender name of
the system-helper itself. Fix this and use the sender name of the
invocation.
2026-08-18 10:00:53 +00:00
Sebastian Wick 507d4b7df6 context: Drop g_hash_table_new_similar usage which requires glib 2.72
We require glib 2.46, so we can't rely on g_hash_table_new_similar.

Fixes: 17cb1135 ("context: Keep fallback-x11 separate from x11 conditionals")
Closes: #6775
2026-08-17 16:43:26 +00:00
Sebastian Wick 04d0046e14 run: Fix seccomp socket family filtering on i386
On architectures like i386, socket operations were historically
multiplexed through the socketcall syscall. The seccomp socket family
filter only applied to the direct socket syscall, so a binary using
socketcall could bypass it entirely.

Switch from seccomp_rule_add_exact to seccomp_rule_add, which lets
libseccomp also block socketcall. Since libseccomp cannot inspect
socketcall arguments (they are behind a userspace pointer), this
blocks all of socketcall, forcing userspace to use the direct socket
syscalls that have been available on i386 since Linux 4.3.
2026-08-14 12:22:17 +00:00
Simon McVittie 242e9893e7 tests: Avoid Meson's strict TAP parsing for now
Older versions of Meson parsed TAP output very strictly, and would fail
the test when a `g_test_message()` mentions non-UTF-8, which results
in GLib adding a prefix on stdout that is not valid TAP syntax.

Ideally our error messages should all be valid UTF-8 even if the input
is not, but that's a larger refactor that shouldn't block security fix
releases, so for now just tell Meson to get the tests' pass/fail status
from their exit status rather than parsing their stdout.

Signed-off-by: Simon McVittie <smcv@collabora.com>
2026-08-11 15:29:16 +00:00
Sebastian Wick 2ffbf4f977 Post-branching version bump 2026-08-11 14:28:52 +02:00
Sebastian Wick ec707cb43a 1.19.0 1.19.0 2026-08-11 01:22:29 +02:00
Sebastian Wick 1231727085 Update translation files for 1.19.0 2026-08-11 01:22:29 +02:00
Sebastian Wick 94a405c054 utils: Remove unused GFile based flatpak_cp_a
We use the fd based flatpak_cp_a_at now everywhere, so we can drop this
one.

Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-fqx6-vh4p-42cg
Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-8qxj-x646-phcm
2026-08-11 01:22:29 +02:00
Sebastian Wick 0860bb1d70 dir: Use chaseat in apply_extra_data to prevent path traversal
apply_extra_data() used GFile path-based operations that follow
symlinks: --ro-bind/--bind with resolved paths, chmod on the extra
directory path, and flatpak_cp_a for the extra/export merge.

These are not independently exploitable: apply_extra_data only runs
after extract_extra_data has already created files/extra as a real
directory, so there is no symlink left to follow. The apply_extra
script itself runs in a restricted sandbox with dropped caps and no
/proc. The extra/export merge only adds to the app's own export
directory, which is already app-controlled and whose desktop file
Exec keys are rewritten to flatpak run.

Replace with fd-relative operations as defense in depth:
glnx_chaseat with GLNX_CHASE_RESOLVE_NO_SYMLINKS and
GLNX_CHASE_RESOLVE_BENEATH for directory traversal,
--ro-bind-fd/--bind-fd for bwrap mounts, fchmod on the directory fd,
and flatpak_cp_a_at for the export merge.

Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-fqx6-vh4p-42cg
[smcv: Use glnx_fd_reopen() to reopen O_PATH fd as readable]
Co-authored-by: Simon McVittie <smcv@collabora.com>
2026-08-11 01:22:28 +02:00
Sebastian Wick 70fdf20886 dir: Use chaseat in extract_extra_data to prevent path traversal
extract_extra_data() had two vulnerabilities:

1. It resolved "files/extra" using g_file_resolve_relative_path()
   which follows symlinks. A crafted OSTree commit with "files" as a
   symlink causes extra-data blobs to be written at the symlink target.
   On system installs this runs as root via the system helper, which
   validates signatures and checksums but not tree structure.

2. It used g_file_get_child(extradir, name) where name comes from
   xa.extra-data-sources in the commit metadata. Names containing ".."
   escape the extra/ directory. This is exploitable through the normal
   build flow: flatpak build-export rejects "/" but not "..".

Replace GFile path operations with fd-relative operations: open
"files" with glnx_chaseat using GLNX_CHASE_RESOLVE_NO_SYMLINKS,
create "extra" with glnx_chase_and_mkdirat using
GLNX_CHASE_RESOLVE_BENEATH, validate extra-data names against ".",
"..", and "/", and write with glnx_file_replace_contents_at anchored
to the extra directory fd.

[smcv: Open checkoutdir_dfd before trying to open its files subdir]
Co-authored-by: Simon McVittie <smcv@collabora.com>
Resolves: https://github.com/flatpak/flatpak/security/advisories/GHSA-fqx6-vh4p-42cg
2026-08-11 01:22:28 +02:00
Sebastian Wick f635826dc7 dir: Validate extra-data name in pull_extra_data_to_bytes
Reject extra-data names containing ".", "..", or "/" early during the
download phase. The name is used to construct a local cache file path
via flatpak_build_file() which uses g_file_resolve_relative_path(),
so ".." components could traverse outside the cache directory.

In practice this is not exploitable: the local cache path is only
used for a g_file_query_exists() check followed by g_file_load_contents(),
and the loaded content is verified against the expected sha256 from
the commit metadata.

Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-fqx6-vh4p-42cg
2026-08-11 01:22:28 +02:00
Sebastian Wick 9a8374fb7a build-init: Use fd-relative operations to prevent path traversal
ensure_extensions() used g_file_resolve_relative_path() with
ext->directory, which comes from runtime/SDK metadata and can contain
".." components. This allowed a malicious extension to write outside
the build directory.

Replace the GFile-based path resolution with glnx_chase_and_mkdirat()
using GLNX_CHASE_RESOLVE_BENEATH | GLNX_CHASE_RESOLVE_NO_SYMLINKS,
which rejects any path that escapes the directory fd.

Convert the rest of flatpak_builtin_build_init to fd-relative
operations (mkdirat, symlinkat, glnx_opendirat, glnx_shutil_rm_rf_at,
glnx_file_replace_contents_at, flatpak_cp_a_at) anchored to a
base_dfd opened from the build directory.

Resolves: https://github.com/flatpak/flatpak/security/advisories/GHSA-8qxj-x646-phcm
2026-08-11 01:22:28 +02:00
Sebastian Wick 6e94393cc6 utils: Make flatpak_cp_a a wrapper around flatpak_cp_a_at
[smcv: Separated from a larger commit]

Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-fqx6-vh4p-42cg
Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-8qxj-x646-phcm
2026-08-11 01:22:28 +02:00
Sebastian Wick c34e4cf0bb utils: Add flatpak_cp_a_at, a fd-based flatpak_cp_a variant
For all the usual reasons where an attacker might control a symlink.

For simplicity this does not implement the unused FLATPAK_CP_FLAGS_MOVE
flag.

[smcv: Separated from a larger commit]

Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-fqx6-vh4p-42cg
Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-8qxj-x646-phcm
2026-08-11 01:22:28 +02:00
Sebastian Wick eaffd3ce36 system-dir: Prevent removing of deployed refs via the system-helper
We have two use cases for removing refs: uninstalling, and pruning of
undeployed refs. Pruning undeployed refs is something we want anyone to
be able to do, because they can also pull updates and then not deploy
them. Uninstalling arbitrary refs on the other hand is problematic, and
its possible to remove the AppStream ref, and a deployed ref.

So we split removing a ref into a function which removes any ref, and
use it internally to implement e.g. uninstalling, and a function to
remove refs which are safe to remove. Only the latter one will escalate
through the system helper, making it harder for unprivileged users to
get into a state which can be exploited.

See the previous commit for such a state.

Resolves: https://github.com/flatpak/flatpak/security/advisories/GHSA-q4gr-vc25-57m5
2026-08-11 01:22:28 +02:00
Sebastian Wick 044a44fe2e dir: Fall back to the deployed ref commit when up/downgrading
Otherwise, if an unprivileged user manages to remove the remote ref, the
downgrading protection is not in effect.

Helps: https://github.com/flatpak/flatpak/security/advisories/GHSA-q4gr-vc25-57m5
2026-08-11 01:22:28 +02:00
Sebastian Wick 739c6fae6c oci: Rebase hardlink targets in OCI archive extraction
Hardlink targets were not rebased to the destination directory,
allowing a crafted archive to hardlink arbitrary host files into the
extraction directory.

Also improve the documentation on how this all works, because it is all
a bit subtle.

Resolves: https://github.com/flatpak/flatpak/security/advisories/GHSA-9rww-v4mm-x4jg
2026-08-11 01:22:28 +02:00