Remove broken opengrok links
[ikiwiki.git] / hammerscript / index.mdwn
index bc2e306..0e4b0f1 100644 (file)
@@ -102,6 +102,10 @@ Each pseudo-file-system (PFS) on a Hammer volume is part of that volume's space.
 
 For a long-term fix, you may want to change the amount of history retained in any given PFS with 'hammer viconfig'.  That same config controls what 'hammer prune' will remove.
 
-How to create a snapshot
+*How to create a snapshot*
 
-* Creating a snapshot
+By and large, you never need to create a snapshot manually.  Hammer volumes are set up to do so, once a day by default, and saved for 60 days.  Snapshots happen at the PFS level and automatic snapshots are configured with 'hammer viconfig', see the cleanup section of the hammer(8) manpage for details.
+
+These snapshots can be found in /var/hammer, in directories named after the matching PFS.  So, if you happen to delete an important log file in /usr, chances are good you can find an older version of it in /var/hammer/usr/.  Each snapshot is named by the time at which it is taken, i.e. 'snap-YYYYMMDD-HHMM'.  Treat them as read-only backup volume that you can copy from at any time.
+
+If you do want to create a snapshot at an arbitrary time, 'hammer snap PATH' will take an immediate snapshot of the PFS that contains PATH.