Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
mfssnapshots(1)		    This is part of MooseFS	       mfssnapshots(1)

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 modi-
       fied). If multiple files	are given, they	are  merged  into  one	target
       file in such a way that each file begins	at chunk (64MB)	boundary; pad-
       ding space is left empty. Optionally only slice of chunks  can  be  ap-
       pended  (option -s). Slice definition is	similar	to Python: FROM	is in-
       cluded, 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 mf-
       sappendchunks)  of  some	 object(s) or subtree (similarly to cp -r com-
       mand). It's atomic with respect to each SOURCE argument separately.  If
       DESTINATION points to already existing file, error will be reported un-
       less -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 di-
       rectory 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  cre-
       ated  via  mfsmakesnapshot  have	 the  snapshot	attribute set (see mf-
       seattr(1)) and only such	objects	can  be	 removed  using	 mfsrmsnapshot
       command.	 By  default all files and directories inside specified	direc-
       tory must have this attribute set for the command to remove  the	 whole
       directory;  otherwise the command will not remove anything. This	behav-
       ior 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) 2020 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  un-
       der  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.113-1		   May 2020		       mfssnapshots(1)

NAME | SYNOPSIS | DESCRIPTION | SLICES | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mfssnapshots&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help