NAME

       mkfs.nilfs2 - create a NILFS2 filesystem

SYNOPSIS

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

       mkfs.nilfs2 [ -b block-size ] [ -B blocks-per-segment ] [ -c ] [ -f ] [ -K ] [ -L  volume-label  ]  [  -m
       reserved-segments-percentage ] [ -n ] [ -O feature[,...]  ] [ -h ] [ -q ] [ -v ] [ -V ] device

DESCRIPTION

       mkfs.nilfs2  is  used to create a nilfs2 filesystem (usually in a disk partition).  device is the special
       file corresponding to the device (e.g.  /dev/sdXX). Usually  mkfs.nilfs2  is  invoked  from  the  mkfs(8)
       front-end program.

       The exit code returned by mkfs.nilfs2 is 0 on success and 1 on failure.

OPTIONS

       -b block-size
              Specify  the  size of blocks in bytes.  The valid block size is 1024, 2048, 4096, 8192 bytes, ...,
              and the maximum block size is restricted to the system page size.  For most machines, it  is  4096
              bytes.  The default block size is 4096 bytes.

       -B blocks-per-segment
              Specify  the  number  of  blocks  in a segment, where the segment (also called full segment) is an
              allocation unit of disk space of NILFS.  This parameter gives the size of segment and consequently
              determines  how  many  segments are aligned in the specified device.  The default number of blocks
              per segment is 2048 (= 8MB with 4KB blocks).

       -c     Check the device for bad blocks before building the filesystem.

       -f     Force overwrite when an existing filesystem is detected on the device.   By  default,  mkfs.nilfs2
              will not write to the device if it suspects  that  there is a filesystem on the device already.

       -h     Display help message and exit.

       -K     Keep,  do  not  attempt  to  discard blocks at mkfs time (discarding blocks initially is useful on
              solid state drives and sparse / thinly-provisioned storage).

       -L new-volume-label
              Set the volume label for the filesystem to new-volume-label.  The maximum  length  of  the  volume
              label is 80 bytes.

       -m reserved-segments-percentage
              Specify the percentage of the segments reserved for garbage collection.  The default percentage is
              5%.

       -n     Cause mkfs.nilfs2 to not actually create a filesystem, but display what it would be do if it  were
              to create a filesystem.

       -O feature[,...]
              Create  a  filesystem  with  the  given  features  (filesystem  options),  overriding  the default
              filesystem options.

              The filesystem feature set is comprised of a list of features, separated by commas, that are to be
              enabled.   To disable a feature, simply prefix the feature name with a caret ('^') character.  The
              pseudo-filesystem feature "none" will clear all filesystem features.

              block_count
                     Enable block count per checkpoint.

       -q     Quiet execution.  Useful if mkfs.nilfs2 is run in a script.

       -v     Verbose execution.

       -V     Print the version number of mkfs.nilfs2 and exit.

AUTHOR

       This version of mkfs.nilfs2 has been written by Ryusuke Konishi <konishi.ryusuke@lab.ntt.co.jp>.

AVAILABILITY

       mkfs.nilfs2 is part of the nilfs-utils package and is available from http://nilfs.sourceforge.net.

SEE ALSO

       nilfs(8), mkfs(8), badblocks(8).