cdist-type__filesystem(7) ========================= NAME ---- cdist-type__filesystem - Create Filesystems. DESCRIPTION ----------- This cdist type allows you to create filesystems on devices. If the device is mounted on target, it refuses to do someting. If the device has a filesystem other as the specified and/or the label is not correct, it only make a new filesystem if you specified --force option REQUIRED PARAMETERS ------------------- fstype Filesystem type, for example 'ext3', 'btrfs' or 'xfs' OPTIONAL PARAMETERS ------------------- device Blockdevice for filesystem, Defaults to object_id. On linux, it can be any by lsblk accepted device notation for example /dev/sdx or /dev/disk/by-xxxx/xxx or /dev/mapper/xxxx label Label which sould apply on the filesystem mkfsoptions Additional options which are inserted to the mkfs.xxx call. BOOLEAN PARAMETERS ------------------ force Normaly, this type does nothing if a filesystem is found on the target device. If you specify force, its formated if the filesystem type or label differs from parameters Warning: This option can easy lead into data loss ! MESSAGES -------- filesystem on : created Filesytem was created on EXAMPLES -------- .. code-block:: sh # Ensures that device /dev/sdb is formated 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 AUTHORS ------- Daniel Heule COPYING ------- 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+).