16.51. cdist-type__filesystem(7)¶

16.51.1. NAME¶

cdist-type__filesystem - Create Filesystems.

16.51.2. 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.

16.51.3. REQUIRED PARAMETERS¶

fstype: Filesystem type, for example 'ext3', 'btrfs' or 'xfs'.

16.51.4. 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.

16.51.5. 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!

16.51.6. MESSAGES¶

filesystem <fstype> on <device><discoverd device> created: Filesystem was created on <discoverd device>

16.51.7. 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

16.51.8. AUTHORS¶

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