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 la‐
14       bel 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> : <discoverd device> created
43              Filesystem was created on <discoverd device>
44

EXAMPLES

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

AUTHORS

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

COPYING

57       Copyright  (C)  2016 Daniel Heule. Free use of this software is granted
58       under the terms of the GNU General Public  License  version  3  or  any
59       later version (GPLv3+).
60
62       ungleich GmbH 2021
63
64
65
66
677.0.0                            Jul 31, 2022        CDIST-TYPE__FILESYSTEM(7)
Impressum