cdist-type__filesystem - Create Filesystems.
Contents
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!
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+).
Copyright
ungleich GmbH 2021
7.0.0 Sep 11, 2024 CDIST-TYPE__FILESYSTEM(7)
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.
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
Messages
filesystem<fstype>on<device>:<discoverddevice>created
Filesystem was created on <discoverd device>
Name
cdist-type__filesystem - Create Filesystems.
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.
Required Parameters
fstype Filesystem type, for example 'ext3', 'btrfs' or 'xfs'.
