jfs_mkfs(8)						     JFS file system creation						       jfs_mkfs(8)

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  exter-
       nal 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)