sload.f2fs(8)

1SLOAD.F2FS(8)               System Manager's Manual              SLOAD.F2FS(8)
2
3
4

NAME

6       sload.f2fs - load directories and files into the device directly
7

SYNOPSIS

9       sload.f2fs  [ -f source-directory-path ] [ -t mount-point ] [ -d debug‐
10       ging-level ] [ -P ] [ -c [ -L log-of-blocks-per-cluster ] [ -a compres‐
11       sion-algorithm  ]  [ -x file-extension-to-exclude-from-compression | -i
12       file-extension-to-include-for-compression ]  [  -m  minimum-compressed-
13       blocks-per-cluster ] [ -r ] ] device
14

DESCRIPTION

16       sload.f2fs is used to load directories and files into a disk partition,
17       or an F2FS image (file).  device could a special file corresponding  to
18       the device (e.g.  /dev/sdXX), or an F2FS image file.
19
20
21       The exit code returned by sload.f2fs is 0 on success and -1 on failure.
22

OPTIONS

24       -f source-directory-path
25              Specify the source directory path to be loaded.
26
27       -t mount-point-path
28              Specify the mount point path in the partition to load.
29
30       -d debug-level
31              Specify  the  level of debugging options.  The default number is
32              0, which shows basic debugging messages.
33
34       -P     Preserve owner: user and group.   The  user  and  group  of  the
35              source files will be taken into account.
36
37       -c     Enable  a  cluster-based  file  compression.   The file would be
38              chopped into clusters, and each cluster is  compressed  indepen‐
39              dently.
40
41       -L log-of-blocks-per-cluster
42              Specify  cluster size in power of two blocks.  The minimum value
43              is 2 (4 blocks, default).  The maximum value is 8 (256  blocks).
44              Note that a block contains 4096 bytes.  This option must be used
45              with option -c.
46
47       -a compression-algorithm
48              Choose the algorithm for  compression.  Available  options  are:
49              lzo, lz4 (default).  This option must be used with option -c.
50
51       -i file-extension-to-include-for-compression
52              Specify  a  file  extension  to include for the compression.  To
53              specify multiple file  extensions,  use  multiple  option  -i's.
54              Files  having  one  of the listed extensions will be compressed.
55              This option must be used with option -c.
56
57       -x file-extension-to-exclude-from-compression
58              Specify a file extension to exclude from compression.  To  spec‐
59              ify  multiple  file extensions, use multiple option -x's.  Files
60              having one of the listed extensions won't be  compressed.   This
61              option must be used with option -c.
62
63       -m minimum-compressed-blocks-per-cluster
64              Specify  a  minimum block count saved (by compression) per clus‐
65              ter.  The minimum value is 1 (default).  Maximum  value  is  the
66              cluster  size  in  blocks  minus 1.  If compression of a cluster
67              fails to save at least the minimum compressed block count  given
68              by  the option, the cluster will not be compressed.  This option
69              must be used with option -c.
70
71       -r     Specify read-only flag for  the  compressed  files.   It  allows
72              filesystem  to  release  compressed  space  to the users, since,
73              without this option, filesystem should keep the space for future
74              file updates.  This option must be used with option -c.
75
76

NOTES

78       If neither -i nor -x is used, all files will be compressed.  Obviously,
79       option -i and -x can not be used together.
80
81

AUTHOR

83       This version  of  sload.f2fs  has  been  contributed  by  Hou  Pengyang
84       <houpengyang@huawei.com>,  Liu Shuoran <liushuoran@huawei.com>, Jaegeuk
85       Kim <jaegeuk@kernel.org>, Robin Hsu <robinhsu@google.com>
86

AVAILABILITY

88       sload.f2fs is available  from  <git://git.kernel.org/pub/scm/linux/ker‐
89       nel/git/jaegeuk/f2fs-tools.git>.
90