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) 2023 Jakub Kruszona-Zawadzki, Saglabs SA

       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)

MooseFS 3.0.117-1                                 February 2023                                  mfssnapshots(1)