cdist-type__filesystem - Man Page

Create Filesystems.

Description

This cdist type allows you to create filesystems on devices.

If the device is mounted on target, it refuses to do anything.

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.

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 lsblk accepted device notation.

For example:
/dev/sdx
or /dev/disk/by-xxxx/xxx
or /dev/mapper/xxxx
label

Label which should be applied on the filesystem.

mkfsoptions

Additional options which are inserted to the mkfs.xxx call.

Boolean Parameters

force

Normally, this type does nothing if a filesystem is found on the target device. If you specify force, it's formatted if the filesystem type or label differs from parameters. Warning: This option can easily lead into data loss!

Messages

filesystem <fstype> on <device>

<discoverd device> created Filesystem was created on <discoverd device>

Examples

# 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

Authors

Daniel Heule <hda--@--sfs.biz>

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+).

Info

Dec 21, 2020 6.9.4 cdist