lvm2/man/fsadm.8_main

.TH "FSADM" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""
.SH "NAME"
fsadm \(em utility to resize or check filesystem on a device
.SH SYNOPSIS
.
.PD 0
.ad l
.HP 5
.B fsadm
.RI [ options ]
.BR check
.IR device
.
.HP
.B fsadm
.RI [ options ]
.BR resize
.IR device
.RI [ new_size ]
.PD
.ad b
.
.SH DESCRIPTION
.
fsadm utility checks or resizes the filesystem on a device.
It tries to use the same API for
.BR ext2 ,
.BR ext3 ,
.BR ext4 ,
.BR ReiserFS
.RB and
.BR XFS
filesystem.
.
.SH OPTIONS
.
.HP
.BR -e | --ext-offline
.br
Unmount ext2/ext3/ext4 filesystem before doing resize.
.
.HP
.BR -f | --force
.br
Bypass some sanity checks.
.
.HP
.BR -h | --help
.br
Display the help text.
.
.HP
.BR -n | --dry-run
.br
Print commands without running them.
.
.HP
.BR -v | --verbose
.br
Be more verbose.
.
.HP
.BR -y | --yes
.br
Answer "yes" at any prompts.
.
.HP
.BR -c | --cryptresize
.br
Resize dm-crypt mapping together with filesystem detected on the device. The dm-crypt device must be recognizable by cryptsetup(8).
.
.HP
.BR \fInew_size [ B | K | M | G | T | P | E ]
.br
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.
.
.SH 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
.BR fsck (8).
A status code of 1 is used for other failures.
.
.SH EXAMPLES
.
Resize the filesystem on logical volume \fI/dev/vg/test\fP to 1000 megabytes.
If \fI/dev/vg/test\fP contains ext2/ext3/ext4
filesystem it will be unmounted prior the resize.
All [y/n] questions will be answered 'y'.
.sp
.B fsadm -e -y resize /dev/vg/test 1000M
.
.SH ENVIRONMENT VARIABLES
.
.TP
.B "TMPDIR   "
The temporary directory name for mount points. Defaults to "\fI/tmp\fP".
.TP
.B DM_DEV_DIR
The device directory name.
Defaults to "\fI/dev\fP" and must be an absolute path.

.SH SEE ALSO
.nh
.BR lvm (8),
.BR lvresize (8),
.BR lvm.conf (5),
.BR fsck (8),
.BR tune2fs (8),
.BR resize2fs (8),
.BR reiserfstune (8),
.BR resize_reiserfs (8),
.BR xfs_info (8),
.BR xfs_growfs (8),
.BR xfs_check (8),
.BR cryptsetup (8)
Generate man pages from templates and include version. (romster) 2008-10-08 16:50:13 +04:00			`.TH "FSADM" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""`
			`.SH "NAME"`
man: properly escape - Dash should be using '\' to be typographically correct. 2014-06-11 13:06:30 +04:00			`fsadm \(em utility to resize or check filesystem on a device`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.SH SYNOPSIS`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.PD 0`
			`.ad l`
			`.HP 5`
Fix typo fsdam -> fsadm (closes bug 552721) 2010-01-07 12:42:51 +03:00			`.B fsadm`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.RI [ options ]`
man: fsadm 2015-10-05 13:28:00 +03:00			`.BR check`
			`.IR device`
			`.`
			`.HP`
Fix typo fsdam -> fsadm (closes bug 552721) 2010-01-07 12:42:51 +03:00			`.B fsadm`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.RI [ options ]`
man: fsadm 2015-10-05 13:28:00 +03:00			`.BR resize`
			`.IR device`
			`.RI [ new_size ]`
			`.PD`
			`.ad b`
			`.`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.SH DESCRIPTION`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`fsadm utility checks or resizes the filesystem on a device.`
man: fsadm 2015-10-05 13:28:00 +03:00			`It tries to use the same API for`
			`.BR ext2 ,`
			`.BR ext3 ,`
			`.BR ext4 ,`
			`.BR ReiserFS`
			`.RB and`
			`.BR XFS`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`filesystem.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.SH OPTIONS`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.HP`
man-generator/man/help: simplify hyphen escaping Commits a29bb6a14b5e920092495fb9a1623e527d22daac ... 5c199d99f4dc9911d62673baba7643ea649ffe64 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers 2017-03-27 17:45:48 +03:00			`.BR -e \| --ext-offline`
man: fsadm 2015-10-05 13:28:00 +03:00			`.br`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`Unmount ext2/ext3/ext4 filesystem before doing resize.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.HP`
man-generator/man/help: simplify hyphen escaping Commits a29bb6a14b5e920092495fb9a1623e527d22daac ... 5c199d99f4dc9911d62673baba7643ea649ffe64 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers 2017-03-27 17:45:48 +03:00			`.BR -f \| --force`
man: fsadm 2015-10-05 13:28:00 +03:00			`.br`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`Bypass some sanity checks.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.HP`
man-generator/man/help: simplify hyphen escaping Commits a29bb6a14b5e920092495fb9a1623e527d22daac ... 5c199d99f4dc9911d62673baba7643ea649ffe64 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers 2017-03-27 17:45:48 +03:00			`.BR -h \| --help`
man: fsadm 2015-10-05 13:28:00 +03:00			`.br`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`Display the help text.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.HP`
man-generator/man/help: simplify hyphen escaping Commits a29bb6a14b5e920092495fb9a1623e527d22daac ... 5c199d99f4dc9911d62673baba7643ea649ffe64 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers 2017-03-27 17:45:48 +03:00			`.BR -n \| --dry-run`
man: fsadm 2015-10-05 13:28:00 +03:00			`.br`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`Print commands without running them.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.HP`
man-generator/man/help: simplify hyphen escaping Commits a29bb6a14b5e920092495fb9a1623e527d22daac ... 5c199d99f4dc9911d62673baba7643ea649ffe64 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers 2017-03-27 17:45:48 +03:00			`.BR -v \| --verbose`
man: fsadm 2015-10-05 13:28:00 +03:00			`.br`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`Be more verbose.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.HP`
man-generator/man/help: simplify hyphen escaping Commits a29bb6a14b5e920092495fb9a1623e527d22daac ... 5c199d99f4dc9911d62673baba7643ea649ffe64 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers 2017-03-27 17:45:48 +03:00			`.BR -y \| --yes`
man: fsadm 2015-10-05 13:28:00 +03:00			`.br`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`Answer "yes" at any prompts.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`.HP`
fsadm: add support for crypt devices 2017-10-06 17:28:35 +03:00			`.BR -c \| --cryptresize`
			`.br`
			`Resize dm-crypt mapping together with filesystem detected on the device. The dm-crypt device must be recognizable by cryptsetup(8).`
			`.`
			`.HP`
man: fsadm 2015-10-05 13:28:00 +03:00			`.BR \fInew_size [ B \| K \| M \| G \| T \| P \| E ]`
			`.br`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`Absolute number of filesystem blocks to be in the filesystem,`
add support for ext4 resize in fsadm 2009-02-04 15:47:05 +03:00			`or an absolute size using a suffix (in powers of 1024).`
			`If new_size is not supplied, the whole device is used.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.SH DIAGNOSTICS`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
Add DIAGNOSTICS section to fsadm man page. 2010-11-01 17:10:46 +03:00			`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`
man: fsadm 2015-10-05 13:28:00 +03:00			`because the filesystem is mounted and does not support an online`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.BR fsck (8).`
Add DIAGNOSTICS section to fsadm man page. 2010-11-01 17:10:46 +03:00			`A status code of 1 is used for other failures.`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.SH EXAMPLES`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
			`Resize the filesystem on logical volume \fI/dev/vg/test\fP to 1000 megabytes.`
			`If \fI/dev/vg/test\fP contains ext2/ext3/ext4`
add support for ext4 resize in fsadm 2009-02-04 15:47:05 +03:00			`filesystem it will be unmounted prior the resize.`
cleanup: use y/n instead of y\|n Use same for of yes no query everywhere. 2014-05-22 13:57:51 +04:00			`All [y/n] questions will be answered 'y'.`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.sp`
man-generator/man/help: simplify hyphen escaping Commits a29bb6a14b5e920092495fb9a1623e527d22daac ... 5c199d99f4dc9911d62673baba7643ea649ffe64 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers 2017-03-27 17:45:48 +03:00			`.B fsadm -e -y resize /dev/vg/test 1000M`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.SH ENVIRONMENT VARIABLES`
man: fsadm 2015-10-05 13:28:00 +03:00			`.`
add support for ext4 resize in fsadm 2009-02-04 15:47:05 +03:00			`.TP`
man: fsadm 2015-10-05 13:28:00 +03:00			`.B "TMPDIR "`
			`The temporary directory name for mount points. Defaults to "\fI/tmp\fP".`
Add support for DM_DEV_DIR Follow other commands support this directory setting. Useful for test suite. 2011-09-19 23:36:52 +04:00			`.TP`
			`.B DM_DEV_DIR`
			`The device directory name.`
man: fsadm 2015-10-05 13:28:00 +03:00			`Defaults to "\fI/dev\fP" and must be an absolute path.`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00
			`.SH SEE ALSO`
man: fsadm 2015-10-05 13:28:00 +03:00			`.nh`
add support for ext4 resize in fsadm 2009-02-04 15:47:05 +03:00			`.BR lvm (8),`
			`.BR lvresize (8),`
Generate man pages from templates and include version. (romster) 2008-10-08 16:50:13 +04:00			`.BR lvm.conf (5),`
Improve man page style Only reformat man pages. 2011-09-07 12:50:35 +04:00			`.BR fsck (8),`
Generate man pages from templates and include version. (romster) 2008-10-08 16:50:13 +04:00			`.BR tune2fs (8),`
			`.BR resize2fs (8),`
			`.BR reiserfstune (8),`
			`.BR resize_reiserfs (8),`
			`.BR xfs_info (8),`
			`.BR xfs_growfs (8),`
fsadm: add support for crypt devices 2017-10-06 17:28:35 +03:00			`.BR xfs_check (8),`
			`.BR cryptsetup (8)`