Re: [PATCH 1/2] Documentation: filesystems: cramfs: correct stale hard-link and endianness claims

From: Jonathan Corbet

Date: Sun May 03 2026 - 11:13:12 EST


Nicolas Pitre <nico@xxxxxxxxxxx> writes:

> Two paragraphs in cramfs.rst have been misleading for a long time:
>
> - "Hard links are supported, but hard linked files will still have
> a link count of 1": mkcramfs does not preserve hard links; it
> deduplicates by content (eliminate_doubles()). Two names for
> the same on-disk inode in the source tree become two separate
> (content-shared) entries in the image, and cramfs always reports
> a link count of 1.
>
> - "Currently, cramfs must be written and read with architectures of
> the same endianness ... PAGE_SIZE == 4096 ... is a bug, but it
> hasn't been decided what the best fix is": the endianness
> situation has been settled for years -- the kernel checks for
> CRAMFS_MAGIC_WEND in cramfs_fill_super() and refuses the mount,
> and mkcramfs has gained -B / -L for producing images of the
> opposite endianness from the build host (useful for cross-builds,
> but the reader still needs to match). Restate this accurately.
>
> Signed-off-by: Nicolas Pitre <nico@xxxxxxxxxxx>
> ---
> Documentation/filesystems/cramfs.rst | 22 ++++++++++++++--------
> 1 file changed, 14 insertions(+), 8 deletions(-)

I've applied both patches, thanks.

jon