1CDIST-TYPE__FILESYSTEM(7)            cdist           CDIST-TYPE__FILESYSTEM(7)
2
3
4

NAME

6       cdist-type__filesystem - Create Filesystems.
7

DESCRIPTION

9       This cdist type allows you to create filesystems on devices.
10
11       If the device is mounted on target, it refuses to do anything.
12
13       If  the  device  has  a  filesystem other then the specified and/or the
14       label is not correct, it only makes a new filesystem if you have speci‐
15       fied --force option.
16

REQUIRED PARAMETERS

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

OPTIONAL PARAMETERS

21       device Blockdevice for filesystem, Defaults to object_id.  On linux, it
22              can be any lsblk accepted device notation.
23
24              For example:
25                /dev/sdx
26                or /dev/disk/by-xxxx/xxx
27                or /dev/mapper/xxxx
28
29
30       label  Label which should be applied on the filesystem.
31
32       mkfsoptions
33              Additional options which are inserted to the mkfs.xxx call.
34

BOOLEAN PARAMETERS

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

MESSAGES

42       filesystem <fstype> on <device>
43              <discoverd  device> created Filesystem was created on <discoverd
44              device>
45

EXAMPLES

47          # Ensures that device /dev/sdb is formatted with xfs
48          __filesystem /dev/sdb --fstype xfs --label Testdisk1
49          # The same thing with btrfs and disk spezified by pci path to disk 1:0 on vmware
50          __filesystem dev_sdb --fstype btrfs --device /dev/disk/by-path/pci-0000:0b:00.0-scsi-0:0:0:0 --label Testdisk2
51          # Make sure that a multipath san device has a filesystem ...
52          __filesystem dev_sdb --fstype xfs --device /dev/mapper/360060e80432f560050202f22000023ff --label Testdisk3
53

AUTHORS

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

COPYING

58       Copyright (C) 2016 Daniel Heule. Free use of this software  is  granted
59       under  the  terms  of  the  GNU General Public License version 3 or any
60       later version (GPLv3+).
61

63       ungleich GmbH 2020
64
65
66
67
686.9.4                            Dec 21, 2020        CDIST-TYPE__FILESYSTEM(7)
Impressum