'\" t
.\"     Title: mfsmetarestore
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 06/17/2017
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MFSMETARESTORE" "8" "06/17/2017" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
mfsmetarestore \- replay LizardFS metadata change logs or dump LizardFS metadata image
.SH "SYNOPSIS"
.sp
.nf
\fBmfsmetarestore\fR [\fB\-z\fR] \fB\-m\fR \fIOLDMETADATAFILE\fR \fB\-o\fR \fINEWMETADATAFILE\fR [\fICHANGELOGFILE\fR\&...]
.fi
.sp
.nf
\fBmfsmetarestore\fR \fB\-m\fR \fIMETADATAFILE\fR
.fi
.sp
.nf
\fBmfsmetarestore\fR [\fB\-z\fR] \fB\-a\fR [\fB\-d\fR \fIDIRECTORY\fR]
.fi
.sp
.nf
\fBmfsmetarestore\fR \fB\-g\fR \fB\-d\fR \fIDIRECTORY\fR
.fi
.sp
.nf
\fBmfsmetarestore \-v\fR
.fi
.sp
.nf
\fBmfsmetarestore \-?\fR
.fi
.SH "DESCRIPTION"
.sp
When \fBmfsmetarestore\fR is called with both \fB\-m\fR and \fB\-o\fR options, it replays given \fICHANGELOGFILEs\fR on \fIOLDMETADATAFILE\fR and writes result to \fINEWMETADATAFILE\fR\&. Multiple change log files can be given\&.
.sp
\fBmfsmetarestore\fR with just \fB\-m\fR \fIMETADATAFILE\fR option dumps LizardFS metadata image file in human readable form\&.
.sp
\fBmfsmetarestore\fR called with \-a option automatically performs all operations needed to merge change log files\&. Master data directory can be specified using \-d \fIDIRECTORY\fR option\&.
.sp
\fBmfsmetarestore\fR \-g with path to metadata files, prints latest metadata version that can be restored from disk\&. Prints 0 if metadata files are corrupted\&.
.PP
\fB\-v\fR
.RS 4
print version information and exit
.RE
.PP
\fB\-?\fR
.RS 4
print version information and exit
.RE
.PP
\fB\-a\fR
.RS 4
autorestore mode (see above)
.RE
.PP
\fB\-d\fR \fIDATAPATH\fR
.RS 4
master data directory (for autorestore mode)
.RE
.PP
\fB\-m\fR \fIMETADATAFILE\fR
.RS 4
specify input metadata image file
.RE
.PP
\fB\-o\fR \fINEWMETADATAFILE\fR
.RS 4
specify output metadata image file
.RE
.PP
\fB\-z\fR
.RS 4
ignore metadata checksum inconsistency while applying changelogs
.RE
.SH "FILES"
.PP
\fBmetadata\&.mfs\fR
.RS 4
Lizard File System metadata image as read by
\fBmfsmaster\fR
process
.RE
.PP
\fBmetadata\&.mfs\&.back\fR
.RS 4
Lizard File System metadata image as left by killed or crashed
\fBmfsmaster\fR
process
.RE
.PP
\fBchangelog\&.\fR*\fB\&.mfs\fR
.RS 4
Lizard File System metadata change logs
.RE
.SH "REPORTING BUGS"
.sp
Report bugs to <contact@lizardfs\&.org>\&.
.SH "COPYRIGHT"
.sp
Copyright 2008\-2009 Gemius SA, 2013\-2015 Skytechnology sp\&. z o\&.o\&.
.sp
LizardFS 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 3\&.
.sp
LizardFS 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\&.
.sp
You should have received a copy of the GNU General Public License along with LizardFS\&. If not, see http://www\&.gnu\&.org/licenses/\&.
.SH "SEE ALSO"
.sp
mfsmaster(8), moosefs(7)