| .\" Copyright (c) 2012 Samsung Electronics Co., Ltd. |
| .\" http://www.samsung.com/ |
| .\" Written by Jaegeuk Kim <jaegeuk.kim@samsung.com> |
| .\" |
| .TH MKFS.F2FS 8 "January 2013" "f2fs-tools version 1.2.0" |
| .SH NAME |
| mkfs.f2fs \- create an F2FS file system |
| .SH SYNOPSIS |
| .B mkfs.f2fs |
| [ |
| .B \-a |
| .I heap-based-allocation |
| ] |
| [ |
| .B \-l |
| .I volume-label |
| ] |
| [ |
| .B \-o |
| .I overprovision-ratio-percentage |
| ] |
| [ |
| .B \-s |
| .I log-based-#-of-segments-per-section |
| ] |
| [ |
| .B \-z |
| .I #-of-sections-per-zone |
| ] |
| [ |
| .B \-e |
| .I extenstion-list |
| ] |
| [ |
| .B \-d |
| .I debugging-level |
| ] |
| .I device |
| .SH DESCRIPTION |
| .B mkfs.f2fs |
| is used to create a f2fs file system (usually in a disk partition). |
| \fIdevice\fP is the special file corresponding to the device (e.g. |
| \fI/dev/sdXX\fP). |
| .PP |
| The exit code returned by |
| .B mkfs.f2fs |
| is 0 on success and 1 on failure. |
| .SH OPTIONS |
| .TP |
| .BI \-a " heap-based-allocation" |
| Specify 1 or 0 to enable/disable heap based block allocation policy. |
| If the value is equal to 1, each of active log areas are initially |
| assigned separately according to the whole volume size. |
| The default value is 1. |
| .TP |
| .BI \-l " volume-label" |
| Specify the volume label to the partition mounted as F2FS. |
| .TP |
| .BI \-o " overprovision-ratio-percentage" |
| Specify the percentage over the volume size for overprovision area. This area |
| is hidden to users, and utilized by F2FS cleaner. The default percentage is 5%. |
| .TP |
| .BI \-s " log-based-#-of-segments-per-section" |
| Specify the log-based number of segments per section. A section consists of |
| multiple consecutive segments, and is the unit of garbage collection. |
| The default number is 0, which means one segment is assigned to a section. |
| .TP |
| .BI \-z " #-of-sections-per-zone" |
| Specify the number of sections per zone. A zone consists of multiple sections. |
| F2FS allocates segments for active logs with separated zones as much as possible. |
| The default number is 1, which means a zone consists of one section. |
| .TP |
| .BI \-e " extension-list" |
| Specify a file extension list in order f2fs to treat them as cold files. |
| The data of files having those extensions will be stored to the cold log. |
| The default list includes most of multimedia file extensions such as jpg, gif, |
| mpeg, mkv, and so on. |
| .TP |
| .BI \-d " debug-level" |
| Specify the level of debugging options. |
| The default number is 0, which shows basic debugging messages. |
| .TP |
| .SH AUTHOR |
| This version of |
| .B mkfs.f2fs |
| has been written by Jaegeuk Kim <jaegeuk.kim@samsung.com>. |
| .SH AVAILABILITY |
| .B mkfs.f2fs |
| is available from git://git.kernel.org/pub/scm/linux/kernel/git/jaegeuk/f2fs-tools.git. |
| .SH SEE ALSO |
| .BR mkfs (8). |