Skip to content

Update documentation #2890

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 27, 2025
Merged

Update documentation #2890

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions doc/source/troubleshooting/filesystems.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,22 @@ XFS

<type fscreateoptions="-i sparse=0"/>

btrfs
btrfs and default page sizes (4k vs 64k). By default btrfs
autodetects the sectorsize according to the used kernel page
size. If the sectorsize differs from the page size, the
created filesystem can not be mounted by the image target
kernel. If there is a different kernel page size between the
kernel on the system the image is build on and the later
kernel used for the image, it's required to specify the
filesystem sector size to match with the kernel page size
of the kernel used for the image. This can be done like in
the following example:

.. code:: xml

<type fscreateoptions="--sectorsize 4k"/>

.. note::

There can be more inconsistencies in the area of filesystems
Expand Down