1MKFS.NILFS2(8)              System Manager's Manual             MKFS.NILFS2(8)
2
3
4

NAME

6       mkfs.nilfs2 - create a NILFS2 filesystem
7

SYNOPSIS

9       mkfs  -t nilfs2 [ -b block-size ] [ -B blocks-per-segment ] [ -c ] [ -f
10       ] [ -K ] [ -L volume-label ] [ -m reserved-segments-percentage ] [ -n ]
11       [ -O feature[,...]  ] [ -h ] [ -q ] [ -v ] [ -V ] device
12
13       mkfs.nilfs2 [ -b block-size ] [ -B blocks-per-segment ] [ -c ] [ -f ] [
14       -K ] [ -L volume-label ] [ -m reserved-segments-percentage ] [ -n  ]  [
15       -O feature[,...]  ] [ -h ] [ -q ] [ -v ] [ -V ] device
16

DESCRIPTION

18       mkfs.nilfs2  is  used  to create a nilfs2 filesystem (usually in a disk
19       partition).  device is the special file  corresponding  to  the  device
20       (e.g.   /dev/sdXX).  Usually  mkfs.nilfs2  is  invoked from the mkfs(8)
21       front-end program.
22
23       The exit code returned by mkfs.nilfs2 is 0 on success and 1 on failure.
24

OPTIONS

26       -b block-size
27              Specify the size of blocks in bytes.  The valid  block  size  is
28              1024, 2048, 4096, 8192 bytes, ..., and the maximum block size is
29              restricted to the system page size.  For most  machines,  it  is
30              4096 bytes.  The default block size is 4096 bytes.
31
32       -B blocks-per-segment
33              Specify  the  number  of  blocks in a segment, where the segment
34              (also called full segment) is an allocation unit of  disk  space
35              of  NILFS.   This parameter gives the size of segment and conse‐
36              quently determines how many segments are aligned in  the  speci‐
37              fied  device.   The default number of blocks per segment is 2048
38              (= 8MB with 4KB blocks).
39
40       -c     Check the device for bad blocks before building the filesystem.
41
42       -f     Force overwrite when an existing filesystem is detected  on  the
43              device.  By default, mkfs.nilfs2 will not write to the device if
44              it suspects  that  there is a filesystem on the device already.
45
46       -h     Display help message and exit.
47
48       -K     Keep, do not attempt to discard blocks at mkfs time  (discarding
49              blocks  initially  is  useful on solid state drives and sparse /
50              thinly-provisioned storage).
51
52       -L new-volume-label
53              Set the volume label for  the  filesystem  to  new-volume-label.
54              The maximum length of the volume label is 80 bytes.
55
56       -m reserved-segments-percentage
57              Specify the percentage of the segments reserved for garbage col‐
58              lection.  The default percentage is 5%.
59
60       -n     Cause mkfs.nilfs2 to not actually create a filesystem, but  dis‐
61              play what it would be do if it were to create a filesystem.
62
63       -O feature[,...]
64              Create   a   filesystem  with  the  given  features  (filesystem
65              options), overriding the default filesystem options.
66
67              The filesystem feature set is comprised of a list  of  features,
68              separated  by commas, that are to be enabled.  To disable a fea‐
69              ture, simply prefix the feature name with a caret ('^')  charac‐
70              ter.   The  pseudo-filesystem  feature  "none"  will  clear  all
71              filesystem features.
72
73              block_count
74                     Enable block count per checkpoint.
75
76       -q     Quiet execution.  Useful if mkfs.nilfs2 is run in a script.
77
78       -v     Verbose execution.
79
80       -V     Print the version number of mkfs.nilfs2 and exit.
81

AUTHOR

83       This version of mkfs.nilfs2 has been written by Ryusuke  Konishi  <kon‐
84       ishi.ryusuke@gmail.com>.
85

AVAILABILITY

87       mkfs.nilfs2  is  part  of the nilfs-utils package and is available from
88       https://nilfs.sourceforge.io.
89

SEE ALSO

91       nilfs(8), mkfs(8), badblocks(8).
92
93
94
95nilfs-utils version 2.2            Apr 2014                     MKFS.NILFS2(8)
Impressum