'\" t
.\"     Title: lizardfs
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 01/28/2018
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "LIZARDFS" "1" "01/28/2018" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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"
lizardfs \- open prompt to perform LizardFS\-specific operations
.SH "SYNOPSIS"
.sp
.nf
\fBlizardfs getgoal\fR [\fB\-r\fR] [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs rgetgoal\fR [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs setgoal\fR [\fB\-r\fR] [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fINAME\fR \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs rsetgoal\fR [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] [\fB+\fR|\fB\-\fR]N \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs setquota\fR (\fB\-u\fR \fIUID\fR | \fB\-g\fR \fIGID\fR) \fISOFT\-LIMIT\-SIZE\fR \fIHARD\-LIMIT\-SIZE\fR
              \fISOFT\-LIMIT\-INODES\fR \fIHARD\-LIMIT\-INODES\fR \fIMOUNTPOINT\-ROOT\-PATH\fR
.fi
.sp
.nf
\fBlizardfs repquota\fR [\fB\-nhH\fR] (\fB\-u\fR \fIUID\fR | \fB\-g\fR \fIGID\fR)+ \fIMOUNTPOINT\-ROOT\-PATH\fR
\fBlizardfs repquota\fR [\fB\-nhH\fR] \-a \fIMOUNTPOINT\-ROOT\-PATH\fR
.fi
.sp
.nf
\fBlizardfs gettrashtime\fR [\fB\-r\fR] [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs rgettrashtime\fR [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs settrashtime\fR [\fB\-r\fR] [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] [\fB+\fR|\fB\-\fR]SECONDS \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs rsettrashtime\fR [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] [\fB+\fR|\fB\-\fR]SECONDS \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs geteattr\fR [\fB\-r\fR] [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs seteattr\fR [\fB\-r\fR] [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fB\-f\fR \fIATTRNAME\fR [\fB\-f\fR \fIATTRNAME\fR \&...] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs deleattr\fR [\fB\-r\fR] [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fB\-f\fR \fIATTRNAME\fR [\fB\-f\fR \fIATTRNAME\fR \&...] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs checkfile\fR \fIFILE\fR\&...
.fi
.sp
.nf
\fBlizardfs fileinfo\fR \fIFILE\fR\&...
.fi
.sp
.nf
\fBlizardfs dirinfo\fR [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs filerepair\fR [\fB\-n\fR|\fB\-h\fR|\fB\-H\fR] \fIFILE\fR\&...
.fi
.sp
.nf
\fBlizardfs appendchunks\fR \fISNAPSHOT_FILE\fR \fIOBJECT\fR\&...
.fi
.sp
.nf
\fBlizardfs makesnapshot\fR [\fB\-o\fR] \fISOURCE\fR\&... \fIDESTINATION\fR
.fi
.sp
.nf
\fBlizardfs rremove\fR [\fB\-l\fR] \fIOBJECT\fR\&...
.fi
.SH "DESCRIPTION"
.sp
See respective documents\&.
.SH "GENERAL OPTIONS"
.sp
Most of \fBlizardfs\fR operations use following options to select format of printed numbers:
.PP
\fB\-n\fR
.RS 4
Print exact numbers (e\&.g\&. 1024)\&.
.RE
.PP
\fB\-h\fR
.RS 4
Print numbers with binary prefixes (Ki, Mi, Gi as
2^10,
2^20
etc\&.)\&.
.RE
.PP
\fB\-H\fR
.RS 4
Print numbers with SI prefixes (k, M, G as
10^3,
10^6
etc\&.)\&.
.RE
.sp
The same can be achieved by setting \fBMFSHRFORMAT\fR environment variable to: \fB0\fR (exact numbers), \fB1\fR or \fBh\fR (binary prefixes), \fB2\fR or \fBH\fR (SI prefixes), \fB3\fR or \fBh+\fR (exact numbers and binary prefixes), \fB4\fR or \fBH+\fR (exact numbers and SI prefixes)\&. The default is to print just exact numbers\&.
.sp
Other options:
.PP
\fB\-r\fR
.RS 4
This option enables recursive mode\&.
.RE
.SH "INHERITANCE"
.sp
When new object is created in LizardFS, attributes such as goal, trashtime and extra attributes are inherited from parent directory\&. So if you set i\&.e\&. "noowner" attribute and goal to 3 in a directory then every new object created in this directory will have goal set to 3 and "noowner" flag set\&. A newly created object inherits always the current set of its parent\(cqs attributes\&. Changing a directory attribute does not affect its already created children\&. To change an attribute for a directory and all of its children use \*(Aq\-r\*(Aq option\&.
.SH "REPORTING BUGS"
.sp
Report bugs to <contact@lizardfs\&.org>\&.
.SH "COPYRIGHT"
.sp
Copyright 2008\-2009 Gemius SA, 2013\-2016 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
mfsmount(1), lizardfs\-appendchunks(1), lizardfs\-checkfile(1), lizardfs\-deleattr(1), lizardfs\-dirinfo(1), lizardfs\-fileinfo(1), lizardfs\-filerepair(1), lizardfs\-geteattr(1), lizardfs\-getgoal(1), lizardfs\-gettrashtime(1), lizardfs\-makesnapshot(1), lizardfs\-rgetgoal(1), lizardfs\-rgettrashtime(1), lizardfs\-rsetgoal(1), lizardfs\-rsettrashtime(1), lizardfs\-seteattr(1), lizardfs\-setgoal(1), lizardfs\-settrashtime(1), lizardfs\-rremove(1), lizardfs\-repquota(1), lizardfs\-setquota(1), moosefs(7)