xfs
[Top] [All Lists]

[RFCv3.1 00/21] xfs-documentation: massive cleanups and add v5 format, r

To: hch@xxxxxxxxxxxxx, david@xxxxxxxxxxxxx, darrick.wong@xxxxxxxxxx
Subject: [RFCv3.1 00/21] xfs-documentation: massive cleanups and add v5 format, reverse-mapping, reflink, and dedupe support
From: "Darrick J. Wong" <darrick.wong@xxxxxxxxxx>
Date: Wed, 11 Nov 2015 11:22:19 -0800
Cc: xfs@xxxxxxxxxxx
Delivered-to: xfs@xxxxxxxxxxx
User-agent: StGit/0.17.1-dirty
Hi all,

This is part of the third revision of an RFC for adding support to XFS
for tracking reverse-mappings of physical blocks to file and metadata;
and support for mapping multiple file logical blocks to the same
physical block, more commonly known as reflinking.  This is the first
time I've posted patches against the documentation, but they fit with
the pending RFCv3 code patches, so they're now a part of the full
suite.

This patch set does the following:

 * Cleans up leftover artifacts of the XML -> asciidoc conversion.

 * Fixes the formatting of quoted text and structure field
   definitions.

 * Fixes a lot of the strange wording in the existing documentation.

 * Replaces the screen dump PNGs with (much smaller) text sections.
   There's a huge 1.2MB patch to remove the image files as well, but
   I'll probably just send that privately to Dave later on.

 * Fills in the missing xfs_db examples and structure field
   definitions.

 * Fills in the missing realtime and journal sections.

 * Covers the new header formats for v5 filesystems.

 * Adds a magic number index.

 * Adds a brief overview of what is XFS, prior to jumping into the
   disk format.

 * Covers sparse inodes, reverse mapping btrees, reference count
   btrees and reflink.

 * Switches the xattr and directory chapters since the directory
   chapter introduces the btrees that xattrs can use.

The patch set is based on the current master branch.  As specified
eleswhere, I have git trees for the kernel[1], xfsprogs[2],
xfstests[3], and xfs-docs[4].  Comments and questions are, as always,
welcome.

--D

[1] https://github.com/djwong/linux/tree/for-dave
[2] https://github.com/djwong/xfsprogs/tree/for-dave
[3] https://github.com/djwong/xfstests/tree/for-dave
[4] https://github.com/djwong/xfs-documentation/tree/for-dave

<Prev in Thread] Current Thread [Next in Thread>