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.