Documentation

filesystem - Makes file system on block device

Synopsis

This module creates file system.

Options

parameter required default choices comments
dev
yes
    Target block device.
    force
    no no
    • yes
    • no
    If yes, allows to create new filesystem on devices that already has filesystem.
    fstype
    yes
      File System type to be created.
      opts
      no
        List of options to be passed to mkfs command.
        resizefs
        (added in 2.0)
        no no
        • yes
        • no
        If yes, if the block device and filessytem size differ, grow the filesystem into the space. Note, XFS Will only grow if mounted.

        Examples

        # Create a ext2 filesystem on /dev/sdb1.
        - filesystem: fstype=ext2 dev=/dev/sdb1
        
        # Create a ext4 filesystem on /dev/sdb1 and check disk blocks.
        - filesystem: fstype=ext4 dev=/dev/sdb1 opts="-cc"
        

        Notes

        Note

        uses mkfs command

        This is an Extras Module

        For more information on what this means please read Extras Modules

        For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.