---
name: "cdist-type__filesystem"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__filesystem"
---

# cdist-type\_\_filesystem(7)

Create Filesystems.

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

## COPYRIGHT

ungleich GmbH 2021