NAME

       mfssnapshots - MooseFS snapshot tools

SYNOPSIS

       mfsappendchunks [-s FROM:TO] SNAPSHOT_FILE OBJECT...

       mfsmakesnapshot [-o|-c|-p] SOURCE... DESTINATION

       mfsrmsnapshot [-f] OBJECT...

DESCRIPTION

       mfsappendchunks  (equivalent of mfssnapshot from MooseFS 1.5) appends a lazy copy of specified file(s) to
       specified snapshot file ("lazy" means that creation of new chunks is delayed to the moment  one  copy  is
       modified). If multiple files are given, they are merged into one target file in such a way that each file
       begins at chunk (64MB) boundary; padding space is left empty. Optionally only  slice  of  chunks  can  be
       appended  (option  -s).  Slice  definition  is similar to Python: FROM is included, TO excluded, negative
       numbers mean backwards from the end. If FROM or TO is not specified then it means from the  beginning  or
       to the end of file respectively. See examples below.

       mfsmakesnapshot makes a "real" snapshot (lazy copy, like in case of mfsappendchunks) of some object(s) or
       subtree (similarly to cp -r command). It's atomic with respect to each SOURCE  argument  separately.   If
       DESTINATION  points  to  already  existing  file,  error will be reported unless -o (overwrite) option is
       given. Note: if SOURCE is a directory, it is copied as a whole; but if it's followed by  trailing  slash,
       only directory content is copied. When -c option is given then attributes of newly created files are more
       similar to those created by ordinary cp (without attribute preserving). Option -p preserves hardlinks  in
       SOURCE  (when  two  or more objects inside SOURCE are hardlinked to each other then in DESTINATION folder
       those objects will be hardlinked to each other as well).

       mfsrmsnapshot removes objects created as a result of  mfsmakesnapshot  (similarly  to  rm  -r,  but  much
       faster).  For  safety  reasons  objects  created via mfsmakesnapshot have the snapshot attribute set (see
       mfseattr(1)) and only such objects can be removed using mfsrmsnapshot command. By default all  files  and
       directories  inside  specified directory must have this attribute set for the command to remove the whole
       directory; otherwise the command will not remove anything. This behavior can be overridden by -f  option.
       With  this option mfsrmsnapshot will remove only those files/directories that have snapshot attribute set
       and will leave everything else untouched.

SLICES

       FROM:TO for source file with chunks 0,1,2,...,N-1,N:

       2:4 = chunks 2 and 3

       3: = chunks 3,4,...,N

       :5 = chunks 0,1,2,3,4

       :-1 = chunks 0,1,2,3,...,N-1

       -4:-2 = chunks N-3,N-2

REPORTING BUGS

       Report bugs to <bugs@moosefs.com>.

COPYRIGHT

       Copyright (C) 2021 Jakub Kruszona-Zawadzki, Core Technology Sp. z o.o.

       This file is part of MooseFS.

       MooseFS is free software; you can redistribute it and/or modify it under the terms  of  the  GNU  General
       Public License as published by the Free Software Foundation, version 2 (only).

       MooseFS  is  distributed  in  the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
       implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.  See  the  GNU  General  Public
       License for more details.

       You  should  have  received a copy of the GNU General Public License along with MooseFS; if not, write to
       the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,  MA  02111-1301,  USA  or  visit
       http://www.gnu.org/licenses/gpl-2.0.html

SEE ALSO

       mfsmount(8), mfstools(1), mfseattr(1)