svn commit: r1693566 - /subversion/site/publish/docs/release-notes/1.9.html

[st...@apache.org]

Author: stefan2
Date: Fri Jul 31 11:07:18 2015
New Revision: 1693566

URL: http://svn.apache.org/r1693566
Log:
Cover the svnfsfs tool in the 1.9 release notes.

* publish/docs/release-notes/1.9.html
  (svnfsfs): Fill the sub-sections.

Modified:
    subversion/site/publish/docs/release-notes/1.9.html

Modified: subversion/site/publish/docs/release-notes/1.9.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.9.html?rev=1693566&r1=1693565&r2=1693566&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.9.html (original)
+++ subversion/site/publish/docs/release-notes/1.9.html Fri Jul 31 11:07:18 2015
@@ -562,7 +562,10 @@ means more net speed, some changes may a
     title="Link to this section">&para;</a>
 </h4>
 
-<p>### TODO
+<p>Where the <tt>svnadmin</tt> tool covers typical administrative tasks
+in a mostly back-end agnostic way, <tt>svnfsfs</tt> is a specialist tool
+for analyzing and manipulating of FSFS repositories.  It is not intended
+for everyday use.
 </p>
 
 </div>  <!-- svnfsfs-overview -->
@@ -573,7 +576,9 @@ means more net speed, some changes may a
     title="Link to this section">&para;</a>
 </h4>
 
-<p>### TODO
+<p>The <tt>fsfs-stats</tt> tool first released with Subversion 1.8 has
+been replaced by the <tt>svnfsfs stats</tt> sub-command and is no longer
+part of Subversion 1.9.  Both produce similar output.
 </p>
 
 </div>  <!-- svnfsfs-stats -->
@@ -584,9 +589,31 @@ means more net speed, some changes may a
     title="Link to this section">&para;</a>
 </h4>
 
-<p>### TODO
+<p>During forensics or data recovery, it is necessary for experts to
+directly "look into" the raw database files.  While the FSFS on-disk
+format is fully documented, the indirect addressing and reordering
+added in format 7 makes it hard for humans to trace internal references.
+This is where the <tt>svnfsfs dump-index</tt> sub-command is used.
+It produces a table describing all items in revision and pack files:
 </p>
 
+<pre>
+    $ svnfsfs dump-index /path/to/repo -r0
+       Start       Length Type   Revision     Item Checksum
+           0           11 drep          0        3 60232b75
+          11           59 node          0        2 403dbe48
+          6a            1 chgs          0        1 f28a4f1d
+</pre>
+
+<p>Because the index information must always match the actual file
+contents, updating the index data after every revision / pack file
+manipulation is mandatory in format 7. <tt>svnfsfs load-index</tt>
+allows you to do that.  It consumes the same table format as produced
+above, except that the checksum field is optional and will be ignored
+if given.
+</p>
+
+
 </div>  <!-- svnfsfs-index-manipulation -->
 
 </div>  <!-- svnfsfs -->