fsadm - Man Page
Utility to resize or check a filesystem on a device
Examples (TL;DR)
- Check a filesystem for errors:
fsadm check /dev/vg_name/lv_name - Simulate resizing to a specific size, without making any changes:
fsadm [-n|--dry-run] resize /dev/vg_name/lv_name 10G - Grow a filesystem to fill the entire device (omit the size):
fsadm resize /dev/vg_name/lv_name - Resize the filesystem and the underlying logical volume together:
fsadm [-l|--lvresize] resize /dev/vg_name/lv_name 100G - For ext2/3/4, unmount and resize offline:
fsadm [-e|--ext-offline] resize /dev/vg_name/lv_name 20G
Synopsis
| fsadm | [options] check device |
| fsadm | [options] resize device [new_size] |
Description
The fsadm utility checks or resizes the filesystem on a device (which can also be a dm-crypt encrypted device). It tries to use the same API for ext2, ext3, ext4, ReiserFS and XFS filesystems.
Options
- -e|--ext-offline
Unmount ext2/ext3/ext4 filesystem before doing resize.
- -f|--force
Bypass some sanity checks.
- -h|--help
Display the help text.
- -l|--lvresize
Also resize the given lvm2 logical volume. More volume management functionality is provided with complementary lvresize(8) and the option -r|--resizefs.
- -n|--dry-run
Print commands that would change devices without running them. Read filesystem geometry and perform available read-only checks. Do not mount or unmount filesystems. Offline checks of mounted filesystems and ReiserFS checks that may replay the journal are skipped with a warning. A successful dry run does not guarantee that a later resize will succeed.
- -v|--verbose
Be more verbose.
- -y|--yes
Answer "yes" at any prompts.
- -c|--cryptresize
Resize dm-crypt mapping together with filesystem detected on the device. The dm-crypt device must be recognizable by cryptsetup(8).
- new_size[B|K|M|G|T|P|E]
Absolute number of filesystem blocks to be in the filesystem, or an absolute size using a suffix (in powers of 1024). If new_size is not supplied, the whole device is used.
Diagnostics
On successful completion, the status code is 0. A status code of 2 indicates the operation was interrupted by the user. A status code of 3 indicates the requested check operation could not be performed because the filesystem is mounted and does not support an online fsck(8). A status code of 1 is used for other failures.
Examples
Resize the filesystem on logical volume /dev/vg/test to 1000 MiB. If /dev/vg/test contains ext2/ext3/ext4 filesystem it will be unmounted prior to the resize. All [y/n] questions will be answered 'y'.
Environment Variables
- TMPDIR
The temporary directory name for mount points. Defaults to "/tmp".
- DM_DEV_DIR
The device directory name. Defaults to "/dev" and must be an absolute path.
See Also
lvm(8), lvresize(8), lvm.conf(5),
fsck(8), tune2fs(8), resize2fs(8),
reiserfstune(8), resize_reiserfs(8),
xfs_info(8), xfs_growfs(8), xfs_check(8),