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

Docs for previous releases are available on salt.rtfd.org.

Latest Salt release: 2014.1.13

Try the shiny new release candidate of Salt, v2014.7.0rc6! More info here.

Previous topic

22.16.53. salt.modules.event

Next topic

22.16.55. salt.modules.file

SaltStack News

Upcoming SaltStack events, webinars and local meet ups and user groups.