Provided by: jfsutils_1.1.8-1_i386 bug

NAME

       jfs_mkfs - create a JFS formatted partition

SYNOPSIS

       jfs_mkfs [options] device [ blocks ]

DESCRIPTION

       jfs_mkfs  is used to create (format) a JFS partition.  jfs_mkfs must be
       run as root.

       device is the special file name  corresponding  to  the  actual  device
       (e.g.  /dev/hdb1) on which a JFS file system and/or JFS journal will be
       created.  blocks is the number of  blocks  to  be  used  for  the  file
       system.   If  omitted,  jfs_mkfs  automatically figures the file system
       size.

       The default block size is 4096.

WARNING

       jfs_mkfs will destroy all data on the specified device!

OPTIONS

       -c     Check the device for bad blocks before building the file system.

       -j journal_device
              (Experimental) Create the external JFS journal on journal_device
              , create the JFS file system on device , and attach the external
              journal to the file system.

       -J journal-options
              (Experimental)  Create  the  JFS  journal  on  its own device or
              attach an external JFS journal to  the  JFS  file  system  using
              options  specified  on  the command-line.  The following journal
              options are supported:

                   journal_dev
                          Create an external JFS journal on the given  device.

                   device=external-journal
                          Attach  an  existing external JFS journal located on
                          external-journal to the JFS file system that will be
                          created   on  device.   The  external  journal  must
                          already have been created using the command

                          jfs_mkfs -J journal_dev external-journal

                          Attach the external journal to the file system being
                          created by using the command

                          jfs_mkfs -J device=external-journal device

                          Instead   of  specifying  a  device  name  directly,
                          external-journal can also  be  specified  by  either
                          LABEL=label  or  UUID=UUID  to  locate  the external
                          journal by either the volume label or UUID stored in
                          the  JFS external log superblock at the start of the
                          journal.   Use  jfs_tune(8)  to  display  a  journal
                          device’s  volume  label  and UUID.  (See the -l, -L,
                          and -U options of jfs_tune(8).)

              Only one of the journal_dev or device= options can be given  per
              jfs_mkfs issuance.

       -L volume_label
              Set the volume label for the newly formatted device.

              If  -L  volume_label  is  used along with -J journal_device, the
              volume label of the specified external journal  device  will  be
              set  to  volume_label.   Otherwise,  the volume label of the JFS
              file system will be set to volume_label.

       -O     Provide case-insensitive support for compatibility with OS/2.

       -q     Quiet execution - do not ask for  confirmation  before  creating
              the file system.

       -s log_size
              Set  the  log  size (in megabytes) of the inline log.  If the -s
              option is not  used,  the  default  log  size  is  0.4%  of  the
              aggregate size.

       -V     Print  version  information  and  exit  (regardless of any other
              chosen options).

EXAMPLES

       Format 3rd partition on 2nd hard disk with the volume label "JFS_hdb3":

              jfs_mkfs -L JFS_hdb3 /dev/hdb3

       Format 5th partition on 1st hard disk, verifying each block created:

              jfs_mkfs -c /dev/hda5

       Format  3rd  partition on 2nd hard disk as external journal, format 4th
       partition on 1st hard disk as JFS file system, and attach the  external
       journal to the file system:

              jfs_mkfs -j /dev/hdb3 /dev/hda4

REPORTING BUGS

       If  you  find  a  bug  in JFS or jfs_mkfs, please report it via the bug
       tracking system ("Report Bugs" section) of the JFS project web site:
       http://jfs.sourceforge.net/

       Please send as much pertinent information  as  possible  including  any
       error messages resulting from running jfs_mkfs.

SEE ALSO

       mkfs(8),   jfs_fsck(8),  jfs_fscklog(8),  jfs_tune(8),  jfs_logdump(8),
       jfs_debugfs(8)

AUTHORS

       Barry Arndt  (barndt@us.ibm.com)
       William Braswell, Jr.

       jfs_mkfs is maintained by IBM.
       See the JFS project web site for more details:
       http://jfs.sourceforge.net/

                                 March 9, 2005                     jfs_mkfs(8)