FreeBSD Manual Pages
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; padding 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) 2023 Jakub Kruszona-Zawadzki, Saglabs SA 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.117-1 February 2023 mfssnapshots(1)
NAME | SYNOPSIS | DESCRIPTION | SLICES | REPORTING BUGS | COPYRIGHT | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mfssnapshots&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>