# 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, **kwargs)

  Create a file system on the specified device

  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

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

`salt.modules.extfs.` `tune`(device, **kwargs)

  Set attributes for the specified device (using tune2fs)

  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 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.

Current Salt release: 0.17.1

#### Previous topic

salt.modules.event

#### Next topic

salt.modules.file

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd