mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/jaegeuk/f2fs-tools.git
synced 2024-11-15 05:43:39 +08:00
30825b3813
This converts the various block size based constants to be defined in terms of the block size. This makes it possible to change the block size by changing only F2FS_BLKSIZE_BITS in f2fs_fs.h Signed-off-by: Daniel Rosenberg <drosen@google.com> Signed-off-by: Jaegeuk Kim <jaegeuk@kernel.org>
138 lines
3.6 KiB
Groff
138 lines
3.6 KiB
Groff
.\" Copyright (C) 2015 Huawei Ltd.
|
|
.\"
|
|
.TH SLOAD.F2FS 8
|
|
.SH NAME
|
|
sload.f2fs \- load directories and files into the device directly
|
|
.SH SYNOPSIS
|
|
.B sload.f2fs
|
|
[
|
|
.B \-f
|
|
.I source-directory-path
|
|
]
|
|
[
|
|
.B \-t
|
|
.I mount-point
|
|
]
|
|
[
|
|
.B \-d
|
|
.I debugging-level
|
|
]
|
|
[
|
|
.B \-P
|
|
]
|
|
[
|
|
.B \-c
|
|
[
|
|
.B \-L
|
|
.I log-of-blocks-per-cluster
|
|
]
|
|
[
|
|
.B \-a
|
|
.I compression-algorithm
|
|
]
|
|
[
|
|
.B \-x
|
|
.I file-extension-to-exclude-from-compression
|
|
|
|
|
.B \-i
|
|
.I file-extension-to-include-for-compression
|
|
]
|
|
[
|
|
.B \-m
|
|
.I minimum-compressed-blocks-per-cluster
|
|
]
|
|
[
|
|
.B \-r
|
|
]
|
|
]
|
|
.I device
|
|
.SH DESCRIPTION
|
|
.B sload.f2fs
|
|
is used to load directories and files into a disk partition, or an F2FS
|
|
image (file).
|
|
\fIdevice\fP could a special file corresponding to the device (e.g.
|
|
\fI/dev/sdXX\fP), or an F2FS image file.
|
|
|
|
.PP
|
|
The exit code returned by
|
|
.B sload.f2fs
|
|
is 0 on success and -1 on failure.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI \-f " source-directory-path"
|
|
Specify the source directory path to be loaded.
|
|
.TP
|
|
.BI \-t " mount-point-path"
|
|
Specify the mount point path in the partition to load.
|
|
.TP
|
|
.BI \-d " debug-level"
|
|
Specify the level of debugging options.
|
|
The default number is 0, which shows basic debugging messages.
|
|
.TP
|
|
.BI \-P
|
|
Preserve owner: user and group.
|
|
The user and group of the source files will be taken into account.
|
|
.TP
|
|
.BI \-c
|
|
Enable a cluster-based file compression.
|
|
The file would be chopped into clusters, and each cluster is compressed
|
|
independently.
|
|
.TP
|
|
.BI \-L " log-of-blocks-per-cluster
|
|
Specify cluster size in power of two blocks.
|
|
The minimum value is 2 (4 blocks, default).
|
|
The maximum value is 8 (256 blocks).
|
|
Note that a block contains 4096 or 16384 bytes.
|
|
This option must be used with option \fB\-c\fR.
|
|
.TP
|
|
.BI \-a " compression-algorithm"
|
|
Choose the algorithm for compression. Available options are:
|
|
lzo, lz4 (default).
|
|
This option must be used with option \fB\-c\fR.
|
|
.TP
|
|
.BI \-i " file-extension-to-include-for-compression"
|
|
Specify a file extension to include for the compression.
|
|
To specify multiple file extensions, use multiple option \fB\-i\fR's.
|
|
Files having one of the listed extensions will be compressed.
|
|
This option must be used with option \fB\-c\fR.
|
|
.TP
|
|
.BI \-x " file-extension-to-exclude-from-compression"
|
|
Specify a file extension to exclude from compression.
|
|
To specify multiple file extensions, use multiple option \fB\-x\fR's.
|
|
Files having one of the listed extensions won't be compressed.
|
|
This option must be used with option \fB\-c\fR.
|
|
.TP
|
|
.BI \-m " minimum-compressed-blocks-per-cluster"
|
|
Specify a minimum block count saved (by compression) per cluster.
|
|
The minimum value is 1 (default).
|
|
Maximum value is the cluster size in blocks minus 1.
|
|
If compression of a cluster fails to save at least the minimum compressed
|
|
block count given by the option, the cluster will not be compressed.
|
|
This option must be used with option \fB\-c\fR.
|
|
.TP
|
|
.BI \-r
|
|
Specify read-only flag for the compressed files.
|
|
It allows filesystem to release compressed space to the users, since, without
|
|
this option, filesystem should keep the space for future file updates.
|
|
This option must be used with option \fB\-c\fR.
|
|
|
|
.SH NOTES
|
|
If neither \fB\-i\fR nor \fB\-x\fR is used, all files will be compressed.
|
|
Obviously, option \fB\-i\fR and \fB-x\fR can not be used together.
|
|
|
|
.SH AUTHOR
|
|
This version of
|
|
.B sload.f2fs
|
|
has been contributed by Hou Pengyang <houpengyang@huawei.com>,
|
|
Liu Shuoran <liushuoran@huawei.com>, Jaegeuk Kim <jaegeuk@kernel.org>,
|
|
Robin Hsu <robinhsu@google.com>
|
|
.SH AVAILABILITY
|
|
.B sload.f2fs
|
|
is available from <git://git.kernel.org/pub/scm/linux/kernel/git/jaegeuk/f2fs-tools.git>.
|
|
.SH SEE ALSO
|
|
.BR mkfs.f2fs(8),
|
|
.BR fsck.f2fs(8),
|
|
.BR dump.f2fs(8),
|
|
.BR defrag.f2fs(8),
|
|
.BR resize.f2fs(8).
|