# salt.modules.extfs

Module for managing ext2/3/4 file systems

salt.modules.extfs.attributes(device, args=None)

  Return attributes from dumpe2fs for a specified device

  CLI Example:

      salt '*' extfs.attributes /dev/sda1

salt.modules.extfs.blocks(device, args=None)

  Return block and inode info from dumpe2fs for a specified device

  CLI Example:

      salt '*' extfs.blocks /dev/sda1

salt.modules.extfs.dump(device, args=None)

  Return all contents of dumpe2fs for a specified device

  CLI Example:

      salt '*' extfs.dump /dev/sda1

salt.modules.extfs.mkfs(device, fs_type, full_return=False, **kwargs)

  Create a file system on the specified device

  full_returnFalse

    If `True`, the full `cmd.run_all` dictionary will be returned instead of just stdout/stderr text. Useful for setting the result of the `module.run` state.

  CLI Example:

      salt '*' extfs.mkfs /dev/sda1 fs_type=ext4 opts='acl,noexec'

  Valid options are:

  - block_size: 1024, 2048 or 4096

  - check: check for bad blocks

  - direct: use direct IO

  - ext_opts: extended file system options (comma-separated)

  - fragment_size: size of fragments

  - force: setting force to True will cause mke2fs to specify the -F option twice (it is already set once); this is truly dangerous

  - blocks_per_group: number of blocks in a block group

  - number_of_groups: ext4 option for a virtual block group

  - bytes_per_inode: set the bytes/inode ratio

  - inode_size: size of the inode

  - journal: set to True to create a journal (default on ext3/4)

  - journal_opts: options for the fs journal (comma separated)

  - blocks_file: read bad blocks from file

  - label: label to apply to the file system

  - reserved: percentage of blocks reserved for super-user

  - last_dir: last mounted directory

  - test: set to True to not actually create the file system (mke2fs -n)

  - number_of_inodes: override default number of inodes

  - creator_os: override "creator operating system" field

  - opts: mount options (comma separated)

  - revision: set the filesystem revision (default 1)

  - super: write superblock and group descriptors only

  - fs_type: set the filesystem type (REQUIRED)

  - usage_type: how the filesystem is going to be used

  - uuid: set the UUID for the file system

  - cluster_size: specify the size of cluster in bytes for file systems using the bigalloc feature

  - root_directory: copy the contents of the given directory into the root directory of the file system

  - errors_behavior: change the behavior of the kernel code when errors are detected

  See the `mke2fs(8)` manpage for a more complete description of these options.

salt.modules.extfs.tune(device, full_return=False, **kwargs)

  Set attributes for the specified device (using tune2fs)

  full_returnFalse

    If `True`, the full `cmd.run_all` dictionary will be returned instead of just stdout/stderr text. Useful for setting the result of the `module.run` state.

  CLI Example:

      salt '*' extfs.tune /dev/sda1 force=True label=wildstallyns opts='acl,noexec'

  Valid options are:

  - max: max mount count

  - count: mount count

  - error: error behavior

  - extended_opts: extended options (comma separated)

  - force: force, even if there are errors (set to True)

  - group: group name or gid that can use the reserved blocks

  - interval: interval between checks

  - journal: set to True to create a journal (default on ext3/4)

  - journal_opts: options for the fs journal (comma separated)

  - label: label to apply to the file system

  - reserved_percentage: percentage of blocks reserved for super-user

  - last_dir: last mounted directory

  - opts: mount options (comma separated)

  - feature: set or clear a feature (comma separated)

  - mmp_check: mmp check interval

  - reserved: reserved blocks count

  - quota_opts: quota options (comma separated)

  - time: time last checked

  - user: user or uid who can use the reserved blocks

  - uuid: set the UUID for the file system

  See the `mke2fs(8)` manpage for a more complete description of these options.