1
0
mirror of git://sourceware.org/git/lvm2.git synced 2025-01-02 01:18:26 +03:00

man: fsadm

This commit is contained in:
Zdenek Kabelac 2015-10-05 12:28:00 +02:00
parent 2506275c3b
commit 4b1cadbd87
2 changed files with 66 additions and 33 deletions

View File

@ -2,72 +2,105 @@
.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 ]
.B check
.I device
.sp
.BR check
.IR device
.
.HP
.B fsadm
.RI [ options ]
.B resize
.I device
.RI [ new_size [ BKMGTEP ]]
.sp
.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
.IR ext2 ", " ext3 ", " ext4 ", " ReiserFS " and " XFS
.BR ext2 ,
.BR ext3 ,
.BR ext4 ,
.BR ReiserFS
.RB and
.BR XFS
filesystem.
.
.SH OPTIONS
.TP
.BR \-e ", " \-\-ext\-offline
.
.HP
.BR \-e | \-\-ext\-offline
.br
Unmount ext2/ext3/ext4 filesystem before doing resize.
.TP
.BR \-f ", " \-\-force
.
.HP
.BR \-f | \-\-force
.br
Bypass some sanity checks.
.TP
.BR \-h ", " \-\-help
.
.HP
.BR \-h | \-\-help
.br
Display the help text.
.TP
.BR \-n ", " \-\-dry\-run
.
.HP
.BR \-n | \-\-dry\-run
.br
Print commands without running them.
.TP
.BR \-v ", " \-\-verbose
.
.HP
.BR \-v | \-\-verbose
.br
Be more verbose.
.TP
.BR \-y ", " \-\-yes
.
.HP
.BR \-y | \-\-yes
.br
Answer "yes" at any prompts.
.TP
.I new_size
.
.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 /dev/vg/test to 1000 megabytes.
If /dev/vg/test contains ext2/ext3/ext4
.
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 "/tmp".
.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 "/dev" and must be an absolute path.
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),

View File

@ -86,10 +86,10 @@ NL='
tool_usage() {
echo "${TOOL}: Utility to resize or check the filesystem on a device"
echo
echo " ${TOOL} [options] check device"
echo " ${TOOL} [options] check <device>"
echo " - Check the filesystem on device using fsck"
echo
echo " ${TOOL} [options] resize device [new_size[BKMGTPE]]"
echo " ${TOOL} [options] resize <device> [<new_size>[BKMGTPE]]"
echo " - Change the size of the filesystem on device to new_size"
echo
echo " Options:"