Provided by: jfsutils_1.1.15-2.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
              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
              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)