Minor documentation updates.
authorMichael Vrable <mvrable@cs.ucsd.edu>
Thu, 14 Feb 2008 22:48:04 +0000 (14:48 -0800)
committerMichael Vrable <mvrable@turin.ucsd.edu>
Thu, 14 Feb 2008 22:48:04 +0000 (14:48 -0800)
NEWS
README

diff --git a/NEWS b/NEWS
index d1318ca..19c2377 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-0.6
+0.6 [???]
     - SNAPSHOT FORMAT CHANGE: A few minor tweaks have been made to the
       snapshot format.  There is nothing substantial--this is primarily
       a cleaning up of the format before use becomes more widespread.
diff --git a/README b/README
index 05b37fc..20472d4 100644 (file)
--- a/README
+++ b/README
@@ -4,7 +4,7 @@ How to Build
 ------------
 
 Dependencies:
-  - libuuid
+  - libuuid (sometimes part of e2fsprogs)
   - sqlite3
 
 Building should be a simple matter of running "make".  This will produce
@@ -91,19 +91,25 @@ that are mostly unused, but are storing a small amount of useful data.
 Data in these segments will be rewritten into new segments in future
 backups to eliminate the dependence on the almost-empty old segments.
 
-Segment cleaning is currently a mostly manual process.  An automatic
-tool for performing segment cleaning will be available in the future.
+The provided lbs-util tool can perform the necessary cleaning.  Run it
+with
+    $ lbs-util --localdb=/lbs.db clean
+Cleaning is still under development, and so may be improved in the
+future, but this version is intended to be functional.
 
 Old backup snapshots can be pruned from the snapshot directory (/lbs) to
-recover space.  Deleting an old backup snapshot is a simple matter of
-deleting the appropriate snapshot descriptor file (snapshot-*.lbs) and
-any associated checksums (snapshot-*.sha1sums).  Segments used by that
-snapshot, but not any other snapshots, can be identified by running the
-clean-segments.pl script from the /lbs directory--this will perform a
-scan of the current directory to identify unreferenced segments, and
-will print a list to stdout.  Assuming the list looks reasonable, the
-segments can be quickly deleted with
+recover space.  A snapshot which is still referenced by the local
+database should not be deleted, however.  Deleting an old backup
+snapshot is a simple matter of deleting the appropriate snapshot
+descriptor file (snapshot-*.lbs) and any associated checksums
+(snapshot-*.sha1sums).  Segments used by that snapshot, but not any
+other snapshots, can be identified by running the clean-segments.pl
+script from the /lbs directory--this will perform a scan of the current
+directory to identify unreferenced segments, and will print a list to
+stdout.  Assuming the list looks reasonable, the segments can be quickly
+deleted with
     $ rm `./clean-segments.pl`
+A tool to make this easier will be implemented later.
 
 The clean-segments.pl script will also print out a warning message if
 any snapshots appear to depend upon segments which are not present; this