.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__FILESYSTEM" "7" "Jun 23, 2019" "5.1.2" "cdist"
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH NAME
.sp
cdist\-type__filesystem \- Create Filesystems.
.SH DESCRIPTION
.sp
This cdist type allows you to create filesystems on devices.
.sp
If the device is mounted on target, it refuses to do anything.
.sp
If the device has a filesystem other then the specified and/or
the label is not correct, it only makes a new filesystem
if you have specified \-\-force option.
.SH REQUIRED PARAMETERS
.INDENT 0.0
.TP
.B fstype
Filesystem type, for example \(aqext3\(aq, \(aqbtrfs\(aq or \(aqxfs\(aq.
.UNINDENT
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B device
Blockdevice for filesystem, Defaults to object_id.
On linux, it can be any lsblk accepted device notation.
.nf

For example:
.in +2
/dev/sdx
or /dev/disk/by\-xxxx/xxx
or /dev/mapper/xxxx
.in -2
.fi
.sp
.TP
.B label
Label which should be applied on the filesystem.
.TP
.B mkfsoptions
Additional options which are inserted to the mkfs.xxx call.
.UNINDENT
.SH BOOLEAN PARAMETERS
.INDENT 0.0
.TP
.B force
Normally, this type does nothing if a filesystem is found
on the target device. If you specify force, it\(aqs formatted
if the filesystem type or label differs from parameters.
Warning: This option can easily lead into data loss!
.UNINDENT
.SH MESSAGES
.INDENT 0.0
.TP
.B filesystem <fstype> on <device> : <discoverd device> created
Filesystem was created on <discoverd device>
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Ensures that device /dev/sdb is formatted with xfs
__filesystem /dev/sdb \-\-fstype xfs \-\-label Testdisk1
# The same thing with btrfs and disk spezified by pci path to disk 1:0 on vmware
__filesystem dev_sdb \-\-fstype btrfs \-\-device /dev/disk/by\-path/pci\-0000:0b:00.0\-scsi\-0:0:0:0 \-\-label Testdisk2
# Make sure that a multipath san device has a filesystem ...
__filesystem dev_sdb \-\-fstype xfs \-\-device /dev/mapper/360060e80432f560050202f22000023ff \-\-label Testdisk3
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHORS
.sp
Daniel Heule <\fI\%hda\-\-@\-\-sfs.biz\fP>
.SH COPYING
.sp
Copyright (C) 2016 Daniel Heule. Free use of this software is
granted under the terms of the GNU General Public License version 3 or any later version (GPLv3+).
.SH COPYRIGHT
ungleich GmbH 2019
.\" Generated by docutils manpage writer.
.